effect · `add_state_claim`

Definition

Supported scope:COUNTRY
Supported target:none

Description

add claim on state

实战 · 配合 · 坑

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

实战用法

add_state_claim 常用于历史事件、国策完成或决议中，让某个国家对特定省份产生领土主张，为后续宣战目标或扩张剧本铺垫。例如在一个关于领土争端的国策树中，完成某个国策后为玩家国家添加对争议地区的宣称：

focus = {
    id = claim_disputed_region
    ...
    completion_reward = {
        add_state_claim = 42   # 对 state ID 42 添加宣称
    }
}

配合关系

[create_wargoal](/wiki/effect/create_wargoal)：拥有宣称后可以更低的政治代价生成合法宣战目标，两者配合构成"先宣称、后宣战"的标准流程。
[add_state_core](/wiki/effect/add_state_core)：宣称是较弱的领土主张，核心是更强的主张；剧情升级时可在宣称之后再追加核心，形成阶段性领土诉求叙事。
[any_claim](/wiki/trigger/any_claim)：用于检测某国是否已对目标州拥有宣称，避免重复触发同一效果，常作为 limit 的前置条件。
[add_opinion_modifier](/wiki/effect/add_opinion_modifier)：添加宣称往往伴随外交摩擦，配合添加负面外交关系修正可增强事件的真实感。

常见坑

填写的是 State ID 而非省份 ID：新手容易把地图上的 province ID 直接填入，导致脚本报错或指向错误区域；务必在 map/definition.csv 或 history/states/ 中确认正确的 state 数字编号。
Scope 必须是 COUNTRY：该命令只能在国家作用域下执行，若写在 state 作用域（如 every_owned_state 的内层块）中而未切换回国家域，游戏会静默忽略或报错，需用 owner = { add_state_claim = X } 等方式回到国家 scope。

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

add_state_claim is commonly used in historical events, national focus completion, or decisions to grant a country a territorial claim on a specific state, laying the groundwork for subsequent war goals or expansion narratives. For example, in a national focus tree concerning territorial disputes, completing a certain focus grants the player's country a claim on a contested region:

focus = {
    id = claim_disputed_region
    ...
    completion_reward = {
        add_state_claim = 42   # Add claim on state ID 42
    }
}

Synergy

[create_wargoal](/wiki/effect/create_wargoal): With a claim in place, war goals can be generated at lower political cost, and together they form the standard "claim first, declare war later" workflow.
[add_state_core](/wiki/effect/add_state_core): Claims represent weaker territorial assertions, while cores are stronger ones; during narrative escalation, you can add cores after claims to create staged territorial grievance narratives.
[any_claim](/wiki/trigger/any_claim): Used to detect whether a country already possesses a claim on the target state, preventing duplicate effect triggers and commonly serves as a prerequisite condition in limit blocks.
[add_opinion_modifier](/wiki/effect/add_opinion_modifier): Adding claims typically comes with diplomatic friction; pairing them with negative diplomatic modifiers enhances the authenticity of events.

Common Pitfalls

Using State ID instead of Province ID: Beginners often mistakenly input map province IDs directly, causing script errors or referencing wrong regions; always verify the correct state numerical ID in map/definition.csv or history/states/.
Scope must be COUNTRY: This command only executes within a country scope. If written inside a state scope (such as nested blocks in every_owned_state) without switching back to country scope, the game will silently ignore it or throw an error. Use constructs like owner = { add_state_claim = X } to return to country scope.

effect · add_state_claim