effect · retire

实战用法

retire 用于在剧情事件或决议中强制让某个角色"退役/卸任"，常见于历史事件触发时淘汰老将、或在政治清洗事件中移除某位顾问/将领。例如，当某个将领因伤病或政治原因离开舞台，可在事件的 option 块中调用：

character_event = {
    id = my_mod.1
    option = {
        name = my_mod.1.a
        # 先切换到角色 scope，再执行退役
        GER_erich_von_manstein = {
            retire = yes
        }
    }
}

配合关系

• [is_corps_commander](/wiki/trigger/is_corps_commander) / [is_field_marshal](/wiki/trigger/is_field_marshal)：退役前先判断角色当前是否处于活跃指挥职位，避免对未激活角色触发无效逻辑。
• [remove_unit_leader](/wiki/effect/remove_unit_leader)：若需彻底从游戏中移除角色（而非仅退役），可在 retire 之后补充调用，确保角色不残留在领导人列表中。
• [promote_character](/wiki/effect/promote_character)：常与 retire 配对使用，在一位角色退役的同时提拔另一位角色，实现"新老交替"的叙事效果。
• [set_character_flag](/wiki/effect/set_character_flag)：在执行 retire 前打标记，防止同一角色被多个事件重复触发退役流程。

常见坑

1. 忘记进入 CHARACTER scope：retire 必须在角色自身的 scope 内调用，若直接写在国家 scope（如 GER = { retire = yes }）会报错或静默失效，需要用 角色TAG = { retire = yes } 或 any_character = { limit = { ... } retire = yes } 的方式先切换到角色 scope。
2. 对已死亡/已退役角色再次调用：若角色已经通过其他途径（如 remove_unit_leader）从游戏中移除，再对其执行 retire 不会报显式错误，但可能产生意料之外的 scope 解析警告，建议配合 [is_unit_leader](/wiki/trigger/is_unit_leader) 或 [is_advisor](/wiki/trigger/is_advisor) 先做存在性检查。