命令百科

effect · set_fuel_ratio

Definition

  • Supported scope:COUNTRY
  • Supported target:none

Description

Set country's current fuel ratio relative to its capacity

实战 · 配合 · 坑

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

实战用法

set_fuel_ratio 常用于事件或决议中立即调整某国的燃油储量比例，例如为玩家奖励"加油补给"或在剧本触发时模拟燃油危机。它接受一个 0 到 1 之间的小数值，直接将当前储量设置为容量的对应比例，而非增量操作。

# 事件选项：获得紧急燃油补给，将燃油比例补满至 80%
option = {
    name = my_event.1.a
    set_fuel_ratio = 0.8
}

# 决议效果：模拟燃油危机，将燃油比例压低至 10%
immediate = {
    set_fuel_ratio = 0.1
}

配合关系

  • [fuel_ratio](/wiki/trigger/fuel_ratio)：在执行 set_fuel_ratio 前先用此触发器检查当前燃油比例，确保只在燃油不足时才触发补给奖励，避免浪费。
  • [add_fuel](/wiki/effect/add_fuel)：两者互补——set_fuel_ratio 是绝对赋值，add_fuel 是相对增量；需要精确设定目标比例时用前者，需要动态加减时用后者。
  • [add_dynamic_modifier](/wiki/effect/add_dynamic_modifier)：燃油比例调整后，可同步附加一个动态修正来模拟燃油充足/短缺对作战效率的持续影响，形成完整的逻辑链。
  • [country_event](/wiki/effect/country_event)：调整燃油比例后触发后续事件，向玩家通知状态变化或推进剧情分支。

常见坑

  1. 把值写成百分比整数：新手常写 set_fuel_ratio = 80 而非 set_fuel_ratio = 0.8，游戏不会报错但会直接将燃油比例钳制到上限（1.0），导致效果与预期完全不符，难以察觉。
  2. 误用在 STATE 或 CHARACTER scope 下：该命令只在 COUNTRY scope 中有效，若在 owned_state 或单位领袖的 scope 块内调用，效果会静默失效而不给出任何错误提示，调试时极易遗漏。