trigger · is_army_chief

Hands-On Usage

is_army_chief is commonly used to check whether a character currently holds the position of army chief of staff. Typical applications include filtering target characters in advisor dismissal logic, trait unlocking, or event trigger conditions. The standard use case is when you want to apply specific buffs or trigger exclusive events for "characters currently serving as army chief of staff"—use this trigger as a prerequisite condition.

# Only trigger the event if the character is currently serving as army chief of staff
character_event = {
    id = my_mod.101
    trigger = {
        is_army_chief = yes
        has_trait = brilliant_strategist
    }
    # ...
}

Synergy

• [is_advisor](/wiki/trigger/is_advisor): is_army_chief checks only the specific position of army chief of staff, while is_advisor checks whether a character holds any advisor position. Combining both allows you to build precise conditional layers like "serving as an advisor and specifically as army chief of staff."
• [has_advisor_role](/wiki/trigger/has_advisor_role): Used to further confirm that a character possesses the army chief of staff role definition. Combined with is_army_chief, it helps distinguish between "has the role but not hired" and "hired and actively serving" states.
• [advisor_can_be_fired](/wiki/trigger/advisor_can_be_fired): Before forcibly dismissing an army chief of staff, first confirm they are in office with is_army_chief = yes, then pair this trigger to verify whether dismissal is permitted, avoiding script errors.
• [remove_advisor_role](/wiki/effect/remove_advisor_role): After confirming a character actively serves as army chief of staff, use this effect to remove their advisor role. This is the standard companion step in a "check then execute removal" workflow.

Common Pitfalls

1. Confusing "role possession" with "active employment": A character can be assigned the army chief of staff role definition via add_advisor_role, but is_army_chief = yes only returns true when that character is actually hired and employed by the nation. Characters with only the role defined but not hired will return false—beginners often mistake this for a script bug.
2. Scope errors: This trigger must be used within a CHARACTER scope. If written directly in a national scope (such as the top-level trigger block of a country_event) without first switching to a specific character scope, the condition will fail to evaluate correctly or cause errors.