wkbre is an engine reimplementation of Warrior Kings (Battles) (a 3D RTS game by Black Cactus released in 2002-2003), now released under the GPL3 license. It can open the game data files, load the levels, make changes to them and render the game world.
While the ability to play games in the engine is currently in development, wkbre can still be used as a level editor. You can open savegames in it, make some changes like creating, moving or deleting characters, buildings, ..., then save the changes and load the new savegame in the original game engine. It also has a terrain editor and you can make new custom skirmish maps that you can play in the original game alone or with friends!
You need a copy of the game if you want to use wkbre. The game is still available on Steam (WK / WKB) and GOG (WK / WKB).
Currently, wkbre only works on Windows (XP, Vista, 7, 8, 8.1, 10, and later). But a port to other OSs is planned.
You can watch some videos of wkbre in action on my YouTube channel.
I have only tested the source code on Visual C++ 2010/2017 and MinGW.
You can use CMake to generate a Makefile or a project file (for example a Visual Studio solution). In Visual Studio 2017 you can even open the CMakeLists.txt file as a project file and directly build from there.
Or, you can also build the program with the included batch files:
- Open a Windows SDK/Visual Studio/MinGW-32 command prompt.
- cd to wkbre's source code directory.
- cd to bzip2
- Type (before pressing ENTER)
build_vc_dif you use Microsoft Visual C++ compilerbuild_mg_dif you use MinGW
- cd ..
- Type (before pressing ENTER)
vc_compallif you use Microsoft Visual C++ compilermg_compallif you use MinGW
For more information see docs/codedoc.txt.
To run wkbre, you must first open settings.txt and change the GAME_DIR value to the path of WK's game data (the directory with data.bcp and saved directory). Alternatively, you can comment the GAME_DIR variable out and copy the wkbre exe as well as the redata directory in the game's directory.
If you start a development version of wkbre, you will be asked to enter a test number. Simply press ENTER to run the default main code.
For more information see docs/help.htm.
- LZRW3 compression/decompression library (public domain)
- bzip2 compression/decompression library (bzip2 license)
- Dear ImGui GUI library (MIT license)
These libraries are already included in wkbre's source repository, so you don't have to download them separately.
Their licenses files can be found in their respective directories.
I hope you find wkbre and its source code interesting and useful. Comments/suggestions/bug reports are really appreciated.
I also made a "WK Modding kit" with some programs for viewing and editing game files. You can download it here.