Before you start

Before any development, feature request or bug report, you should get and use the development version of Bos Wars. The next section explains how to get the development version.

Before starting a new development, contact us to check if it fits in the game and if nobody else is working on it.

Development version

The game is continuously evolving. The project git repositories and management is on Codeberg. You can get the latest version with git:

  git clone

Before playing you'll have to compile the engine. This can be done easily with the tool. To build a debug version (recommended for development) run:

  ./ debug

Finally, you can run the game with :


See the Bos Wars FAQ and the documentation next to the sources for more information.

Some sources for the assets used in the game can be found in the materials.bos repository.

The sources of the web pages can be found in the website.bos repository.

Old development done before december 17th 2004 can be found in the CVS repository.

Report bugs and patchs

The BosWars team appreciates all feedback. You can help by many ways: translations, documentations, graphics, musics, bug reports, etc. Not only code.

Please report bugs in the Issue Tracker.

Pull requests (of all kinds: code, documentations, translations, graphics, musics) are welcome in the Pull Requests list. Alternatively, you can create patches and send them to the Patch Tracker. In that case, it's best to ping the dev team on chat.


Discussion and work on the game happens mostly in the Bos Wars Matrix rooms. Alternatively, one can chat on the #boswars IRC channel Logs of the IRC channel are available at as well as logs of the old #bos channel.

You can also reach us via the bos-dev mailing list. Posting on the mailing list is only allowed for people who subscribed to the list.

Designs and some documentation are written in the Bos Wiki. Don't hesitate to add your comments and ideas.