effect · turn_operative

实战用法

turn_operative 常用于谍报剧情事件或决议中，模拟敌方特工被策反并转投己方的叙事。例如在一个事件中，玩家的特工被敌国捕获后，不是被处决而是被说服倒戈，此时可用该 effect 实现情报人员的阵营转移并触发相关后续逻辑。

# 在事件 option 中：敌国 GER 的特工 PREV 被我方策反
country_event = {
    id = spy_events.5
    option = {
        name = spy_events.5.a
        # scope 为 FROM（被捕特工所属国家）的情境下
        GER = {
            turn_operative = {
                operative = PREV
            }
        }
    }
}

# 或者在 unit leader scope 下直接指定策反方
turn_operative = { turned_by = GER }

配合关系

• [capture_operative](/wiki/effect/capture_operative)：通常先捕获特工，再决定是处决还是策反，两者是同一谍报流程的前后两步。
• [kill_operative](/wiki/effect/kill_operative)：作为 turn_operative 的替代分支——在同一 option 分支逻辑中，一个选项策反、另一个选项处决，二者互斥配合构成完整的谍报事件选择。
• [free_operative](/wiki/effect/free_operative)：释放、策反、处决三选一，覆盖对被捕特工的全部处置方式，常在同一事件的不同 option 中分别使用。
• [has_captured_operative](/wiki/trigger/has_captured_operative)：触发器用于判断当前是否持有被捕特工，只有满足此条件才应出现含 turn_operative 的选项，避免对未被捕特工非法执行该 effect。

常见坑

1. 目标国与特工归属国相同时无效：若 turned_by 指定的国家本身就是该特工的所属国，游戏会报错并跳过执行——这意味着你不能用此 effect 把自己的特工"策反回自己"，策划事件时要确保策反方与特工原属国不同。
2. on_action 执行顺序陷阱：官方明确警告 on_operative_death 这个 on_action 可能在 turn_operative 之后的 effect 执行之前就触发，若后续 effect 依赖"特工已转移"的状态，可能得到意料之外的结果，建议将依赖顺序的逻辑移至 on_action 内部或用事件延迟处理。