trigger · `recon_advantage`

Definition

Supported scope:COMBATANT
Supported target:none

Description

checks if side has an advantage in recon level

实战 · 配合 · 坑

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

实战用法

recon_advantage 常用于自定义战斗事件或决策中，根据侦察优势动态触发战术加成，例如在战斗进行中赋予拥有侦察优势一方的特殊修正或奖励。也可用于 AI 决策逻辑，让 AI 在己方具备侦察优势时更积极地投入预备队。

# 示例：战斗中若我方拥有侦察优势，则触发额外战术事件
on_combat_phase = {
    limit = {
        is_attacker = yes
        recon_advantage = yes
    }
    random_events = {
        100 = tactical_recon_bonus.1
    }
}

配合关系

[is_attacker](/wiki/trigger/is_attacker)：配合使用可以区分进攻/防守方是否具备侦察优势，避免对双方同时触发逻辑。
[skill_advantage](/wiki/trigger/skill_advantage)：侦察优势与指挥技能优势往往共同决定战斗主动权，联合判断可实现更精细的"全面压制"条件。
[has_combat_modifier](/wiki/trigger/has_combat_modifier)：可先检查当前战斗修正再结合侦察优势，防止重复叠加同一修正效果。
[phase](/wiki/trigger/phase)：侦察优势的价值在特定战斗阶段（如准备阶段）更突出，配合 phase 可限定触发窗口。

常见坑

Scope 误用：recon_advantage 只能在 COMBATANT（战斗方）scope 下使用，若写在 country 或 division scope 中将直接报错或静默失效，需确保外层是战斗相关的 on_action（如 on_combat_phase）才能进入正确 scope。
误以为需要 target：该 trigger 不接受任何 target 参数，新手有时会尝试写 recon_advantage = ROOT 或类似带目标的写法，这是无效语法，直接写 recon_advantage = yes 即可。

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

recon_advantage is commonly used in custom battle events or decisions to dynamically trigger tactical bonuses based on reconnaissance superiority—for example, granting special modifiers or rewards to the side with reconnaissance advantage during combat, or providing additional perks through reinforcement deployment. It can also be integrated into AI decision logic, allowing the AI to commit reserves more aggressively when it possesses reconnaissance advantage.

# Example: Trigger additional tactical event during combat if our side has reconnaissance advantage
on_combat_phase = {
    limit = {
        is_attacker = yes
        recon_advantage = yes
    }
    random_events = {
        100 = tactical_recon_bonus.1
    }
}

Synergy

[is_attacker](/wiki/trigger/is_attacker): Use in combination to distinguish whether the attacking or defending side has reconnaissance advantage, preventing logic from triggering simultaneously for both parties.
[skill_advantage](/wiki/trigger/skill_advantage): Reconnaissance advantage and commander skill advantage often jointly determine combat initiative; evaluating both together enables more refined "complete dominance" conditions.
[has_combat_modifier](/wiki/trigger/has_combat_modifier): Check existing combat modifiers first before applying reconnaissance advantage effects to prevent unintended stacking of the same modifier.
[phase](/wiki/trigger/phase): Reconnaissance advantage is particularly valuable during specific combat phases (such as the preparation phase); combining with phase allows you to restrict the trigger window.

Common Pitfalls

Scope Misuse: recon_advantage only functions within COMBATANT (combatant) scope. Using it in country or division scope will cause errors or silent failures. Ensure the outer context is a combat-related on_action (such as on_combat_phase) to enter the correct scope.
Mistakenly Adding Targets: This trigger does not accept any target parameters. Newcomers sometimes attempt syntax like recon_advantage = ROOT or other target-based variations, which are invalid. Simply use recon_advantage = yes.

trigger · recon_advantage