命令百科

effect · set_state_controller_to

Definition

  • Supported scope:STATE
  • Supported target:THIS

Description

Set controller of a state to a given country
Example:\n"
USA {
	random_core_state = {
		set_state_controller_to = JAM
	}
}

实战 · 配合 · 坑

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

实战用法

set_state_controller_to 常用于解放战争、傀儡国建立或事件触发后将某省份的实际控制权交给特定国家，而不改变其主权归属。例如在和平协议脚本或内战事件中，将某地区的控制权划拨给新生政权：

# 内战结束事件：将核心州的控制权移交给叛军方
country_event = {
    id = civil_war.10
    immediate = {
        random_core_state = {
            limit = { is_controlled_by = ROOT }
            set_state_controller_to = REB
        }
    }
}

配合关系

  • [set_state_owner_to](/wiki/effect/set_state_owner_to)：控制权与所有权往往需要同步设置，单独改控制者而不改所有者会导致"占领状态"，配合使用可完整转让一块土地。
  • [transfer_state_to](/wiki/effect/transfer_state_to)：若需要同时转让所有权与控制权并触发相关外交逻辑，可用此命令替代或在之后补充，避免只改控制者留下孤立的所有权归属。
  • [is_controlled_by](/wiki/trigger/is_controlled_by)：在 limit 块中先用此触发器确认当前控制者，防止对错误国家执行控制权变更，特别在 every_neighbor_state 批量操作时尤为重要。
  • [set_occupation_law](/wiki/effect/set_occupation_law)：更换控制国后，新控制者的占领法规不会自动更新，需手动设置以避免继承旧控制国的占领政策。

常见坑

  1. 混淆"控制者"与"所有者"：本命令只改变 controller（控制方），不改变 owner（所有国）。新手常误以为执行后该州就"属于"目标国，但实际上主权仍归原属国，目标国只是占领者身份，抵抗度、合规度机制依然以原所有国为基准运作。
  2. 在非 STATE scope 下调用：此命令必须在州级 scope 内执行。若在国家 scope 下直接写 set_state_controller_to = XXX 而没有通过 random_core_state、every_state 等先进入州 scope，脚本将静默失败或报错，且游戏日志中的提示往往不够直观，难以排查。