命令百科

effect · clr_character_flag

Definition

  • Supported scope:CHARACTER
  • Supported target:none

Description

clear character flag

实战 · 配合 · 坑

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

实战用法

clr_character_flag 用于清除之前通过 set_character_flag 打在角色身上的临时标记，常见于事件链的状态重置，例如某个任务完成后清除"正在执行任务"的标志位，或在角色死亡/退休触发时清理残留 flag 以避免后续逻辑误判。

character_event = {
    id = my_mod.10
    ...
    option = {
        name = my_mod.10.a
        # 任务结束，清除进行中标记
        clr_character_flag = on_special_mission
    }
}

配合关系

  • [has_character_flag](/wiki/trigger/has_character_flag)：在清除之前通常先用此触发器检查 flag 是否存在，避免在 flag 未设置时执行无意义的清除操作。
  • [set_character_flag](/wiki/effect/set_character_flag)：两者构成"设置/清除"的完整生命周期，配合使用可控制角色的状态机流转。
  • [modify_character_flag](/wiki/effect/modify_character_flag)：当需要的不是完全清除而是修改 flag 的值时，可与 clr_character_flag 组合，在不同分支选择清除还是修改。

常见坑

  1. Scope 错误：clr_character_flag 必须在 CHARACTER scope 下执行。若在 COUNTRY scope 中误用，游戏不会报错但 flag 不会被清除，应通过 = { clr_character_flag = ... } 先切换到目标角色 scope。
  2. flag 名拼写不一致：flag 名称是纯字符串匹配，set_character_flag = my_flag 与 clr_character_flag = My_Flag 不是同一个 flag，大小写或下划线差异会导致清除失败且不会有任何报错提示。