effect · set_fuel

Hands-On Usage

set_fuel is used to directly set a country's fuel stockpile to a specified value within events or decisions, commonly found in narrative mods to simulate supply depletion at war's outset or emergency strategic reserve replenishment after a specific national focus is triggered. For example, in an event representing "allied emergency aid," fuel can be immediately raised to a fixed level:

country_event = {
    id = my_mod.10
    option = {
        name = my_mod.10.a
        # Emergency aid, directly set fuel to fixed value
        set_fuel = 1000
    }
}

Synergy

• [add_fuel](/wiki/effect/add_fuel): The two complement each other; set_fuel enforces an absolute value while add_fuel adjusts relative quantities. Narrative scripts often zero out with set_fuel then replenish proportionally with add_fuel, or vice versa.
• [fuel_ratio](/wiki/trigger/fuel_ratio): Detects the current fuel ratio as a trigger condition, pairing with set_fuel to form a closed logic loop of "if fuel drops below threshold, force replenishment."
• [add_dynamic_modifier](/wiki/effect/add_dynamic_modifier): Attach dynamic modifiers after setting fuel (such as raising fuel cap or consumption rate) to create more complete integration between value changes and game mechanics.

Common Pitfalls

1. Misuse outside COUNTRY scope: set_fuel only supports COUNTRY scope; if written under STATE or CHARACTER scopes, the script will silently fail or error. Always confirm the execution block's target is a country.
2. Confusing absolute values with ratios: set_fuel accepts absolute fuel amounts rather than ratios. Beginners sometimes mistakenly input 0.5 expecting half-full, which actually sets a negligible amount of fuel. If proportional adjustment based on capacity is needed, first use [fuel_ratio](/wiki/trigger/fuel_ratio) or related variables to convert, then pass the calculated value.