effect · remove_state_claim

Hands-On Usage

remove_state_claim is commonly used in diplomatic events or after peace negotiations to have a nation renounce its territorial claim on a specific state—for example, signing boundary agreements or withdrawing expansionist ambitions after completing a focus. It is also useful for cleaning up residual territorial claims when a civil war ends or puppet relationships are dissolved, keeping the map's political state tidy.

# A nation renounces its claim on a state in a peace treaty event
country_event = {
    id = my_mod.10
    option = {
        name = my_mod.10.a
        # Current scope is the nation signing the agreement
        remove_state_claim = 42   # Remove claim on state 42
    }
}

Synergy

• [add_state_claim](/wiki/effect/add_state_claim) — Use together as a pair: first apply add_state_claim to grant a claim when the script triggers, then later use remove_state_claim when specific conditions are met, forming a complete lifecycle for territorial claim management.
• [add_state_core](/wiki/effect/add_state_core) — In some scenarios, a claim escalates to a core; verify beforehand whether you need to remove the core simultaneously, to avoid leaving the core behind after removing the claim, which creates a logical contradiction.
• [any_claim](/wiki/trigger/any_claim) — Before executing removal, use this trigger to verify that the nation actually holds the claim on that state, preventing silent failures or log warnings from attempting to remove a non-existent claim.
• [diplomatic_relation](/wiki/effect/diplomatic_relation) — Territorial claims often tie into bilateral relations; pair remove_state_claim with diplomatic_relation to improve relations between both nations, making diplomatic events more coherent and complete.

Common Pitfalls

1. Entering the wrong state ID or using a province ID instead — The parameter for remove_state_claim is the state number, not the province number; these have completely different values in-game, and using the wrong one causes silent failure with no obvious error message. Double-check the target ID carefully in map/definition.csv and history/states/.
2. Attempting to remove a claim without first checking if it exists — Executing this command on a state that has no claim will not crash the game, but if your logic depends on "the claim being successfully removed" to trigger subsequent checks, the result will deviate from expectations. It is recommended to add a protective check using [any_claim](/wiki/trigger/any_claim) or appropriate conditions before execution.