命令百科

effect · add_power_balance_value

Definition

  • Supported scope:any
  • Supported target:none

Description

adds current value of a power balance

Example:
add_power_balance_value = {
	id = power_balance_id
	value = 0.42 # this value is added to the current value of the power balance
	tooltip_side = side_id # optional - add this to tell the game to show the name of the specific side in the tooltip
}

实战 · 配合 · 坑

实战内容由 AI 生成,并已对照 vanilla 命令词表校验 —— 请当作起点而非权威依据。上方的定义节才是游戏自带文档原文。

实战用法

add_power_balance_value 常见于自定义意识形态拉锯、阵营影响力博弈或外交事件结果等 mod 场景，例如当某国完成特定国策时将权力天平推向己方阵营。下面示例展示了一个国策完成后向某一侧倾斜的写法：

focus = {
    id = my_focus_push_balance
    ...
    completion_reward = {
        add_power_balance_value = {
            id = east_west_balance
            value = 0.15
            tooltip_side = western_side
        }
    }
}

配合关系

  • [add_power_balance_modifier](/wiki/effect/add_power_balance_modifier)：用于在调整即时数值的同时附加持续性的每日/每周偏移修正，两者结合可实现"一次性推进 + 长期维持"的双重效果。
  • [is_power_balance_in_range](/wiki/trigger/is_power_balance_in_range)：在执行推值之前先检测当前天平是否处于某个区间，避免数值溢出边界或触发不符合预期的阵营状态。
  • [is_power_balance_side_active](/wiki/trigger/is_power_balance_side_active)：确认特定阵营当前是否处于激活状态后再写入数值，防止在天平尚未初始化时执行操作导致逻辑错误。
  • [remove_all_power_balance_modifiers](/wiki/effect/remove_all_power_balance_modifiers)：在重置剧本或切换阶段时，先清除所有修正再重新调用本 effect 写入基准值，确保状态干净。

常见坑

  1. 忘记 id 与实际定义的 power balance 名称完全匹配：id 必须与 common/power_balance/ 文件夹中对应定义文件里声明的 id 一字不差，拼写错误不会报错但效果完全不生效，调试时难以察觉。
  2. tooltip_side 并非必须填写却容易混淆显示：省略该字段时游戏会使用默认 tooltip，但若填写了一个不存在于该 power balance 定义中的 side id，tooltip 将显示空白或乱码，新手常以为是数值未生效而走弯路。