effect · clr_unit_leader_flag

实战用法

clr_unit_leader_flag 用于在旧版 mod 中清除挂在将领 CHARACTER scope 下的自定义布尔标记，例如在某个事件结束后撤销之前用 set_unit_leader_flag 打上的状态标记，防止标记残留导致后续触发器误判。由于官方已将其标为废弃，仅在维护老旧 mod 或兼容旧存档时才会看到它。

# 旧版写法示例：清除将领的特殊任务标记
character_event = {
    id = my_mod.10
    ...
    option = {
        name = my_mod.10.a
        # 任务结束，清除标记
        clr_unit_leader_flag = my_special_mission_active
    }
}

配合关系

• [set_unit_leader_flag](/wiki/effect/set_unit_leader_flag) — 与本命令成对使用，先用 set 打标记，再用 clr 清除，构成完整的标记生命周期管理。
• [has_unit_leader_flag](/wiki/trigger/has_unit_leader_flag) — 清除前通常用此触发器检查标记是否存在，避免在无标记时执行无意义的清除操作。
• [clr_character_flag](/wiki/effect/clr_character_flag) — 官方推荐的替代命令，迁移旧 mod 时应将 clr_unit_leader_flag 一对一替换为此命令。
• [modify_unit_leader_flag](/wiki/effect/modify_unit_leader_flag) — 同属旧版将领标记体系，若需要的是修改而非清除，可对比选用。

常见坑

1. 仍在新 mod 中使用此命令：该 effect 已被官方废弃，新 mod 应直接使用 clr_character_flag；继续使用旧命令虽然短期内可能不报错，但未来版本兼容性无法保障，建议第一时间迁移。
2. scope 填错：此命令必须在 CHARACTER scope 下执行；若在 COUNTRY scope 中调用（例如直接写在国家事件的 immediate 块里而未先切入具体角色），脚本将静默失效，标记不会被清除，难以排查。