Province IDs in Europa Universalis IV are the unique, internal identifiers that the game engine uses to track every province on the map. Each province has a fixed numeric ID that scripts, events, and map files reference when defining ownership, trade power, core claims, or borders. Understanding how province IDs work helps players interpret tooltips, debug save files, and read documentation for mods and megamaps with greater precision.
How Province IDs Appear in the Game
In-game, province IDs are visible mainly through map mode tools, script debugging, or event text. They are not typically displayed on the standard province panel, but they can be seen when using map modes that show province numbers or when opening the script debugger. IDs are stable across a playthrough and do not change based on owner or control, which makes them reliable references for long-term bookmarks and mod content.
How Province IDs Are Used in Scripts and Events
Province IDs are fundamental to writing and reading EU4 scripts and events. They appear in condition blocks, triggers, and effects to specify which province a modifier or event targets. For modders and scripters, using the correct province ID ensures that localizations, triggers, and map changes behave consistently across different saves and versions. Because province IDs never reset, they are preferred over relying on province names or temporary tags when crafting complex behaviors.
Common Script Functions That Reference Province IDs
- owner = — sets or checks current owner of a province by ID.
- controller = — returns the controlling nation for a province by ID.
- has_core — checks core ownership for a given province ID.
- trade goods — links province IDs to their trade production.
Reading Province IDs on the Map
Players can view province IDs by opening the map mode options and enabling province numbers, which overlays each province with its numeric ID. This is useful for verifying IDs when editing saves, writing custom triggers, or communicating with modding tools. Because the same ID can appear in different regions across the map, always cross-reference the province number with its location to avoid confusion.
Province IDs vs. Other Identifiers
Province IDs should not be confused with tags or names used by nations or traders. Tags are three-letter country codes, while province names are human-readable labels; both can vary or be reused, whereas province IDs are static numeric references managed by the engine. When precision is required, such as in event writing or tool debugging, province IDs are the authoritative identifier.
Identifier Type
Compared to dynamic tags that change as nations form and reform, province IDs remain constant. Names can overlap due to localization or user mods, but IDs are unique within a single save and across the official map definition. This makes them ideal for technical documentation, reproducible bug reports, and persistent script commands.
Table: Province ID Reference Details
| Attribute | Verified Detail | Source Type |
|---|---|---|
| Format | Integer number (e.g., 42) | Game Engine |
| Stability | Fixed for the lifetime of the save | Internal Behavior |
| Scope | Unique per province within a save | Map Definition |
| Visibility | Shown in map mode and script debugger | User Interface |
| Reuse Risk | Not reused for new provinces in the same session | Design Specification |
Common Province ID Operations
When working with province IDs in practice, players often need to locate a specific province, confirm ownership in scripts, or verify core claims. Using map mode to display province numbers is the fastest way to identify an ID visually. For scripting, copying the ID from a reliable source such as the official map definition or a vetted mod reduces errors. Always test script changes in a safe save to confirm that the intended province is being targeted.
Practical Checklist for Using Province IDs
- Enable province numbers in map mode to locate IDs visually.
- Copy IDs from official maps or trusted mod files.
- Use IDs in scripts for stable, persistent references.
- Cross-check IDs with in-game tooltips to confirm region.
- Document IDs alongside notes about region and purpose.
Limitations and Version Considerations
While province IDs themselves are stable, the official map layout can change between major Europa Universalis IV releases and expansions. A province ID that refers to a particular region in one version may refer to a different area in another if the map is reshaped or new provinces are added. When sharing scripts or megamaps, specify the intended game version to reduce mismatches caused by map updates.
Closing Notes on Province IDs
Province IDs are the fixed numeric backbone of EU4’s map engine, providing a reliable way to reference provinces in scripts, events, and debugging workflows. They are not decorative labels but essential tools for precise modding and technical work. By learning how to read and use province IDs correctly, players and modders can reduce errors, communicate more clearly, and build content that remains robust across many play sessions.