effect · `transfer_state_to`

Definition

Supported scope:STATE
Supported target:THIS

Description

Set owner and controller of a state to a given country
Example:\n"
USA {
	every_core_state = {
		transfer_state_to = JAM
	}
}

实战 · 配合 · 坑

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

实战用法

transfer_state_to 最常见于领土重组事件或焦点树完成时，将某地区的所有权与控制权同时移交给目标国，例如制作独立运动、傀儡解放或战后和平谈判 mod 时批量转让核心省份。下面示例演示在一个焦点完成效果中，将波兰的所有核心州转交给新生的波兰政权：

POL = {
    every_core_state = {
        limit = {
            is_owned_by = GER
        }
        transfer_state_to = POL
    }
}

配合关系

[add_core_of](/wiki/effect/add_core_of) — 转让领土后立即为接收方添加核心，避免出现"拥有但无核心"导致惩罚的情况。
[set_state_controller_to](/wiki/effect/set_state_controller_to) — 当只需改变控制权而不改变所有权时单独使用；与 transfer_state_to 对比使用可精细区分占领与归属场景。
[is_owned_by](/wiki/trigger/is_owned_by) — 在 limit 块中过滤当前所有者，确保只对特定国家持有的州触发转让，避免误操作中立或友方领土。
[remove_core_of](/wiki/effect/remove_core_of) — 转让后移除前任所有者的核心，配合使用可完整模拟领土彻底易主而非单纯换手。

常见坑

误以为只需在 COUNTRY scope 调用：该 effect 必须在 STATE scope 内执行，直接写在国家 scope 下会报错或静默失效；需要先进入具体州（如通过 every_core_state、specific_state = X 等）再调用。
忽略抵抗与占领法的残留：transfer_state_to 会同时设置所有者与控制者，但不会自动清除前任占领法或抵抗数值，若不配合 [set_occupation_law](/wiki/effect/set_occupation_law) 或 [set_resistance](/wiki/effect/set_resistance) 处理，接收方可能继承异常的占领状态。

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

transfer_state_to is most commonly used in territorial reorganization events or upon focus tree completion, transferring both ownership and control of a region to a target nation. It's frequently employed when creating independence movements, puppet liberation, or post-war peace settlement mods to bulk transfer core provinces. The example below demonstrates transferring all of Poland's core states to the newly formed Polish regime upon focus completion:

POL = {
    every_core_state = {
        limit = {
            is_owned_by = GER
        }
        transfer_state_to = POL
    }
}

Synergy

[add_core_of](/wiki/effect/add_core_of) — Immediately add cores to the receiving nation after territorial transfer, preventing penalties from the "owned but without core" condition.
[set_state_controller_to](/wiki/effect/set_state_controller_to) — Use independently when only changing control without changing ownership; compare with transfer_state_to for fine-grained distinction between occupation and territorial assignment scenarios.
[is_owned_by](/wiki/trigger/is_owned_by) — Filter the current owner within a limit block to ensure transfer only triggers for states held by specific nations, preventing accidental operations on neutral or friendly territories.
[remove_core_of](/wiki/effect/remove_core_of) — Remove cores of the previous owner after transfer; using together can fully simulate complete territorial change of hands rather than mere handover.

Common Pitfalls

Mistakenly assuming it only requires COUNTRY scope invocation: This effect must be executed within a STATE scope. Calling it directly under a country scope will cause errors or silent failure; you must first enter a specific state (e.g., via every_core_state, specific_state = X, etc.) before invoking it.
Overlooking residual resistance and occupation law: transfer_state_to sets both owner and controller simultaneously, but does not automatically clear the previous occupation law or resistance values. Without pairing it with [set_occupation_law](/wiki/effect/set_occupation_law) or [set_resistance](/wiki/effect/set_resistance), the receiving nation may inherit abnormal occupation states.

effect · transfer_state_to