Wiki

trigger · owns_any_state_of

Definition

  • Supported scope:COUNTRY
  • Supported target:none

Description

Check if the country owns any of the states in the list.

Hands-On Notes

Hands-on notes are AI-generated and checked against the vanilla command vocabulary — treat them as a starting point, not authoritative reference. The definition above is the game's own documentation.

Hands-On Usage

owns_any_state_of is commonly used to check whether a country controls at least one state in a given region. Typical scenarios include: determining whether the player has occupied sufficient territory to unlock subsequent decisions, national focuses, or events. For example, in a "Middle East Unification" themed mod, it can be used to check whether any state in the target list is held to trigger the next phase of a mission.

# available block of a certain decision: can be activated as long as any state from the target list is owned
available = {
    owns_any_state_of = {
        619   # Cairo
        454   # Baghdad
        679   # Damascus
    }
}

Synergy

  • [any_owned_state](/wiki/trigger/any_owned_state) — When finer-grained conditions need to be attached to owned states (such as building count or population of a certain state), it can be combined with owns_any_state_of, where the latter quickly filters the scope and the former further validates attributes.
  • [controls_state](/wiki/trigger/controls_state) — owns_any_state_of only checks ownership; when territory is actually occupied by enemy forces, ownership and control become separated. Pairing with this trigger ensures both ownership and control status are confirmed simultaneously.
  • [add_state_core](/wiki/effect/add_state_core) — Commonly used within the effect block when owns_any_state_of is true, adding cores to already-owned states to form a complete logical chain of "occupation → coreification."
  • [has_completed_focus](/wiki/trigger/has_completed_focus) — Often serves as a parallel condition: complete a specific national focus first, then own the target states; both must be satisfied simultaneously to unlock subsequent content, preventing players from bypassing story triggers.

Common Pitfalls

  1. Confusing state IDs with province IDs: owns_any_state_of accepts state numbers, not province numbers on the map. The two can differ by hundreds in the same region. Directly copying province IDs from map files will cause the condition to never be satisfied.
  2. Mistaking "ownership" for "control": This trigger judges ownership in the diplomatic/gameplay sense (owner). States occupied by enemy forces still count as your own. If the logic requires "actual control," you must additionally use controls_state for supplementary checks, otherwise unintended rewards or events may trigger unexpectedly during warfare.