HOI3 province ID is the numeric code that Hearts of Iron 3 uses to identify every region and state on the map. Understanding this ID system helps you modify files, debug save games, and manage complex campaigns without confusion.
These identifiers link scripted events, AI decisions, and player commands to the correct provinces and nations. Learning how they work improves your workflow when editing history or configuring mods.
| Province ID | Name | Continent | Home Nation |
|---|---|---|---|
| 1 | Alberta | North America | Canada |
| 45 | Manchuria | Asia | Japan |
| 78 | Normandy | Europe | France |
| 204 | Bengal | Asia | United Kingdom |
| 356 | Ukraine | Europe | USSR |
How Province IDs Are Assigned In Game Files
The mapping of HOI3 province ID to name and location is defined in defines.txt and province_names.txt. These files are read when the game initializes the map and must be consistent for saves to load correctly.
Each province file entry includes position, terrain type, and adjacency data. Editing these files without updating dependencies can break map loading or cause runtime errors.
Using IDs With Console Commands And Modding
Many console commands in Hearts of Iron 3 require you to specify a target using its HOI3 province ID. This makes precise control possible when you are scripting tools or testing scenarios.
Modders often reference province ID in event files and localization to ensure their changes apply only to intended regions. Consistent use of numeric identifiers reduces the risk of accidental mislabeling.
Common Issues With Province Identification
Wrong province ID references can cause events to trigger in the wrong area or make the AI behave unexpectedly. Double checking the numeric value before editing or sharing files prevents wasted debugging time.
Save games store positions by ID, so swapping or deleting provinces without updating dependencies can corrupt a campaign. Always back up files and verify links when reorganizing your map.
Best Practices For Managing Province IDs
- Keep a local reference sheet linking province ID to region name and continent.
- Back up original files before editing defines.txt or province_names.txt.
- Test changes in a new campaign to confirm events and AI behave as expected.
- Share IDs consistently with mod teams to avoid duplicate or conflicting references.
- Update documentation whenever you add custom provinces or modify numbering.
FAQ
Reader questions
Why does my province ID change after editing defines.txt
Changing the order or removing entries shifts internal indices, so the numeric ID assigned to each province can change. Reloading the map or game may be required for edits to stabilize.
Can I safely use province ID in my own tools and mods
Yes, as long as you respect the same numbering scheme and do not overwrite critical engine data. Always test in a separate session before releasing modified content.
What should I do if an event targets the wrong province ID
Update the event block to reference the correct numeric ID, verify the province exists in your map definition, and ensure adjacency and continent settings match the intended region.
Will changing province ID break my existing save games
Yes, because saves store positions and state ownership by numeric ID. Renaming or reindexing provinces without adjusting the save data typically leads to loading errors or misplaced units.