effect · add_state_core

Hands-On Usage

add_state_core is commonly used in national focuses, decisions, or events to establish core ownership of a specific state for a country, granting that country casualty penalties exemption and casus belli on the state. Typical scenarios include national unification focuses (such as having Germany establish cores on Austria), post-war territorial reorganization, or gradual expansion of historical claims through decisions.

# When a national focus completes, establish a core for the current country on state 4 (Vienna region)
focus = {
    id = GER_anschluss_cores
    ...
    completion_reward = {
        add_state_core = 4
        add_state_claim = 4  # Can first add a claim as a transitional step
    }
}

Synergy

• [add_state_claim](/wiki/effect/add_state_claim) — Typically grant a claim first before adding a core, forming a progressive "claim → core" diplomatic narrative that feels more natural.
• [every_core_state](/wiki/effect/every_core_state) — Can iterate through current core states for batch operations, working with add_state_core to build dynamic core expansion chains.
• [create_wargoal](/wiki/effect/create_wargoal) — After establishing a core, immediately generate a casus belli for annexing that state, forming a complete expansion workflow.
• [any_core_state](/wiki/trigger/any_core_state) — Commonly used as a prerequisite trigger to avoid redundant additions or logic when a state is already a core.

Common Pitfalls

1. Scope Confusion: The scope of add_state_core must be COUNTRY. Beginners often mistakenly place it inside state scopes like every_owned_state, causing script errors or silent failures. The correct approach is to directly specify the state ID (integer) within country scope, not yes.
2. Cores Do Not Equal Control: Adding a core only changes the "core ownership" label and does not automatically transfer state control or ownership. Beginners often mistakenly assume the state will automatically belong to their country after execution. In reality, additional commands like transfer_state are needed to actually claim the territory.