Development

This section provides guidelines and information intended for developers, map editors, or curious players who wish to modify the game.

If you are interested in contributing to the game, this is the place to look.

The best place to discuss the development of Crossfire is the libera.chat irc or Discord channels named “crossfire”.

To work on game content including maps, quests, graphics, and the server:

1. Use Git to clone the server, map, and archetype repositories
2. Compile and install a local development server
3. Install the map editor (Gridarta)
4. (optional) Install the Crossfire Resource Editor (CRE) to edit quests, objects, and monsters in a GUI

For help with the above on Linux, see Linux Development Guide.

To work on the game clients:

• Crossfire GTK2 Client Compile Guide details how to install the GTK2 client from source.
• Crossfire Java Client Compile Guide details how to build JXClient from sources.

The following sections provide information on guidance for developing Crossfire to maintain a consistent and engaging Crossfire experience.

Information about modifying and creating new objects such as items, monsters, spells using existing code:

• Making Archetypes
• Custom Item Creation - Information and guidelines about creating custom items.
• Custom Creature Creation - Information and guidelines about creating custom creatures.
• Graphics Guide - Information to aid the creation of archetypical art.
• Item Type Guide - Information about how different types and attributes affect objects.
• Spell Numbers - The “spellnumber” works like an ID, it is needed to specify spells in various object-types. E.g. spellbooks, rods/wands/scrolls, firewalls… etc.
• Spell Shuffle - New testing and experimental archetype branch that contains spell tweaks and spell school reorganization

Guides for how to design maps in crossfire that are consistent in look and feel with existing maps:

• Map Making Guide - This is a guide on what is an acceptable map and what is unacceptable. Also, how/where to contribute maps.
• Notes on Map Making - Notes, details and suggestions on making maps.
• Yardstick - A note about the scale and size relations of maps compared to reality.
• Simple dialogs (go to section J, “NPC's Speak out”)
• Python/Quest Dialogs more information
• Lander - World Map Generator

Guides for modification and creation of new code:

• Coding Style Guide - Guidelines for coding style for the crossfire server and clients.
• Server Design
• Server Plugins
• Insult Generator

• objects
  • object_fields
• misc
• god intervention
• shared_strings
• random-maps
• random-styles
• runes
• shops
• skills
• spells
• weather
• add_body_slot

The TODO list represent ideas that have general consensus and are currently being worked on or due to be worked on soon. These are an excellent starting points for new developers who wish to contribute to the project.

• dev_todo - The TODO List
• Unified TODO list - Table format of the TODO list

These pages contain general discussion that hasn't made it on to the TODO list yet.

• Server Scratchpad: changes to the way the server currently works (improvements to movement or networking code)
  • incorporate: Old Scratchpad
• Client Scratchpad: Ideas on limitations or ideas in the way the client runs that have been discussed and are worth jotting down
• UI Proposals - Rough sketches and ideas for possible revision to the look and feel of the UI(s)
• Gameplay scratchpad: Ideas that focus on in game content that are worth jotting down as a possible future TODO
  • incorporate: Cult System Restructuring Ideas

Contributing to the Crossfire Wiki is simplest way to assist in the development of Crossfire.

• Missing/Orphaned Pages - Try to keep these pages to a minimum
• Style Guide - Guidance on maintaining consistency on pages of the Crossfire Wiki

• Attribution Policy - Policy of attribution for patches.
• Checkin Guidelines - SVN checkin procedure
• Crossfire Release Cycle
• Crossfire Release Guide - Steps need to make an official release of crossfire.
• SourceForge Migration notes, tips and help
• Get together (g2g) meeting notes, summary, proposal(s)
• Forks List of known forks of crossfire