OpenKaM

Open-source engine remake of the classic real-time strategy game Knights and Merchants: The Shattered Kingdom and its expansion The Peasants Rebellion.

OpenKaM is a fork of the KaM Remake project, originally created by Kromster80 and the KaM Remake development team. All credit for the original remake goes to them.

• Original project website: https://www.kamremake.com

Legal notice

OpenKaM is not affiliated with, endorsed by, or connected to the original Knights and Merchants game, its developers (Joymania Development), or its publishers (TopWare Interactive) in any way.

You must purchase the original game in order to run OpenKaM. It is available DRM-free on GOG:

• Knights and Merchants on GOG.com (includes both The Shattered Kingdom and The Peasants Rebellion)

OpenKaM contains no proprietary game data. Palettes, unit/house definitions and sound effects are loaded at runtime from your own original game install.

Running

Point OpenKaM at your original Knights and Merchants: The Peasants Rebellion installation:

./OpenKaM --kam-dir "/path/to/Knights and Merchants" 

Alternatively, set the OPENKAM_KAM_DIR environment variable. If neither is set, a directory picker asks for the install location at startup and the choice is saved to OpenKaM_Settings.ini ([Game] KamDir).

All writable files (settings, logs, saves, generated maps, packed sprites) live in a single per-user directory, so the game can be installed system-wide with a read-only install dir:

• Linux: $XDG_CONFIG_HOME/openkam/ (default ~/.config/openkam/)
• macOS: ~/Library/Application Support/OpenKaM/
• Windows: %APPDATA%\OpenKaM\

The sprite packs (data/Sprites/*.rxx inside the per-user directory) are generated automatically on first launch if they are missing (this takes a minute; progress is shown on the loading screen). To regenerate them manually, e.g. after changing SpritesExtra/:

./Utils/RXXPacker/RXXPacker --pack --kam-dir "/path/to/Knights and Merchants" 

Music: the original game's tracks (data/sfx/songs/track_*.sng) are streamed straight from your install through OpenAL, decoded by libmpg123 at runtime (optional; the game runs without it, just without music and voice lines).

Fonts are loaded from the original install as well. Note that the original fonts only cover Latin scripts, so non-Latin locales (e.g. Cyrillic, Chinese) currently show placeholder boxes.

License

OpenKaM is licensed under the GNU General Public License v3, the same license as the KaM Remake project it is forked from. See the LICENSE file.