The tool is notorious for being unstable and "finicky". High river density or incorrect file resolutions (must be exactly 5632x2048 for full maps) frequently lead to crashes.
The library now features a modular design, making it easier to integrate and extend. Developers can:
Includes a feature to package generated files directly into a blank mod template for immediate testing in-game.
The software acts as a bridge between graphic design and game scripting. Users provide simple visual inputs, and MapGen v2.2 generates the necessary "under-the-hood" files: mapgen v2.2
is a popular automated map-generation software designed specifically for the Hearts of Iron IV (HoI4) modding community. Created to streamline the complex task of building total-conversion overhaul mods, it allows developers to transform simple 2D color drawings into fully realized in-game worlds. Instead of manually plotting thousands of coordinates and province IDs, MapGen v2.2 handles the heavy lifting of generating provinces, states, height maps, and terrain files automatically. 🚀 Key Features of MapGen v2.2
Acquire the MapGen v2.2 executable. It is often found within HoI4 modding community guides.
Developers can use the node editor to quickly test different world shapes (archipelagos, continent-dense, mountainous) without rebuilding the terrain system. 4. Performance and Optimization The tool is notorious for being unstable and "finicky"
Translates color-coded images into landmasses, sea, and specific biomes.
: Assignment of terrain (plains, mountains, forests) based on specific RGB values.
Ensure your map dimensions are multiples of 64 (e.g., 5632 x 2048) to prevent "Height map height is not a multiple of 64" errors. Developers can: Includes a feature to package generated
Next, configure how land areas will behave in-game. You draw maps that define terrain types (e.g., mountains, plains, deserts) and select general sizing guidelines for provinces (smaller provinces for high-conflict areas, larger provinces for vast spaces like deserts or tundras). 3. Boundary & River Mapping
You can now layer generators non-destructively. For example:
Biomes are now calculated using a complex interaction of height, temperature, and humidity, allowing for gradual transitions (e.g., desert transitioning into savannah, then to plains).
As of early 2026, MapGen v2.2 is considered a legacy tool. While still widely used for its simplicity, it has not received significant official updates in several years, leading to compatibility issues with the latest HOI4 DLCs and map formats.
: The tool requires exact RGB matches. A single pixel of the "wrong" blue might cause a crash or an "unknown province" error.