Need help with Beyond-All-Reason?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

351 Stars 45 Forks Other 17.8K Commits 57 Opened issues

Services available


Need anything else?

Contributors list

No Data



Open source RTS game built on top of the Spring RTS Engine

How To Play

Development Quick Start

Beyond All Reason (BYAR), consists of 2 primary components, the lobby (Chobby - and the game code itself (this repository).

The game runs on top of the Spring engine

In order to develop the game (this repository) you first need a working install of the lobby/launcher. There are 2 ways to do this:

  1. Follow the guide in the Chobby README. First download a release of Chobby and then launch Chobby, this will automatically download and install the engine and other dependencies.

  2. Download the full BAR application from the website and run it. This is probably what you will have done if you have previously installed and played the game.

Once you have a working install of BAR you need a local development copy of the game code to work with. This code will live in the BYAR install directory.

  1. To find the BYAR install directory simply open the launcher (not full game) and click the "Open install directory" button. This is one of the 3 buttons (

    Toggle log
    Upload log
    are the other 2). For Windows installs this might be your user's
  2. In the BYAR install directory create the empty file

  3. In the BYAR install directory in the

    sub-directory (create if it doesn't exist) clone the code for this repository into a directory with a name ending in
    . For example:
git clone BAR.sdd
  1. Now you have the game code launch the full game from the launcher as normal. Then go to

    Settings > Developer > Singleplayer
    and select
    Beyond All Reason Dev
  2. Now you can launch a match normally through the game UI. This match will use the dev copy of the LUA code which is in

  3. If developing Chobby also clone the code into the

    directory. Follow the guide in the Chobby README.

More on the

directory to run raw LUA and the structure expected by Spring Engine is documented here.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.