V2.2 - Mapgen

Map generators often prioritize randomness over readability. v2.2 proves that constraints + history + adaptive detail don’t restrict creativity — they guide it toward believable, usable worlds.

For devs: upgrade for the constraint solver alone. For players: if a world feels coherent, thank the v2.2 rules — not just the noise.

MapGen v2.2 is an essential, albeit aging, toolkit used by the Hearts of Iron IV (HoI4)

modding community to generate custom world maps. It automates the creation of complex game files—like province.bmp and heightmaps—from simple user-drawn inputs. Core Workflow & Components

The tool operates on a multi-step pipeline where you provide specific 24-bit BMP images (typically at a 5632x2048 resolution) to define different geographic features. Steam Community Land & Water Input : You define the basic layout using specific hex codes: Land (#9644c0) Ocean (#051412) Lakes (#00ff00) mapgen v2.2

. Flat colors are mandatory; any fading or anti-aliasing will cause generation errors. Terrain & Biomes TerrainInput.bmp

to control where specific biomes like forests, deserts, or mountains appear across your map. Provinces & States : The tool generates a province.bmp based on your ProvinceSizeInput BoundaryInput files, helping to partition your land into playable units. Final Assets

: Once inputs are set, MapGen produces the necessary game assets, including HeightMap.bmp (terrain elevation) and WorldNormal.bmp (lighting and texture details). Steam Community Common Troubleshooting

Despite its utility, MapGen v2.2 is known for being temperamental with modern HoI4 versions and requires manual "fixing" after generation: Steam Community Guide :: How to Make a Custom World! - Steam Community Map generators often prioritize randomness over readability

Before dissecting v2.2, it’s essential to understand the legacy. MapGen is a standalone procedural map generation engine, written in optimized C++ with bindings for Python, C#, and Rust. Unlike generic noise libraries (like FastNoise or LibNoise), MapGen is a full-stack terrain synthesis suite. It doesn't just produce heightmaps; it simulates hydrological networks, biome distributions, temperature gradients, and even cultural marker placement.

Version 2.0 introduced real-time infinite world streaming. Version 2.1 added GPU-accelerated erosion. Now, MapGen v2.2 takes the leap from "useful" to "indispensable."

If you are still using MapGen v1.x, the answer is an absolute yes. You are missing out on years of optimization and the revolutionary erosion system.

If you are using MapGen v2.0, consider your workflow. Do you need vector output? Do you need multi-biome maps? If so, upgrade. The $29 (or free if you are an open-source contributor) license fee pays for itself in hours saved manually editing terrain. For devs: upgrade for the constraint solver alone

MapGen v2.2 is not just a map generator; it is a worldbuilding companion. It understands that a mountain is not just a bump in a heightmap—it is a source of rivers, a barrier to weather, and a home to resources. Whether you are building the next great indie hit or sketching a world for your weekly D&D campaign, MapGen v2.2 gives you the tools to do it faster, better, and more beautifully than ever before.

Download MapGen v2.2 today and start exploring worlds no one has ever seen.

Disclaimer: Features, benchmarks, and future roadmap details are based on current available documentation for MapGen v2.2 as of the time of writing. Always check the official changelog before upgrading critical projects.

The 2D stylized exporter now includes city ruin detection, swamp clustering, and magical ley-line overlays. Generate a print-ready continent map in 4K, complete with hex grids and POI markers, using the new --ttrpg CLI flag.

Mapgen v2.2 introduces an updated Perlin noise implementation, which provides more natural and organic terrain generation. The new Perlin noise algorithm includes: