命令百科

effect · remove_unit_leader

Definition

  • Supported scope:COUNTRY, CHARACTER
  • Supported target:none

Description

remove a unit leader ( remove_unit_leader=ID )

实战 · 配合 · 坑

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

实战用法

remove_unit_leader 常用于剧情事件中清除某个将领（如角色死亡、被俘、退役剧情），或在 MOD 重构将领系统时批量替换旧将领 ID。使用时需要提前通过调试或日志确认目标将领的数字 ID，然后直接传入即可。

country_event = {
    id = my_mod.5
    title = "将领阵亡"
    option = {
        name = "沉痛悼念"
        remove_unit_leader = 1200  # 移除 ID 为 1200 的将领
    }
}

配合关系

  • [create_corps_commander](/wiki/effect/create_corps_commander) / [create_field_marshal](/wiki/effect/create_field_marshal)：移除旧将领后紧接着创建新将领，实现将领"替换"剧情，避免同名角色重复存在于编制中。
  • [kill_operative](/wiki/effect/kill_operative)：同为"从世界中移除角色"类命令，在处理角色死亡事件时可对比选用——将领用 remove_unit_leader，情报人员用 kill_operative，逻辑上保持一致。
  • [any_unit_leader](/wiki/trigger/any_unit_leader)：在执行移除前先用此触发器确认对应将领确实存在，防止 ID 不存在时产生静默错误或日志报错。
  • [remove_unit_leader_role](/wiki/effect/remove_unit_leader_role)：若只想剥夺将领的某个职位而非彻底删除角色，应优先考虑此命令；两者目的不同，需按场景区分使用。

常见坑

  1. 硬编码 ID 在多人/动态生成场景失效：remove_unit_leader 依赖固定数字 ID，若将领是通过 create_corps_commander 等命令动态生成的，其 ID 可能因存档或游戏版本不同而变化，直接写死 ID 会导致目标将领无法被正确移除，应配合变量或事件触发链保证 ID 来源可靠。
  2. 误删后无法撤销：该命令执行后将领会从游戏中彻底消失（非死亡事件，不会触发死亡相关的 on_action），无法通过普通手段恢复，务必在测试环境充分验证 ID 正确性再推入正式版本。