effect · randomize_variable

实战用法

randomize_variable 的实际行为等同于 randomize_temp_variable，用于对一个已声明的普通变量（非临时变量）赋予随机数值，常见于需要持久化随机结果的场景，例如给某个国家生成一次性随机事件权重或随机资源储量。与临时变量版本的区别在于，结果会保存在 scope 上供后续逻辑反复读取。

# 为当前国家生成一个随机储量值并存入持久变量
country_event = {
    immediate = {
        set_variable = { var = resource_roll value = 0 }
        randomize_variable = {
            var = resource_roll
            min = 1
            max = 100
        }
        if = {
            limit = { check_variable = { var = resource_roll value > 80 } }
            add_victory_points = { province = 1234 value = 5 }
        }
    }
}

配合关系

• [set_variable](/wiki/effect/set_variable)：在调用 randomize_variable 之前先用 set_variable 将变量初始化为 0，避免读取未定义变量导致脚本报错。
• [check_variable](/wiki/trigger/check_variable)：随机化完成后，用 check_variable 对结果区间进行判断，从而分支执行不同的游戏逻辑。
• [clamp_variable](/wiki/effect/clamp_variable)：随机值生成后可用 clamp_variable 将其强制约束在安全范围内，防止边界溢出影响后续计算。
• [randomize_temp_variable](/wiki/effect/randomize_temp_variable)：若随机结果只在当前 effect 块内使用一次，改用 randomize_temp_variable 性能更优，两者语法完全一致，按需选择。

常见坑

1. 变量未预先声明就随机化：直接对一个从未 set_variable 过的变量调用 randomize_variable，在部分版本中会产生脚本警告甚至静默失败，务必先用 set_variable 赋初值。
2. 误将临时变量名传入：randomize_variable 操作的是持久变量，若变量名以 temp_ 命名约定书写但实为普通变量，逻辑上不会出错，但容易与 randomize_temp_variable 混淆，导致跨 effect 块读取时拿到的是未初始化的临时变量而非预期的持久值。