trigger · `agency_upgrade_number`

Definition

Supported scope:COUNTRY
Supported target:none

Description

Checks the number of upgrade done in the intelligence agency. 
agency_upgrade_number > 4

实战 · 配合 · 坑

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

实战用法

这个 trigger 常用于情报机构相关的 mod 场景，例如在国家专注或决议中检查玩家是否已对情报机构进行了足够多的升级，从而解锁更高级的间谍行动或奖励。也可用于 AI 逻辑中，让 AI 只在机构成熟度达到一定水平后才触发某些战略。

# 只有在情报机构完成 4 次以上升级后，才允许激活某个高级决议
available = {
    agency_upgrade_number > 4
}

配合关系

[has_done_agency_upgrade](/wiki/trigger/has_done_agency_upgrade)：用于进一步检查玩家究竟完成了哪些具体升级，与 agency_upgrade_number 组合可实现"数量 + 种类"的双重过滤条件。
[activate_targeted_decision](/wiki/effect/activate_targeted_decision)：当情报机构升级数量满足条件时触发某个针对特定目标的决议，是情报系统扩展 mod 的常见模式。
[any_operative_leader](/wiki/trigger/any_operative_leader)：常与 agency_upgrade_number 配合使用，确保国家不仅升级了机构，还实际拥有活跃的间谍人员，两者共同作为操作前置条件。
[add_ideas](/wiki/effect/add_ideas)：在满足升级数量阈值后授予特定国策思潮或情报加成 idea，作为对深度发展情报机构的奖励。

常见坑

运算符混淆：该 trigger 使用 > / < / >= 等比较运算符，新手容易写成 agency_upgrade_number = 4（等号判断），但 HOI4 中此类数值 trigger 通常不支持等号语义，应明确使用 >= 4 或 > 3 来表达"至少完成 4 次"的逻辑。
Scope 用错：此 trigger 只能在 COUNTRY scope 下使用，若放在 STATE 或 CHARACTER 的 limit 块内将直接报错或静默失效，需确认外层 scope 确实指向一个国家。

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

This trigger is commonly used in intelligence agency-related mod scenarios, such as checking in national focuses or decisions whether the player has completed sufficient agency upgrades to unlock advanced espionage operations or rewards. It can also be used in AI logic to ensure the AI only triggers certain strategic actions after the agency reaches a certain maturity level.

# Only allow activating an advanced decision after the intelligence agency has completed more than 4 upgrades
available = {
    agency_upgrade_number > 4
}

Synergy

[has_done_agency_upgrade](/wiki/trigger/has_done_agency_upgrade): Used to further check which specific upgrades the player has completed. Combined with agency_upgrade_number, it enables dual filtering of both "quantity + type" conditions.
[activate_targeted_decision](/wiki/effect/activate_targeted_decision): Triggers a decision targeting a specific entity when the intelligence agency upgrade count meets the threshold. This is a common pattern in intelligence system expansion mods.
[any_operative_leader](/wiki/trigger/any_operative_leader): Frequently used alongside agency_upgrade_number to ensure the country not only upgraded its agency but also actually possesses active operatives. Both serve as prerequisite conditions for operations.
[add_ideas](/wiki/effect/add_ideas): Grants specific national spirit ideologies or intelligence bonuses as ideas after meeting the upgrade count threshold, serving as a reward for deep development of the intelligence agency.

Common Pitfalls

Operator Confusion: This trigger uses comparison operators like > / < / >=. Beginners often mistakenly write agency_upgrade_number = 4 (equality check), but such numerical triggers in HOI4 typically don't support equality semantics. You should explicitly use >= 4 or > 3 to express the logic of "at least 4 completions".
Wrong Scope: This trigger can only be used under COUNTRY scope. Placing it within a limit block in STATE or CHARACTER scope will cause direct errors or silent failures. Always verify that the outer scope indeed points to a country.

trigger · agency_upgrade_number