Skip to content
Enno Rehling edited this page Apr 25, 2026 · 4 revisions

Sample game using Docker

Download sample.zip and unpack it, for example in /home/enno/eressea.

Look at the extracted sample directory: It has an eressea.ini file with basic information about the game, a rules.json file that sets some variables, and a custom/ folder with additional rules and translations. There are also two custom scripts, newgame.lua and export.lua, that create our world and write a CR file containing the generated data.

Notably, there is no data/ directory with a world yet. Let's create that now:

# create an alias for convenience:
alias eressea='docker run --user $(id -u):$(id -g) -e TERM -v $HOME/eressea/sample:/data -ti ghcr.io/eressea/server:latest'
# create the new game:
eressea newgame.lua
# export the world we created:
eressea export.lua

After this, there should be a data/0.dat file with the initial game state, and a reports/ directory with the reports for the initial faction(s).

Combine the order templates into an input file:

cd ~/eressea/sample
cat reports/0-*.txt > orders.0

Edit the resulting file orders.0 to your liking. To run a turn, you can use the built-in script run-turn.lua:

eressea run-turn.lua -t0

This runs the game on the 0.dat file with the orders.0 input, and produced 1.dat and new reports.

To view or edit the map after your first turn, start the GM Tool, again with a built-in script:

eressea map.lua -t0

Clone this wiki locally