effect · `remove_claim_by`

Definition

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

Description

Removes state claim by country.

实战 · 配合 · 坑

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

实战用法

remove_claim_by 常用于外交和平谈判、领土转让或战后重组等 mod 场景，当某国放弃对某州的领土主张时调用，保持地图主权关系整洁。例如在和平协议选项中，割让州省的同时移除提出方的宣称：

# 在 STATE 作用域下，移除德国对该州的宣称
state_event = {
    id = my_peace.1
    option = {
        name = my_peace.1.a
        # transfer_state_to 已将该州转让给新主
        remove_claim_by = GER
    }
}

配合关系

[is_claimed_by](/wiki/trigger/is_claimed_by)：在执行移除前先用该触发器判断目标国确实持有宣称，避免无效调用或逻辑漏洞。
[add_claim_by](/wiki/effect/add_claim_by)：与之对立的配对命令，常在"领土交换"剧本中先给受益方添加宣称再移除原宣称方的宣称。
[remove_core_of](/wiki/effect/remove_core_of)：宣称与核心通常成对处理，割让领土时往往需要同时移除该国的核心，使地图状态彻底清理干净。
[transfer_state_to](/wiki/effect/transfer_state_to)：领土实际移交时必然伴随宣称的清理，两者几乎总是出现在同一 option 块中。

常见坑

作用域写错：remove_claim_by 必须在 STATE 作用域下执行，新手容易误写在国家作用域（COUNTRY）中，导致脚本报错或静默失效；应先用 set_state_owner_to 之类的命令确认当前处于州作用域，或在事件中通过 state_scope 进入正确作用域再调用。
目标国未持有宣称就调用：若目标国根本没有对该州的宣称，游戏通常不会报错但什么也不会发生，可能掩盖脚本逻辑错误；建议在触发条件或 hidden_trigger 中先用 [is_claimed_by](/wiki/trigger/is_claimed_by) 检验，确保逻辑准确可追踪。

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

remove_claim_by is commonly used in diplomacy, peace negotiations, territorial transfers, and post-war reorganization scenarios in mods. It is invoked when a nation relinquishes its territorial claim on a state, keeping map sovereignty relationships clean and organized. For example, in a peace agreement option, remove the claimant's claim while transferring the state:

# Remove Germany's claim on the state within STATE scope
state_event = {
    id = my_peace.1
    option = {
        name = my_peace.1.a
        # transfer_state_to has already transferred the state to the new owner
        remove_claim_by = GER
    }
}

Synergy

[is_claimed_by](/wiki/trigger/is_claimed_by): Use this trigger before executing the removal to verify that the target nation actually holds the claim, avoiding ineffective calls or logical gaps.
[add_claim_by](/wiki/effect/add_claim_by): The counterpart command, commonly paired in "territorial exchange" scenarios where you first add a claim to the beneficiary, then remove the original claimant's claim.
[remove_core_of](/wiki/effect/remove_core_of): Claims and cores are typically handled in tandem; when transferring territory, you often need to remove that nation's core simultaneously to ensure the map state is completely cleaned up.
[transfer_state_to](/wiki/effect/transfer_state_to): Actual territorial transfer is invariably accompanied by claim cleanup. These two commands almost always appear in the same option block.

Common Pitfalls

Incorrect scope: remove_claim_by must be executed within STATE scope. Beginners often mistakenly write it in country scope (COUNTRY), causing script errors or silent failures. Confirm you are in state scope first using commands like set_state_owner_to, or enter the correct scope within the event via state_scope before calling it.
Calling when target nation doesn't hold a claim: If the target nation has no claim on the state at all, the game typically won't error but nothing will happen, potentially masking script logic errors. It is recommended to first verify with [is_claimed_by](/wiki/trigger/is_claimed_by) in trigger conditions or hidden_trigger to ensure logic is accurate and traceable.

effect · remove_claim_by