trigger · is_air_chief

Hands-On Usage

In scripts for recruiting or dismissing advisors, is_air_chief is commonly used to check whether a character is currently employed as an air force chief of staff, thereby determining whether to trigger related events or execute certain effects. For example, in a character promotion event, activate a specific story branch only when the character is already serving as air force chief of staff:

# Event trigger restriction: only takes effect when character is already serving as air force chief of staff
character_event = {
    trigger = {
        FROM = {
            is_air_chief = yes
        }
    }
    option = {
        name = "Promote to Air Force Chief of Staff"
        FROM = {
            add_skill_level = 1
        }
    }
}

Synergy

• [is_hired_as_advisor](/wiki/trigger/is_hired_as_advisor): Using both together allows you to distinguish whether a character is employed as an advisor or is exclusively serving as air force chief of staff, avoiding misidentification of character status.
• [has_advisor_role](/wiki/trigger/has_advisor_role): Used to further confirm the advisor role type possessed by the character. Combined with is_air_chief, it enables granular validation logic for role verification.
• [remove_advisor_role](/wiki/effect/remove_advisor_role): After confirming the character has is_air_chief = yes, use this effect to safely remove their air force chief of staff position, avoiding script errors from attempting to remove a role from a character not currently employed.
• [advisor_can_be_fired](/wiki/trigger/advisor_can_be_fired): In a dismissal workflow, first use is_air_chief to confirm identity, then use this trigger to check whether the character is allowed to be dismissed. Combined, these two steps ensure logical rigor.

Common Pitfalls

1. Incorrect Scope Usage: is_air_chief must be called within a CHARACTER scope. Beginners often mistakenly write it directly when in a country scope (such as when ROOT/FROM refer to countries rather than characters), resulting in silent script failure or errors. You must first enter the correct character scope via country_leader, every_character, or similar methods.
2. Confusing "Possession of Role Definition" with "Currently Employed": A character may have an air force chief of staff advisor_role defined in the character file, but is_air_chief checks whether the character is currently hired, not whether the character possesses that role definition. An unhired character returns no even if they have that role definition, and you should use [has_advisor_role](/wiki/trigger/has_advisor_role) to check whether the role definition exists.