effect · remove_state_core

Hands-On Usage

remove_state_core is commonly used in scripted events, peace negotiations, or national focus completions to revoke a nation's core claim on a specific state. For example, after a separatist faction is suppressed, the rebellious side loses its core on the claimed territory. It is also suitable for historical reconciliation scenarios where a nation renounces its historical claims to disputed regions.

# After a nation signs a peace agreement, remove its core from the specified state
country_event = {
    id = my_mod.42
    option = {
        name = my_mod.42.a
        # Remove core from state 42 under GER scope
        remove_state_core = 42
    }
}

Synergy

• [add_state_core](/wiki/effect/add_state_core) — Use as a pair: when one side gains a core, the other loses it. Common in territorial transfers or self-determination events.
• [add_state_claim](/wiki/effect/add_state_claim) — After removing a core, it can be downgraded to a claim, maintaining diplomatic pressure without granting full core bonuses, creating a smoother transition.
• [any_core_state](/wiki/trigger/any_core_state) — Check in trigger conditions which cores the target nation currently holds, ensuring remove is only called when the core actually exists to avoid ineffective execution.
• [diplomatic_relation](/wiki/effect/diplomatic_relation) — After removing a core, typically adjust bilateral relations simultaneously (such as ending hostility) for more complete narrative logic.

Common Pitfalls

1. Incorrect Scope: remove_state_core must execute under a country scope, with the state ID (number or variable) as the parameter. Beginners often mistakenly place it within a state scope or confuse state IDs with country TAGs, causing script errors or silent failures.
2. No Error When Core Doesn't Exist: If the target nation has no core on that state to begin with, the command silently skips without error, easily masking logic bugs. It is recommended to check conditions first using [any_core_state](/wiki/trigger/any_core_state) or [has_country_flag](/wiki/trigger/has_country_flag) to ensure logic is traceable.