命令百科

trigger · is_controlled_by

Definition

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

Description

check if state is controlled by

实战 · 配合 · 坑

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

实战用法

is_controlled_by 常用于占领与傀儡相关的决议或事件中，判断某省份/地区当前是否由特定国家实际控制（而非仅仅拥有主权），例如在抵抗运动 mod 里限定只有当占领国确实控制某州时才触发特定事件或决策。也常用于解放战争场景：当某州被友军夺回控制权后，才允许执行后续的行政重建 effect。

# 仅在该州由德国控制时，允许激活某占领决策
available = {
    is_controlled_by = GER
}

配合关系

  • [is_owned_by](/wiki/trigger/is_owned_by)：控制权与所有权往往需要同时检查，拥有主权但不控制（或反之）是占领机制的核心，两者联用能精准描述"敌占我土"状态。
  • [is_owned_and_controlled_by](/wiki/trigger/is_owned_and_controlled_by)：作为 is_owned_by + is_controlled_by 的组合快捷判断，在不需要分开区分时可替代前两者，对比使用有助于理解三者语义边界。
  • [set_state_controller_to](/wiki/effect/set_state_controller_to)：当触发 effect 需要改变控制权时，通常先用 is_controlled_by 在 limit 块中确认当前控制方，再执行该 effect 进行转移，形成"判断→操作"的标准结构。
  • [has_active_resistance](/wiki/trigger/has_active_resistance)：抵抗运动强度往往与占领国挂钩，联用可以筛选出"由特定国家控制且存在活跃抵抗"的州，用于触发镇压或事件逻辑。

常见坑

  1. 混淆控制权与所有权：新手常误用 is_controlled_by 来判断一个国家"拥有"某州，实际上和平时期两者一致，但战争中己方州可能被敌方控制，所有权不变；若逻辑需要的是主权判断，应改用 is_owned_by，否则会在非占领情形下得到意外的假值。
  2. 在 COUNTRY scope 中误用：该 trigger 仅在 STATE scope 下有效，若在国家事件的顶层 trigger 块中直接写 is_controlled_by = XXX 而未先切换到州 scope（如通过 any_neighbor_state 或 state 等），脚本将报错或静默失效，必须确保当前 scope 为具体的州。