命令百科

effect · set_province_controller

Definition

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

Description

set controller for province

实战 · 配合 · 坑

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

实战用法

set_province_controller 常用于领土转移、内战事件或剧本触发器中，将某个具体省份的控制权即时交给指定国家，而无需改变主权归属。典型场景如：某国内战爆发时，叛军一方通过事件立刻夺取首都所在省份的控制权，或在和平协议脚本中将占领的前线省份归还原主。

# 某国内战事件：叛军控制首都省份
country_event = {
    id = my_mod.1
    immediate = {
        # 此处 scope 为触发内战的叛军国家 (COUNTRY)
        set_province_controller = 1234  # 填写目标省份的 province ID
    }
}

配合关系

  • [controls_province](/wiki/trigger/controls_province) — 在执行控制权转移前先校验该省份当前是否已被某国控制，避免重复触发或逻辑冲突。
  • [declare_war_on](/wiki/effect/declare_war_on) — 战争宣告后立刻通过本命令将前线关键省份控制权置于进攻方，模拟闪击或奇袭的即时效果。
  • [damage_building](/wiki/effect/damage_building) — 夺取省份控制权的同时摧毁当地建筑，模拟战斗损耗或撤退焦土策略，使两者共同还原战场现实感。
  • [add_manpower](/wiki/effect/add_manpower) — 结合控制权转移给新控制国补充兵力，常用于叛军或傀儡政权初始化脚本中。

常见坑

  1. 混淆 province ID 与 state ID：本命令接受的是**省份（province）**的数字 ID，而非状态（state）ID；新手常把 state ID 填入此处，导致命令静默失败或指向错误地块，需在 map/definition.csv 和 history/states/ 中仔细核对两套 ID 体系。
  2. scope 必须是 COUNTRY 而非 STATE：许多人习惯在 every_owned_state 等 state scope 内直接调用本命令，但它只能在 COUNTRY scope 下执行；若在 state scope 中使用，需先通过 OWNER/CONTROLLER 等目标跳回国家 scope，否则命令不会生效且不报错。