trigger · has_done_agency_upgrade

Hands-On Usage

Commonly used in intelligence agency-related events or decisions to determine whether a specific country has completed the upgrade of a particular intelligence agency, thereby unlocking subsequent storylines or rewards. For example, in espionage mods, after the player completes the highest-level intelligence agency upgrade, it allows triggering elite agent recruitment decisions.

# Decision available block: only available when the intelligence agency has completed the specified upgrade
available = {
    has_done_agency_upgrade = agency_upgrade_abwehr_signals
}

Synergy

• [agency_upgrade_number](/wiki/trigger/agency_upgrade_number) — Often paired with this trigger. First use agency_upgrade_number to check if the current number of upgrades reaches the threshold, then use has_done_agency_upgrade to precisely confirm that a specific upgrade has been completed.
• [activate_decision](/wiki/effect/activate_decision) — When the has_done_agency_upgrade condition is met, activate subsequent espionage or diplomatic decisions through an effect block, forming a complete upgrade→unlock chain.
• [add_ideas](/wiki/effect/add_ideas) — After confirming the upgrade is in place, grant the country specific national spirit ideas, reflecting the national attribute bonuses brought by improved intelligence capabilities.
• [has_completed_focus](/wiki/trigger/has_completed_focus) — Commonly used in conjunction, simultaneously requiring completion of both a specific focus and intelligence upgrade, serving as a dual threshold for advanced content.

Common Pitfalls

1. Using this trigger without establishing an intelligence agency: If the target country has never created an intelligence agency (i.e., never triggered create_intelligence_agency), this trigger will directly return false without error, easily misleading developers into thinking the upgrade name is misspelled when in fact the agency doesn't exist.
2. Upgrade name case sensitivity or spelling errors: The upgrade's key comes from the definition files in agencies/*.txt, and must exactly match the token in the file (case-sensitive). Do not guess from memory when entering it; always consult the original definition file to confirm the correct name.