effect · random

实战用法

random 效果用于在 mod 中执行一个随机结果，常见于随机事件触发、随机奖惩分配或概率性状态变化等场景。例如，在某个决策或事件选项中，希望有一定概率给某国家增加国策或触发后续效果时，可以嵌套在 random_list 内部使用，也可以独立使用产生单次随机行为。

# 在事件选项中使用 random 执行随机效果
option = {
    name = my_event.1.a
    random = {
        chance = 50
        add_victory_points = {
            province = 3340
            value = 5
        }
    }
}

配合关系

• [random_list](/wiki/effect/random_list)：random_list 提供多分支加权随机，而 random 用于单一概率判断，两者互补，适合不同粒度的随机逻辑设计。
• [hidden_effect](/wiki/effect/hidden_effect)：将 random 包裹在 hidden_effect 内可以静默执行随机效果，避免在事件界面产生多余的提示文本。
• [if](/wiki/effect/if)：在 random 内部配合 if 做条件判断，可实现"有概率触发，但触发后还需满足额外条件"的复合逻辑。
• [custom_effect_tooltip](/wiki/effect/custom_effect_tooltip)：由于 random 的随机性在 UI 上不直观，配合 custom_effect_tooltip 可向玩家展示概率说明，改善可读性。

常见坑

1. 遗漏 chance 字段：random 需要通过 chance 指定触发概率（通常为 0–100 的整数），若省略或写错字段名，效果可能始终不触发或始终触发，新手容易将其与 random_list 的权重写法混淆。
2. 在 trigger 块中误用：random 是 effect 指令，只能用在执行块（如 immediate、option、hidden_effect）中，不能用在 trigger 或 limit 块里，混用会导致脚本报错或逻辑静默失败。