Wiki

trigger · is_fully_controlled_by

Definition

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

Description

Checks if state is fully controlled by specified tag

实战 · 配合 · 坑

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

实战用法

is_fully_controlled_by 常用于占领/解放事件或决策中,检验某个州是否已被某国完整控制(即所有省份均在同一国控制下),避免在战线混乱时错误触发奖励或剧本推进。例如在抵抗运动 mod 中,只有当一个州被彻底控制后才允许推行特定占领政策:

# 在决策的 available 块中检查州是否已被完全控制
available = {
    275 = {  # 以法兰西德岛州为例
        is_fully_controlled_by = GER
    }
}

配合关系

  • [is_controlled_by](/wiki/trigger/is_controlled_by)is_controlled_by 只检查州的控制国标签,而 is_fully_controlled_by 要求每一个省份都受同一国控制,两者常放在同一条件块中形成由宽到严的双重验证。
  • [has_active_resistance](/wiki/trigger/has_active_resistance):占领下若存在活跃抵抗运动,通常意味着未完全控制,与 is_fully_controlled_by 配合可实现"完全控制且无抵抗"的复合条件。
  • [set_occupation_law](/wiki/effect/set_occupation_law):在 is_fully_controlled_by 确认完全控制后,才执行占领政策的设置,防止在省份归属混乱时产生脚本报错或逻辑矛盾。
  • [compliance](/wiki/trigger/compliance):顺从度达标往往与完全控制同步推进,两者一起用于判断是否解锁更高级别的占领政策或决策选项。

常见坑

  1. 误将其当作主权检查使用:该 trigger 检查的是"控制权"而非"所有权",若想同时验证所有权,需要额外搭配 [is_owned_by](/wiki/trigger/is_owned_by) 或直接使用 [is_owned_and_controlled_by](/wiki/trigger/is_owned_and_controlled_by),否则敌国占领后控制整个州也会返回真。
  2. Scope 未切换到 STATE:新手在 COUNTRY scope 下直接写 is_fully_controlled_by = GER 会报错,必须先通过州 ID 或 capital_scope 等方式进入 STATE scope,再调用该 trigger。

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

is_fully_controlled_by is commonly used in occupation/liberation events or decisions to verify whether a state has been fully controlled by a specific nation (i.e., all provinces are under the same nation's control), preventing incorrect reward triggers or narrative progression during chaotic frontlines. For example, in resistance movement mods, specific occupation policies are only allowed after a state is completely taken over:

# Check whether a state is fully controlled in the available block of a decision
available = {
    275 = {  # Taking Île-de-France as an example
        is_fully_controlled_by = GER
    }
}

Synergy

  • [is_controlled_by](/wiki/trigger/is_controlled_by): is_controlled_by only checks the state's controlling nation tag, whereas is_fully_controlled_by requires every single province to be under the same nation's control. The two are often placed in the same condition block to form a tiered verification from loose to strict.
  • [has_active_resistance](/wiki/trigger/has_active_resistance): Active resistance under occupation typically indicates incomplete control. Combined with is_fully_controlled_by, it achieves the composite condition of "fully controlled and no resistance."
  • [set_occupation_law](/wiki/effect/set_occupation_law): Only after is_fully_controlled_by confirms complete control should occupation policy be set, preventing script errors or logical contradictions when province ownership is in flux.
  • [compliance](/wiki/trigger/compliance): Compliance threshold often progresses in tandem with complete control. Used together, they determine whether to unlock higher-tier occupation policies or decision options.

Common Pitfalls

  1. Mistaking it as a sovereignty check: This trigger checks "control" rather than "ownership." To verify ownership simultaneously, you must pair it with [is_owned_by](/wiki/trigger/is_owned_by) or use [is_owned_and_controlled_by](/wiki/trigger/is_owned_and_controlled_by) directly. Otherwise, even after enemy occupation of the entire state, it will return true.
  2. Scope not switched to STATE: Beginners writing is_fully_controlled_by = GER directly under COUNTRY scope will cause an error. You must first enter STATE scope via state ID or capital_scope, then invoke this trigger.