effect · transfer_state

实战用法

transfer_state 最常用于和平谈判、事件触发领土变更、以及焦点树中的领土奖励场景——例如在一个国家完成某个国策后将特定州份转交给盟友或自身。值得注意的是，该 effect 会同时更新 owner 和 controller，无需额外手动设置控制权。

# 在焦点树完成后，将 STATE_42 转交给当前作用域国家
focus = {
    id = claim_rhineland
    ...
    completion_reward = {
        42 = { transfer_state = ROOT }
    }
}

配合关系

• [add_state_core](/wiki/effect/add_state_core)：转移州份后通常需要为接收国添加核心，避免出现高惩罚的占领状态，两者常成对出现。
• [add_state_claim](/wiki/effect/add_state_claim)：在转移前先给目标国添加宣称，使领土变更在叙事上更合理，也可满足某些触发条件。
• [controls_state](/wiki/trigger/controls_state)：转移前用于检测当前是否实际控制该州，防止将自己并未控制的州意外转交。
• [create_wargoal](/wiki/effect/create_wargoal)：在剧本设计中，常先通过战争目标达成条件，再用 transfer_state 落实战后领土结果。

常见坑

1. Scope 用反：transfer_state 的 scope 是接收国（COUNTRY），而不是州本身——初学者容易误以为应该写在州 scope 下，实际正确写法是 <state_id> = { transfer_state = RECEIVER_TAG } 或在接收国 scope 下写 transfer_state = <state_id>，搞混方向会导致脚本静默失效或转交给错误国家。
2. 忽略核心与合规度：转移州份后原主国的核心不会自动移除，接收国也不会自动获得核心，若不配合 add_state_core / 移除旧核心等操作，游戏内会出现占领惩罚或 AI 立即反目的非预期行为。