命令百科

effect · subtract_from_temp_variable

Definition

  • Supported scope:any
  • Supported target:none

Description

Subtracts a value, a variable, or a [math expression](script_math_expression.md) from a temp variable.

### Examples

subtract_from_temp_variable = { num_dogs = 5 } subtract_from_temp_variable = { num_dogs = { value = num_cats multiply = 2 } }

实战 · 配合 · 坑

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

实战用法

subtract_from_temp_variable 常用于需要在单次事件或 focus 执行块内做临时数值计算的场景，例如计算两个数值的差值、累减循环计数器，或在不污染持久变量的前提下推导中间结果。由于 temp variable 在脚本作用域结束后自动销毁，这个命令特别适合"用完即弃"的逻辑链。

# 示例：计算某国剩余可用建设点（总建设点减去已用点）
set_temp_variable = { var = available_slots value = total_construction_slots }
subtract_from_temp_variable = {
    var   = available_slots
    value = used_construction_slots
}
if = {
    limit = { check_variable = { available_slots > 0 } }
    add_to_variable = { var = bonus_civilian_factories value = available_slots }
}

配合关系

  • [set_temp_variable](/wiki/effect/set_temp_variable) — 通常先用它初始化临时变量的初始值，再用 subtract_from_temp_variable 对其进行减法操作，构成"赋值→运算"的标准流程。
  • [check_variable](/wiki/trigger/check_variable) — 减法完成后，立即用此 trigger 检验结果是否满足阈值条件，决定后续分支走向。
  • [clamp_temp_variable](/wiki/effect/clamp_temp_variable) — 减法可能产生负数，配合 clamp 将结果限定在合法范围内，避免下游逻辑出现意外值。
  • [multiply_temp_variable](/wiki/effect/multiply_temp_variable) — 在复合公式中，减法结果往往还需要乘以某个系数，两者串联实现更复杂的数值推导。

常见坑

  1. 直接对未初始化的 temp variable 做减法：若目标 var 从未被 set_temp_variable 或 add_to_temp_variable 赋过值，其初始值为 0，减法会得到负数而不是报错，导致后续逻辑静默出错，难以排查。
  2. 混淆 temp variable 与普通 variable 的作用域：temp variable 仅在当前作用域链内有效，若在 hidden_effect 或嵌套 scope 中设置后又试图在外层读取，值已不存在；此时应改用 subtract_from_variable 操作持久变量。