effect · set_character_flag

实战用法

set_character_flag 常用于记录某个角色的特定状态或事件进度，例如标记某将领已经历过某场特殊战役、完成了某个任务链节点，以便后续事件或决策通过 flag 判断是否触发。典型场景是在角色相关事件的 immediate 块中打标记，防止同一事件重复触发。

# 在将领事件中标记"已接受秘密任务"
character_event = {
    id = my_mod.1
    immediate = {
        set_character_flag = accepted_secret_mission
    }
    option = {
        name = my_mod.1.a
        # 后续效果...
    }
}

配合关系

• [has_character_flag](/wiki/trigger/has_character_flag) — 设置 flag 后，通常需要用此触发器检测该 flag 是否存在，从而控制后续事件或决策的触发条件。
• [clr_character_flag](/wiki/effect/clr_character_flag) — 与 set_character_flag 相对，用于在角色状态改变后清除不再需要的 flag，避免脏数据残留。
• [modify_character_flag](/wiki/effect/modify_character_flag) — 当需要对 flag 进行数值累加或修改（而非简单的开/关标记）时，与 set_character_flag 配合管理角色状态的数值型 flag。
• [operative_leader_event](/wiki/effect/operative_leader_event) — 在特工任务事件中常配合使用，先用事件触发设旗，再通过旗帜驱动后续情报链剧情。

常见坑

1. Scope 错误：set_character_flag 必须在 CHARACTER scope 下执行。新手常在国家 scope（如 country_event 的 option 中）直接调用，导致脚本报错或 flag 打在错误对象上，应先用 every_character / specific_character 等方式切换到正确的角色 scope。
2. Flag 命名冲突：flag 名称是全局字符串，不同 mod 或事件链若使用相同的 flag 名（如 done、flag_1），会造成跨角色或跨事件的状态误判，建议加上 mod 前缀作为命名规范（如 mymod_character_accepted_mission）。