trigger · is_leading_army_group

Hands-On Usage

Commonly used in promotion or trait assignment mods to distinguish between field commanders leading individual armies and marshal-level roles commanding entire army groups, thereby triggering different reward or restriction logic. For example, only allow a character to gain specific advanced command traits when they are actively leading an army group:

# In the trigger block of an on_action or decision
character_event = {
    trigger = {
        is_leading_army_group = yes
        is_field_marshal = yes
    }
    # Fires only for army marshals actively commanding an army group
}

Synergy

• [is_field_marshal](/wiki/trigger/is_field_marshal): Army groups are typically commanded by army marshals; combining these triggers allows precise filtering of "marshals currently exercising army group command duties," preventing false positives on regular field commanders.
• [is_leading_army](/wiki/trigger/is_leading_army): Serves as a complementary trigger to is_leading_army_group; use NOT nesting to distinguish between "commanding only a single army" and "commanding an army group" states, enabling branching logic.
• [add_unit_leader_trait](/wiki/effect/add_unit_leader_trait): After conditions are met, dynamically add exclusive command traits to a character; commonly seen in mod designs featuring "unlock new traits upon promotion to army group commander."
• [add_skill_level](/wiki/effect/add_skill_level): Grant skill bonuses after confirming a character is commanding an army group, simulating growth from large-scale command experience.

Common Pitfalls

1. Confusing is_leading_army_group with is_field_marshal: A character holding the army marshal position does not necessarily mean they are currently commanding an army group (they may be in an unassigned state); this trigger must be checked simultaneously to confirm their actual command status.
2. Calling within COUNTRY scope: This trigger is only valid in CHARACTER scope; if used directly in the top-level trigger block of a country event without first switching to the correct character scope, it will cause script errors or always return false. Use any_character or a specific character scope wrapper instead.