Previous versions offered hydraulic erosion (water-based) as a post-process. MapGen v2.2 introduces hybrid erosion, combining thermal weathering (rockfall/ scree slopes) with hydraulic transport. The result? Mountain ranges that look geologically plausible, with alluvial fans, V-shaped valleys, and realistic sediment deposits. Best of all, the new erosion pipeline runs 40% faster on multi-core CPUs thanks to a revamped job scheduler.
Beyond geography, v2.2 introduces three overlapping layers:
The development team has already hinted at features for MapGen v3.0 (expected Q2 2026):
For now, MapGen v2.2 stands as a robust, production-ready tool.
Drop a comment below if you’ve encountered the new erosion tools, or if you’ve found a way to break the new biome blending system! mapgen v2.2
MapGen v2.2 is a widely used, though aging, tool designed to help modders create custom world maps for the grand strategy game Hearts of Iron IV (HOI4)
. It streamlines the complex process of generating essential game files such as province maps, height maps, and terrain definitions. Key Features and Capabilities User Interface
: Version 2.2 introduced a more user-friendly, cut-down GUI with drag-and-drop support and built-in guides. HOI4 Export
: It allows users to export generated maps directly into a blank mod template, making them "one click away" from being playable in-game. Automated Map Generation : The tool can generate various map inputs including: Land & Terrain Input : Defines the physical shape and environment of the world. Province Maps For now, MapGen v2
: Automatically generates province divisions, which can be randomly re-colored or manually edited. Height & Normal Maps : Creates the 3D visual relief seen in the game. Known Limitations and Technical Requirements
Despite its utility, MapGen 2.2 is considered outdated and somewhat unstable for modern HOI4 versions. Steam Community Legacy Support
: It was originally optimized for HOI4 version 1.5.4; newer game updates often require manual file adjustments to resolve errors like empty weather positions or fragmented naval regions. Image Specs : For the tool to function, inputs must be 24-bit BMP files . The standard resolution for a full map is
The jump from 2.1 to 2.2 is not a minor patch. The development team has spent 14 months re-architecting core systems. Here are the four pillars of the update: The jump from 2
pip install mapgen-v2.2
Or download the prebuilt binaries for Windows/Linux/macOS from the releases page.
Quick example (Python):
from mapgen import MapGenerator
gen = MapGenerator(seed=42, width=256, height=256) heightmap = gen.generate_heightmap() biome_map = gen.generate_biomes(heightmap) gen.export("my_map.png", format="png")
The library has been optimized for performance, resulting in: