Subscribe to download
Mappa Mundi

Mappa Mundi is a complete overhaul mod which turns Hearts of Iron 4 into a mapping tool. You can use it to recreate historical borders from the dissolution of the Holy Roman Empire in 1806 to the present day, or create your own alternate history maps, by using toolpack to transfer states between nations and change country names.

To help you do so, we've provided a highly detailed, historically accurate map of 1914, 1936, 1939, 2023, and a blank world as a template. Mappa Mundi also adds about 20000 states, more than twenty times the vanilla game, and over 2000 new releasable nations, to let you shape this map as you see fit.


This mod is a complete overhaul of the HOI4 map. It is incompatible with almost all other mods, and it is pointless using gameplay-altering mods alongside Mappa Mundi as it cannot be unpaused. Only graphical and music mods are likely to work alongside MM.

Toolpack is integrated into Mappa Mundi, though we use a modified version that is compatible with our ideology system. Other forks of Toolpack should be disabled when using MM, as they lack this functionality.

The State Transfer Tool mod is not incompatible with Mappa Mundi, but it is redundant, as MM already includes a state transfer tool as part of Toolpack. We also cannot guarantee that future UI updates will not break compatibility with STT, as it is not our chosen tool.

Universal Colored Puppets is not incompatible with Mappa Mundi, but it is redundant, as MM makes puppets share their overlord's colour.

This mod is NOT ironman compatible, for reasons that should be obvious. This mod is compatible with and uses 1.16.

No DLC is required to run Mappa Mundi. Having any DLC enabled will not break the mod, but it will not change gameplay in any way (Turning off TfV does disable autonomies within the DLC in Toolpack though). However, it is recommended that you turn off NSB in case you have it to prevent minor bugs.


For an easier user experience, Mappa Mundi comes prepackaged with several other mods. If you already use these mods, be sure to disable them before you launch Mappa Mundi, as having duplicate copies can cause errors.

Toolpack: https://steamhost.cn/steamcommunity_com/workshop/filedetails/?id=1417069016

Colorize Your Country: https://steamhost.cn/steamcommunity_com/sharedfiles/filedetails/?id=1776579094

Rename Factions (with keyboard!): https://steamhost.cn/steamcommunity_com/sharedfiles/filedetails/?id=1690642183

Rename States (with keyboard!): https://steamhost.cn/steamcommunity_com/sharedfiles/filedetails/?id=1689360351


Q: Why can't I unpause? Why are so many UI elements missing? Why can't I do anything?
A: Mappa Mundi is not meant for standard gameplay. It’s purely to make maps and alternate history scenarios using Toolpack, for people who don't want to have to draw them by hand. These UI elements have been removed since they aren't relevant to this mod's purpose.

Q: Will you make a playable version of Mappa Mundi?
A: To achieve the level of detail and number of states in Mappa Mundi we had to strip out Hearts of Iron 4's gameplay. If you were able to unpause, there would be no naval elements, horrible balancing, and too much lag and instability.

Q: Can I use the provinces from Mappa Mundi for my own mod?
A: Absolutely, just give us a mention in your credits.

Q: Why do countries not start in factions or as puppets anymore?
A: For some reason, when a country is in a faction or is a puppet (or both), it slows the process of transferring states. Hence why they're disabled. You can still use the puppeting tool or create new factions with Toolpack, though this can cause excessive lag.

Q: What's up with the water?
A: Water has been removed from the game and turned into a "country" with regular states instead of sea zones, meaning you can now edit coastlines, drain lakes, or flood any area simply by using toolpack.

Q: Can I use Mappa Mundi Graphics in vanilla, or with mods other than MM?
A: Technically, yes. However, the Mappa Mundi Graphics submod was designed specifically to work in conjunction with MM. MM doesn't use ocean textures, and newer versions hide terrain in zoomed out views, so it probably won't look as nice in vanilla.

Q: How do I transfer states and change ruling parties?
A: On the bottom right of the screen, above the map mode selector, is a small arrow that opens toolpack. Use it.

Q: How do I change a country's colour?
A: On the top left of the screen is a button that says "SCC." Click it to open the colour selecter, or use cosmetic tags (more information on them can be found in the Mappa Mundi Resources document linked below).

Q: Can I cause vanilla-style civil wars?
A: Toolpack's civil war function sometimes does not work in Mappa Mundi, but you can still use the "civilwar communism" command to cause a civil war in the country you are playing as, then use toolpack to change the new country's name. Be sure to save before doing this, as on rare occasions the game can crash when a civil war starts.

Q: Why can't I see the release nations button?
A: If you encounter UI issues, it is likely because you are not using 1080p. If you cannot use 1080p, reset the game's UI scaling to 1.0. This may require you to change display mode to Fullscreen.

If you have further questions, there is a help folder in the mod folder which contains more FAQs, and several useful documents for new users in linked our Discord.


Mappa Mundi Discord: https://discord.gg/D97h7tHvH6

Mappa Mundi Github build (Updated very often, highly recommended): https://github.com/N0zza/MappaMundi

Mappa Mundi Graphics Submod (to have the game look like the screenshots): https://github.com/N0zza/MappaMundiGFX


The Mappa Mundi Team: Nozza, Faaz Noushad, RicardoPetro, Gaffate, schloky, Marblistic, Esotericist, Exocamp, Jingo Spunk, Mr Confused, Der Hauptmann, birdirdirbirb, egg138, Elizabeth2683, Pionnerwada & Crepe

Special thanks to some of those who have worked with us in the past, including: snoekbaars, Limfjorden, Zooptyx, scrylveon, MaiNai, Sikyk, twotle, Volksmarine, CSP95, MihalRacovita, TrueSoviet, Holy Doggo, JoshyFlip, SamFan2, blue69982, Gindisi, Kels, Bonkey Donk, and K0rhan.

Special thanks to:

• gerrade for letting us build off of his mod, Beautiful States.
  
• the team from The New Order: Last Days of Europe for their Atlantropa heightmap and provinces.
  
• Cifotis and MrLukeNL for their work on Oceania.
  
• ChaosRobie for his work on Antarctica.
  
• Chupachu for his Country Generator Tool, which has helped us greatly.
  
• the Toolpack team for allowing us to include it directly in our mod.
  
• Kai for allowing us to include a modified Country Colour and Skin Changer Tool.
  
• Supermob1 for his extensive work on both the map and the scripted GUI.
  
• Natt and the EYWOR team for their work on Asia.
  
• Yan Xishan, Ainsley, and the Gigamap team for their resources in China.
  
• the Kaiserreich team for allowing us to use the code for their States and Victory Point Renaming System, and for allowing us to use some of their flags.
  
• Southern Victory for allowing us to use some of their portraits.