Recoil is an open source real time strategy game engine

Visit the Official Website

Get the engine sources

git clone https://github.com/beyond-all-reason/RecoilEngine --recursive

Recoil is a fork and continuation of an RTS engine version 105.0

Visit our Discord for help, suggestions, bugs, community forum and everything Recoil related.

Installation

You can use a pre-compiled binary, usually, you want to use an installer or a package prepared for your OS:

• https://github.com/beyond-all-reason/RecoilEngine/releases

Compiling

Preparation

Start with master as the primary branch.

Verify you're seeing tags:

>>> git tag
spring_bar_{BAR105}105.0-430-g2727993
spring_bar_{BAR105}105.1.1-1005-ga7ea1cc
spring_bar_{BAR105}105.1.1-1011-g325620e
spring_bar_{BAR105}105.1.1-1032-gf4d6126
spring_bar_{BAR105}105.1.1-1039-g895d540
spring_bar_{BAR105}105.1.1-1050-g5075cc0
...

If you aren't seeing these (often, when you've cloned your fork of the repository and not the upstream version), try the following:

git remote add upstream https://github.com/beyond-all-reason/RecoilEngine
git fetch --all --tags

Make sure master is pointing to upstream master:

git checkout master
git branch -u upstream/master

Triggering a build

If you are just starting out and want to get an engine binary, we recommend using our Docker scripts documented in docker-build-v2/.

If you want to compile the engine without Docker to use a different compiler, to have a better setup with code completion in an IDE, etc., you might want to follow the building without Docker article.

License

Our Terms are documented in the LICENSE.

AI Policy usage

Please adhere to the AI usage policy, if you use such tools.