trigger · num_subjects

实战用法

num_subjects 常用于判断某国是否拥有足够数量的附庸/傀儡国，从而解锁特定决议、国策或事件，例如"帝国扩张"类 mod 中要求玩家控制一定数量傀儡后才能触发帝国宣言。也可用于 AI 策略的条件门槛，防止 AI 在羽翼未丰时就尝试宣战。

# 当玩家拥有至少 3 个附庸国时，解锁帝国宣言决议
available = {
    num_subjects > 2
}

配合关系

• [any_subject_country](/wiki/trigger/any_subject_country) — 在确认附庸数量达标后，进一步筛选某个具体附庸是否满足额外条件（如意识形态、国力等），两者形成"量"与"质"的双重校验。
• [has_autonomy_state](/wiki/trigger/has_autonomy_state) — 附庸数量达标的同时，还需检查特定附庸的自治状态等级，常用于控制傀儡晋升/降级的触发条件。
• [every_subject_country](/wiki/effect/every_subject_country) — 数量条件通过后，用此 effect 对所有附庸批量执行操作（如添加 idea、转移资源），逻辑上构成"先判断数量，再批量处理"的标准流程。
• [end_puppet](/wiki/effect/end_puppet) — 在附庸过多时触发裁减逻辑，与 num_subjects 构成上限保护机制，避免附庸数超出剧本设计上限。

常见坑

1. 比较运算符混淆：num_subjects 需配合 > / < / = 等运算符使用，直接写 num_subjects = 3 表示恰好等于 3，而非"至少 3"，想表达"至少"应写 num_subjects > 2，新手常因此出现条件永远不触发的 bug。
2. scope 对象错误：此 trigger 只能在 COUNTRY scope 下使用，若误放入 STATE scope（如 limit 块内的 state 循环中）会导致脚本报错或静默失效，使用前务必确认当前 scope 确实指向一个国家。