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

实战 · 配合 · 坑

实战内容由 AI 生成,并已对照 vanilla 命令词表校验 —— 请当作起点而非权威依据。上方的定义节才是游戏自带文档原文。

实战用法

is_claimed_by 常见于领土争端、外交事件或决策的可用条件判断中，用于检测某个州是否已被指定国家宣示主权，从而触发相应的外交警告、战争借口或 AI 行为逻辑。例如，可以在一个决策的 available 块中限制"只有当本国已对目标州拥有宣称时才能执行":

# 在 state scope 下，判断某州是否被德国宣称
available = {
    132 = {  # 进入对应 state scope
        is_claimed_by = GER
    }
}

配合关系

[is_core_of](/wiki/trigger/is_core_of) — 宣称往往是核心领土主张的前置步骤，两者配合可区分"仅有宣称"与"已建立核心"两种不同的领土主张强度，实现分层逻辑。
[is_owned_by](/wiki/trigger/is_owned_by) — 与归属权判断组合，可精确筛选"被宣称但尚未占有"的州，常用于触发外交事件或解锁吞并决策。
[add_claim_by](/wiki/effect/add_claim_by) — 在 effect 块中为国家添加宣称，与本 trigger 搭配形成"添加宣称 → 后续检测宣称是否存在"的完整流程。
[remove_claim_by](/wiki/effect/remove_claim_by) — 条件满足（如割让领土后）时移除宣称，与本 trigger 共同构成宣称的生命周期管理逻辑。

常见坑

scope 混淆：is_claimed_by 必须在 STATE scope 下调用，新手常在 COUNTRY scope 中直接写而报错；正确做法是先用州 ID 或 capital_scope 等方式进入对应的 state scope，再使用该 trigger。
目标写法错误：target 填写的是国家标签（如 GER、THIS、ROOT），而非州 ID 或省份 ID；将州 ID 误填为 target 不会报语法错误，但逻辑永远不会返回真，导致条件悄无声息地失效。

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

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.
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.

trigger · is_claimed_by