Wiki

effect · add_victory_points

Definition

  • Supported scope:any
  • Supported target:any

Description

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

Hands-On Notes

Hands-on notes are AI-generated and checked against the vanilla command vocabulary — treat them as a starting point, not authoritative reference. The definition above is the game's own documentation.

Hands-On Usage

add_victory_points is commonly used in story events or decisions to dynamically increase or decrease victory points for strategic locations. For example, granting rewards after capturing a province, or reducing a city's strategic value due to war damage. In alternate map redraw mods, it is also frequently used to supplement initial victory point weights for newly created provinces.

# After a country completes the "Rebuild Harbor" decision, add victory points to the target harbor province
complete_effect = {
    add_victory_points = {
        province = 11603   # Target harbor province ID
        value = 3
    }
}

Synergy

  • [set_victory_points](/wiki/effect/set_victory_points): add_victory_points adds or subtracts from the existing value, while set_victory_points overwrites the value directly. Used together, you can reset to zero first, then set precise values, avoiding loss of control due to stacking.
  • [custom_effect_tooltip](/wiki/effect/custom_effect_tooltip): Victory point changes do not display text explanations to the player directly. Pairing with this command allows you to add readable tooltips in the UI, informing the player which province's points have changed.
  • [if](/wiki/effect/if): Commonly wrapped in conditional blocks to execute point changes only when specific trigger conditions (such as province ownership or war status) are met, preventing accidental operations on non-existent or uncontrolled provinces.
  • [check_variable](/wiki/trigger/check_variable): Use variable checks before execution to confirm that dynamic province IDs have been correctly assigned. Used with if, it ensures that the province field receives a valid value.

Common Pitfalls

  1. Confusing province ID with state ID: The province field requires the numeric ID of a province, not a state ID. Although their numeric ranges overlap, they have different meanings. Entering the wrong one causes the effect to fail silently or apply to the wrong location. Always verify using the map editor or map/definition.csv.
  2. Negative values without boundary testing: value supports negative numbers to deduct victory points, but if the total value drops below 0, game behavior is inconsistent across versions (some versions truncate to 0, others may produce abnormal displays). It is recommended to add lower bound protection using [if](/wiki/effect/if) + [check_variable](/wiki/trigger/check_variable).