Godot 4.5 Grand Strategy map prototype built as an engine module with C++ 23 using the flecs ECS.

• 2.5D map. The scene is 3D but the map it flat.

• Province map voronoi texture loading into a lookup texture that is used for map modes and province selection.

• Generated province border meshes with different shader materials depending on the type of border.

• Map labels for provinces

• Flatmap texture that allows drawing of oceans, rivers, lakes, trees, or other map objects.

• Surround map texture that applies a cloud effect to the edge of the map.

• Map editor to edit map objects and generate map data. The map editor runs as a EditorPlugin scene in the godot editor.

• Country selection with ctrl+click

• Select provinces by clicking on them. Select all provinces a country owns by right clicking on any of their owned provinces.

• Select units by clicking on them or by dragging with a selection box.

• Grand strategy map camera with camera bounds, zooming, movement, mouse panning, rotation, and edge scrolling.

• Unit path finding between province unit locators for ships and land units.

To compile you'll need to clone this repository and the godot repository and put them next to each other in a directory. Then in the godot repository switch to the 4.5 branch. There are a ton of different options to pass to scons and a lot of different ways to build, to make this easier there is a script bd.py that handles compiling the module.

Compiling as a shared library is faster for incremental builds, for this use the build script bd.py linux_debug_engine. This will compile the module as a shared library and then compile the engine and link them together. After doing this once you can use bd.py linux_debug to build only the shared library.

In order to run the project after compiling as a shared library you'll need to set the LD_LIBRARY_PATH environment variable so godot can find the shared library: export LD_LIBRARY_PATH="path/to/godot/bin/".

It is also possible to statically link everything with the bd.py linux_debug_static command. Having to link the godot binary with the module every time adds about 8-12 seconds to incremental builds so when possible build as a shared library for faster development. Clang PCH is also setup for linux builds and is used by default, run bd.py build_pch to build the pch file.

Run bd.py windows_debug. Shared library compilation and PCH are not setup for windows, the only option is to statically link everything.