effect · modify_global_flag

实战用法

modify_global_flag 常用于需要对已有全局计数器进行累加或递减的 mod 场景，例如追踪全局事件触发次数、战争烈度积分或外交声望值。与直接覆盖不同，它在不确定旗帜是否存在时能避免意外初始化，适合多国事件共同写入同一全局状态的设计。

# 每次某国触发事件时，全局战争烈度计数器 +1
country_event = {
    id = my_mod.10
    option = {
        name = my_mod.10.a
        modify_global_flag = {
            flag = global_war_intensity
            value = 1
        }
    }
}

配合关系

• [set_global_flag](/wiki/effect/set_global_flag)：用于初始化全局旗帜并赋予初始数值，因为 modify_global_flag 只修改已存在的旗帜，必须先用 set_global_flag 创建它。
• [has_global_flag](/wiki/trigger/has_global_flag)：在触发条件中检查旗帜是否存在及其数值范围，与 modify_global_flag 形成"读-写"配合。
• [clr_global_flag](/wiki/effect/clr_global_flag)：在全局流程结束时清除旗帜，与 set_global_flag / modify_global_flag 共同组成"初始化→累积→清除"的完整生命周期。
• [if](/wiki/effect/if)：在修改前先用 has_global_flag 条件包裹，确保只在旗帜确实存在时执行修改逻辑，避免静默失效难以排查。

常见坑

1. 旗帜不存在时静默失败：新手经常忘记该指令的前提是旗帜已存在，若未事先用 set_global_flag 初始化，执行后不会报错但也不会有任何效果，导致逻辑难以调试。
2. 误用 value 的语义：value 是在原有数值基础上的增量（可为负数），而非设置绝对值；若想直接赋值应改用 set_global_flag = { flag = ... value = ... }，混淆二者会导致数值持续偏移。