trigger · is_operative

实战用法

is_operative 常用于需要区分角色类型的场景，例如为情报官员专属事件设置触发条件，或在角色管理 mod 中限制某些 trait / 顾问角色只能授予特工而非将领。典型场景是在角色 focus 或事件的 trigger 块中，确保当前角色确实是特工身份再执行后续逻辑。

# 仅当角色是特工时，才允许触发该事件
character_event = {
    id = my_mod.1
    trigger = {
        is_operative = yes
        is_operative_captured = no
    }
    ...
}

配合关系

• [is_operative_captured](/wiki/trigger/is_operative_captured)：最常见的组合——先确认是特工，再进一步判断其是否被捕，两层检查共同构成完整的状态过滤。
• [operative_leader_mission](/wiki/trigger/operative_leader_mission)：在确认角色为特工后，进一步检测其当前执行的任务类型，用于针对特定任务触发不同剧情或奖励。
• [kill_operative](/wiki/effect/kill_operative) / [free_operative](/wiki/effect/free_operative)：在 effect 块中，通常先以 is_operative = yes 作为前置 limit 条件再调用这些效果，避免对非特工角色误触发执行逻辑。
• [has_trait](/wiki/trigger/has_trait)：配合使用可筛选具备特定特质的特工，例如只对拥有某隐蔽技能 trait 的特工应用后续判断或效果。

常见坑

1. 在非 CHARACTER scope 下使用：is_operative 只在 CHARACTER scope 有效，若在国家 scope（如 country_event 的顶层 trigger 块）直接写会报错或静默失败，需先通过 any_character / every_character 等迭代进入角色 scope 再使用。
2. 误以为将领也会返回 yes：is_operative = yes 仅对情报特工角色为真，陆军将领、海军将领等同样是 CHARACTER scope 的角色并不满足此条件，不能用它泛指"所有角色"，需搭配 is_unit_leader 等分别处理不同角色类型。