trigger · recon_advantage

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

1. 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.
2. 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.