effect · add_state_claim

Hands-On Usage

add_state_claim is commonly used in historical events, national focus completion, or decisions to grant a country a territorial claim on a specific state, laying the groundwork for subsequent war goals or expansion narratives. For example, in a national focus tree concerning territorial disputes, completing a certain focus grants the player's country a claim on a contested region:

focus = {
    id = claim_disputed_region
    ...
    completion_reward = {
        add_state_claim = 42   # Add claim on state ID 42
    }
}

Synergy

• [create_wargoal](/wiki/effect/create_wargoal): With a claim in place, war goals can be generated at lower political cost, and together they form the standard "claim first, declare war later" workflow.
• [add_state_core](/wiki/effect/add_state_core): Claims represent weaker territorial assertions, while cores are stronger ones; during narrative escalation, you can add cores after claims to create staged territorial grievance narratives.
• [any_claim](/wiki/trigger/any_claim): Used to detect whether a country already possesses a claim on the target state, preventing duplicate effect triggers and commonly serves as a prerequisite condition in limit blocks.
• [add_opinion_modifier](/wiki/effect/add_opinion_modifier): Adding claims typically comes with diplomatic friction; pairing them with negative diplomatic modifiers enhances the authenticity of events.

Common Pitfalls

1. Using State ID instead of Province ID: Beginners often mistakenly input map province IDs directly, causing script errors or referencing wrong regions; always verify the correct state numerical ID in map/definition.csv or history/states/.
2. Scope must be COUNTRY: This command only executes within a country scope. If written inside a state scope (such as nested blocks in every_owned_state) without switching back to country scope, the game will silently ignore it or throw an error. Use constructs like owner = { add_state_claim = X } to return to country scope.