trigger · has_air_ledger

Hands-On Usage

has_air_ledger is commonly used in character-focused mods to determine whether a character holds an air ledger (i.e., possesses air commander status), which can then be used to decide whether to display specific focus options, decisions, or advisor abilities. For example, when you want to unlock certain traits or event options exclusively for air commander characters, you can use this trigger as a prerequisite condition to filter out non-air characters:

available = {
    FROM = {
        has_air_ledger = yes
    }
}

Synergy

• [has_army_ledger](/wiki/trigger/has_army_ledger) / [has_navy_ledger](/wiki/trigger/has_navy_ledger): These three triggers are often used in parallel to construct comprehensive branching logic for character ledger types, allowing mutually exclusive filtering of corresponding military branch commanders.
• [is_air_chief](/wiki/trigger/is_air_chief): The air chief of staff shares strong association with the air domain and is commonly combined with has_air_ledger to confirm dual character identity (both possessing a ledger and holding a staff position).
• [has_trait](/wiki/trigger/has_trait): After confirming a character possesses an air ledger, further check whether they have specific air combat traits, enabling multi-layered conditional filtering.
• [add_timed_unit_leader_trait](/wiki/effect/add_timed_unit_leader_trait): After satisfying has_air_ledger = yes, use this effect to grant timed traits to air commanders, exemplifying the typical "check → apply effect" pattern.

Common Pitfalls

1. Scope Confusion: This trigger can only be used within CHARACTER scope. If called directly in a trigger block under COUNTRY scope without first switching to character scope (such as via FROM, every_character, etc.), it will cause script errors or silent failures. Newcomers often overlook the importance of tracking the current scope context.
2. Confusion with is_air_chief: has_air_ledger checks whether a character possesses an air ledger (i.e., air commander status), not whether they currently serve as air chief of staff. Using these two interchangeably will result in deviations in the conditional logic range.