Wiki

trigger · is_claimed_by

Definition

  • Supported scope:STATE
  • Supported target:THIS, ROOT, PREV, FROM, OWNER, CONTROLLER, OCCUPIED, CAPITAL

Description

Checks if state is claimed by country

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

is_claimed_by is commonly found in territorial disputes, diplomatic events, or decision availability conditions to check whether a state has had sovereignty claimed on it by a specified nation, thereby triggering corresponding diplomatic warnings, war justifications, or AI behavior logic. For example, you can restrict a decision's available block to execute only when your country has an active claim on the target state:

# Check whether state 132 is claimed by Germany within state scope
available = {
    132 = {  # Enter the corresponding state scope
        is_claimed_by = GER
    }
}

Synergy

  • [is_core_of](/wiki/trigger/is_core_of) — Claims often serve as a prerequisite step to core territory assertions; using both together allows you to distinguish between "claim only" and "established core" as different intensities of territorial claims, implementing layered logic.
  • [is_owned_by](/wiki/trigger/is_owned_by) — Combined with ownership checks, you can precisely filter states that are "claimed but not yet occupied," commonly used to trigger diplomatic events or unlock annexation decisions.
  • [add_claim_by](/wiki/effect/add_claim_by) — Add claims for a nation within an effect block; paired with this trigger, it forms a complete workflow of "add claim → subsequently check if claim exists."
  • [remove_claim_by](/wiki/effect/remove_claim_by) — Remove claims when conditions are met (such as after ceding territory); working together with this trigger, they form the lifecycle management logic of claims.

Common Pitfalls

  1. Scope confusion: is_claimed_by must be called within a STATE scope; beginners often write it directly in COUNTRY scope and encounter errors. The correct approach is to first enter the corresponding state scope using state IDs or capital_scope and similar methods, then use this trigger.
  2. Incorrect target syntax: The target field takes a country tag (such as GER, THIS, ROOT), not a state ID or province ID. Mistakenly filling a state ID as the target will not produce a syntax error, but the condition will silently fail to ever return true, causing the logic to fail without warning.