命令百科

effect · add_victory_points

Definition

  • Supported scope:any
  • Supported target:any

Description

adds victory point to province
add_victory_points = {
  province = 42
  value = 5
}

实战 · 配合 · 坑

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

实战用法

add_victory_points 常用于剧情事件或决议中动态增减战略要地的胜利点数,例如占领某省后给予奖励、或因战争破坏而削减某城市的战略价值。在备用地图重绘 mod 中,也常用它来补充新建省份的初始胜利点权重。

# 某国完成"重建港口"决议后,为目标港口省份追加胜利点
complete_effect = {
    add_victory_points = {
        province = 11603   # 目标港口省份 ID
        value = 3
    }
}

配合关系

  • [set_victory_points](/wiki/effect/set_victory_points)add_victory_points 是在现有值上增减set_victory_points 是直接覆盖赋值;两者配合可先清零再精确设定,避免叠加导致数值失控。
  • [custom_effect_tooltip](/wiki/effect/custom_effect_tooltip):胜利点变动对玩家不直接显示文字说明,配合该指令可在 UI 中补充可读提示,告知玩家究竟哪个省份点数发生了变化。
  • [if](/wiki/effect/if):常包裹在条件块中,只在特定触发条件(如省份归属、战争状态)满足时才执行点数变动,防止错误地对不存在或未控制的省份操作。
  • [check_variable](/wiki/trigger/check_variable):在执行前用变量检查确认动态省份 ID 已被正确赋值,与 if 联用可保证 province 字段传入有效值。

常见坑

  1. 省份 ID 填成州 IDprovince 字段需要填写省份(province)的数字 ID,而非(state)ID,两者数值范围重叠但含义不同,填错会导致效果静默失败或作用到错误地点,务必用地图编辑器或 map/definition.csv 核对。
  2. 负值未测试边界value 支持负数以扣减胜利点,但若扣减后总值低于 0,游戏行为并不统一(部分版本会截断至 0,部分版本可能产生异常显示),建议配合 [if](/wiki/effect/if) + [check_variable](/wiki/trigger/check_variable) 做下限保护。