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 https://codeberg.org/boswars/boswars.git

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

  ./make.py debug

Finally, you can run the game with :

  ./fbuild/debug/boswars

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.

Contact

Discussion and work on the game happens mostly in the Bos Wars Matrix rooms. Alternatively, one can chat on the #boswars IRC channel irc.libera.chat. Logs of the IRC channel are available at https://colabti.org/irclogger/irclogger_logs/boswars 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.