Wiki

effect · force_operative_leader_into_hiding

Definition

  • Supported scope:CHARACTER
  • Supported target:none

Description

Force an operative into hiding, preventing him from performing mission. The specified values is subject to modifiers
force_operative_leader_into_hiding = 12

实战 · 配合 · 坑

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

实战用法

当你希望在剧情事件或国策效果中让某个特工被迫转入潜伏状态(例如被敌方情报机构察觉后临时停止任务),可以在 CHARACTER scope 下调用此 effect。数值越大,特工保持潜伏的时间越长(会受到相关修正器影响)。常见场景包括情报战事件链中"暴露特工"的惩罚分支,或敌对国策触发的反情报效果。

# 示例:某事件让目标特工被迫潜伏
country_event = {
    id = my_intel.5
    ...
    option = {
        name = my_intel.5.a
        # 切换到当前特工角色 scope
        FROM = {
            force_operative_leader_into_hiding = 12
        }
    }
}

配合关系

  • [is_operative](/wiki/trigger/is_operative):在执行前用于校验当前 scope 确实是一名特工,避免对非特工角色错误调用导致脚本报错。
  • [operative_leader_mission](/wiki/trigger/operative_leader_mission):用于判断特工当前正在执行的任务类型,从而决定是否触发潜伏效果,使逻辑更精准。
  • [harm_operative_leader](/wiki/effect/harm_operative_leader):常与潜伏效果搭配,在特工暴露的事件中同时对其造成伤害,模拟真实的暴露代价。
  • [capture_operative](/wiki/effect/capture_operative):作为潜伏的"替代分支"——情节走向可以是潜伏或被俘,两者常出现在同一事件的不同 option 中。

常见坑

  1. Scope 错误:此 effect 必须在 CHARACTER scope 内执行,若直接写在国家 scope(如 GER = { force_operative_leader_into_hiding = 12 })而不先切入角色 scope,游戏会静默忽略或报错,新手往往因此误以为效果无效。
  2. 将数值理解为固定天数:新手常以为填入的数字就是精确的潜伏天数,实际上该数值会受到游戏内情报相关修正器的影响,最终持续时间与原始数值可能存在明显差异,调试时不能简单对等换算。

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

When you want to force a specific operative into hiding status in an event or national focus effect (for example, after being detected by enemy intelligence agencies and temporarily halting their mission), you can invoke this effect under the CHARACTER scope. The larger the value, the longer the operative remains in hiding (subject to relevant modifiers). Common scenarios include the penalty branch of "expose operative" in intelligence warfare event chains, or counter-intelligence effects triggered by hostile national focuses.

# Example: An event forces the target operative into hiding
country_event = {
    id = my_intel.5
    ...
    option = {
        name = my_intel.5.a
        # Switch to the current operative character scope
        FROM = {
            force_operative_leader_into_hiding = 12
        }
    }
}

Synergy

  • [is_operative](/wiki/trigger/is_operative): Used before execution to verify that the current scope is indeed an operative, preventing erroneous calls to non-operative characters that could cause script errors.
  • [operative_leader_mission](/wiki/trigger/operative_leader_mission): Used to determine what type of mission the operative is currently executing, allowing you to decide whether to trigger the hiding effect and make the logic more precise.
  • [harm_operative_leader](/wiki/effect/harm_operative_leader): Often paired with the hiding effect—in exposure events, simultaneously inflict damage on the operative to simulate the real cost of being exposed.
  • [capture_operative](/wiki/effect/capture_operative): Serves as an "alternative branch" to hiding—the narrative can branch into either hiding or capture, with both commonly appearing in different options of the same event.

Common Pitfalls

  1. Scope Error: This effect must be executed within the CHARACTER scope. If written directly in a country scope (such as GER = { force_operative_leader_into_hiding = 12 }) without first switching into the character scope, the game will silently ignore it or throw an error. Beginners often mistakenly assume the effect is non-functional because of this.
  2. Misinterpreting the Value as Fixed Days: Beginners often assume the number entered represents the exact number of hiding days. In reality, this value is affected by in-game intelligence-related modifiers, so the final duration may differ significantly from the original value. Simple one-to-one conversion during debugging is not reliable.