effect · add_fuel

Hands-On Usage

add_fuel is commonly used in war events, national focus completion rewards, or special decisions to quickly replenish fuel reserves for the player or AI nations, alleviating logistical pressure. For example, when a "Strategic Oil Reserve" focus is completed, granting a fuel reward:

focus = {
    id = strategic_oil_reserve
    ...
    completion_reward = {
        add_fuel = 500
    }
}

Synergy

• [fuel_ratio](/wiki/trigger/fuel_ratio): Check in trigger conditions whether the current fuel ratio falls below a threshold; only replenish via add_fuel when below threshold to avoid meaningless overflow additions.
• [add_resource](/wiki/effect/add_resource): Both frequently appear together in resource/logistics-focused national focuses or events. The former provides instant fuel while the latter increases long-term resource production in states, creating a pairing of short-term and long-term supply.
• [add_ideas](/wiki/effect/add_ideas): Pair with ideas that add fuel consumption modifiers. Granting oil in one go while reducing subsequent consumption creates more lasting effects.
• [country_event](/wiki/effect/country_event): Branch decision-making through subsequent events, allowing players to decide whether to consume fuel in exchange for other benefits, adding narrative interactivity.

Common Pitfalls

1. Forgetting scope restrictions: add_fuel can only be executed within COUNTRY scope. If accidentally written in STATE scope (such as inside every_owned_state), it will cause script errors or silent failures. Always ensure the outer scope is a country.
2. Confusion between positive and negative values: While passing negative values theoretically allows fuel deduction, actual behavior may not meet expectations due to underlying clamping logic. Fuel deduction requires thorough testing and should not be assumed to behave identically to negative values in commands like add_manpower.