Skip to content
Switch branches/tags
Go to file
Cannot retrieve contributors at this time


Build Status Coverage Status Codacy Badge Known Vulnerabilities

Open source close combat inspired game. Presentation here:

Important note: OpenCombat is in development and is developed under linux. Windows support is planned but not actually tested.


Tested only under linux, debian/Ubuntu. Before install project, install OS packages:

build-essential python3-tk libsdl1.2debian libsdl-image1.2 libsdl-image1.2-dev libsdl-ttf2.0-0 libsdl-ttf2.0-dev libsdl-mixer1.2 libsdl-mixer1.2-dev redis-server

Python version: 3.5+

Considering in your virtual environment, install synergine2:

git clone
cd synergine2
python develop
pip install -e ".[cocos2d]"

Then install additional or specific version of development environment:

pip install -r requirements.txt

You also need a running redis server (used db number is 0, soon configurable).


Troops selection

Start troops selection GUI with:

python --country USSR --country DE

Select troops for every countries then generate a troops file.

Troops Placement phase

You must: specify a map and a state and --placement option:

python maps/001 --troops troops.xml --placement

troops.xml must be previously (at Troops selection phase) generated troops file.

Map will be loaded with state file troops and you will be able to move (drag and drop with your mouse) troops.

Press s key will generate a state file in current dir.

Combat phase

You must: specify a map and a state:

python maps/001 --state maps/001/state1.xml

Map will be loaded with state file troops and you will be able to order them.

Actual keys / Give orders

When unit selected (click with mouse on soldier):

  • r: run
  • c: crouch
  • m: move
  • f: fire (not implemented)

And you can:

  • s: Save current state into OpenCombat dir (or dir specified with --state-save-dir)