trigger · `has_done_agency_upgrade`

Definition

Supported scope:COUNTRY
Supported target:none

Description

has country done this intelligence agency upgrade (to its highest level)

实战 · 配合 · 坑

实战内容由 AI 生成,并已对照 vanilla 命令词表校验 —— 请当作起点而非权威依据。上方的定义节才是游戏自带文档原文。

实战用法

常用于情报机构相关事件或决策中，判断某国是否已将特定情报机构升级完毕，从而解锁后续剧情或奖励。例如在间谍战 mod 中，当玩家完成最高级别的情报机构升级后，才允许触发精英特工招募决策。

# 决策 available 块：仅当情报机构已完成指定升级时可用
available = {
    has_done_agency_upgrade = agency_upgrade_abwehr_signals
}

配合关系

[agency_upgrade_number](/wiki/trigger/agency_upgrade_number) — 常与本 trigger 搭配，先用 agency_upgrade_number 检查当前升级数量是否达到门槛，再用 has_done_agency_upgrade 精确确认某个特定升级已完成。
[activate_decision](/wiki/effect/activate_decision) — 当 has_done_agency_upgrade 条件满足时，通过 effect 块激活后续的间谍或外交决策，形成升级→解锁的完整链条。
[add_ideas](/wiki/effect/add_ideas) — 确认升级到位后赋予国家特定国策思路，体现情报能力提升带来的国家属性加成。
[has_completed_focus](/wiki/trigger/has_completed_focus) — 常联合使用，同时要求完成特定国策与情报升级，作为高级内容的双重门槛。

常见坑

未建立情报机构就使用本 trigger：若目标国家根本没有创建情报机构（即从未触发 create_intelligence_agency），本 trigger 会直接返回 false 而不报错，容易让开发者误以为是升级名写错，实际是机构不存在导致的。
升级名称大小写或拼写错误：升级的 key 来自 agencies/*.txt 定义文件，必须与文件中的 token 完全一致（区分大小写），填写时不要凭记忆猜测，务必查阅原始定义文件确认准确名称。

Hands-On Notes

Hands-on notes are AI-generated and checked against the vanilla command vocabulary — treat them as a starting point, not authoritative reference. The definition above is the game's own documentation.

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

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.
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.

trigger · has_done_agency_upgrade