trigger · is_army_leader

Hands-On Usage

is_army_leader is commonly used in character-related events or decisions to restrict certain effects to apply only to army commanders (corps commander or field marshal). For example, you can use it to add traits or promote characters that meet the conditions. When character focus/event triggers, it helps distinguish characters with different roles and prevents unintended effects on advisors, scientists, and similar characters.

# Event option: only army commanders can receive this trait
option = {
    name = my_event.option_a
    trigger = {
        is_army_leader = yes
    }
    add_trait = { trait = brilliant_strategist }
}

Synergy

• [is_corps_commander](/wiki/trigger/is_corps_commander) / [is_field_marshal](/wiki/trigger/is_field_marshal): is_army_leader only checks "whether the character is an army commander". If you need to further distinguish between corps commanders and field marshals, combine it with these two triggers for more granular checks.
• [is_leading_army](/wiki/trigger/is_leading_army): Pairing with is_army_leader allows you to differentiate between "having an army commander position" and "currently leading troops in combat", enabling more precise wartime condition checks.
• [add_unit_leader_trait](/wiki/effect/add_unit_leader_trait): After confirming is_army_leader = yes, the typical follow-up action is to add commander traits using this effect.
• [promote_leader](/wiki/effect/promote_leader): After verifying the character is an army commander, you can use this effect to promote their military rank when conditions are met.

Common Pitfalls

1. Confusion with is_unit_leader: is_unit_leader returns true for all unit commanders (army/navy/air), while is_army_leader only applies to army commanders. If your scenario involves only army units but you mistakenly use is_unit_leader, naval commanders or air force commanders will unexpectedly satisfy the condition.
2. Incorrect scope: This trigger must be used within CHARACTER scope. If you call it directly in a trigger block under COUNTRY scope without first switching scope using any_character / every_character or similar, the script will error or silently fail.