effect · add_to_variable

实战用法

add_to_variable 最常用于追踪累计数值的 mod 场景，例如记录玩家发动战争的次数、累计征召的人口，或动态积分系统中向某个变量叠加分值。它与 set_variable 的区别在于它是叠加而非覆盖，因此适合多个事件都可能触发、每次只贡献一部分数值的设计。

# 每次触发事件时，给国家的"战争积分"变量加上当前军事力量值
country_event = {
    id = my_mod.1
    option = {
        name = my_mod.1.a
        add_to_variable = {
            var = war_score_total
            value = army_strength  # 引用另一个变量作为增量
        }
    }
}

配合关系

• [set_variable](/wiki/effect/set_variable)：在首次使用 add_to_variable 前，通常需要先用 set_variable 将目标变量初始化为 0，否则叠加到未定义变量上可能产生意外结果。
• [clamp_variable](/wiki/effect/clamp_variable)：叠加操作容易让变量超出设计上限，配合 clamp_variable 可在每次叠加后将值约束在合法范围内。
• [check_variable](/wiki/trigger/check_variable)：叠加后通常需要检测变量是否达到阈值以触发下一步逻辑，check_variable 是最直接的配套触发器。
• [multiply_variable](/wiki/effect/multiply_variable)：在计算复合公式时（如带倍率的积分系统），先用 add_to_variable 累加基础值，再用 multiply_variable 应用系数。

常见坑

1. 对未初始化变量叠加：若目标变量 var 从未被 set_variable 赋值，游戏会将其视为 0 开始叠加，表面上看似正常，但在某些版本或特定 scope 下可能导致 has_variable 检测不一致，建议始终在 on_startup 或事件触发前显式初始化变量。
2. value 字段误填变量名字符串：value 接受数字字面量或同 scope 下已定义的变量名（不加引号），若误将变量名写成带引号的字符串，游戏不会报错但只会读入 0 或报解析警告，导致变量始终不增加，排查时极易忽略。