effect · supply_units

Hands-On Usage

supply_units is commonly used in event or decision reward scenarios, such as immediately replenishing supply hours to a commander's forces after completing a special mission, simulating the effect of logistics support or strategic resources arriving. It is also suitable for designing "emergency supply" type national focuses or espionage operations in mods, allowing players to gain a buffer by triggering events when supply lines are cut off.

# In event option: a commander receives emergency supply support
option = {
    name = my_event.1.a
    trigger = { is_corps_commander = yes }
    supply_units = 48  # Replenish 48 hours of supply
}

Synergy

• [is_leading_army](/wiki/trigger/is_leading_army): Confirm in trigger conditions that the character is currently commanding an army, ensuring the supply effect has practical significance and avoiding ineffective triggers on commanders without troops.
• [add_temporary_buff_to_units](/wiki/effect/add_temporary_buff_to_units): Distribute simultaneously with temporary combat bonuses, simulating a combined reward of "supplies arrive + morale boost", enhancing narrative impact of events.
• [add_timed_unit_leader_trait](/wiki/effect/add_timed_unit_leader_trait): Pair with time-limited traits (such as logistics expert), forming a complete "supply enhancement" reward package together with the supply effect.
• [num_units](/wiki/trigger/num_units): Conditionally judge the number of units under command, determining whether it is worthwhile to trigger the supply effect, avoiding wasted script logic when a commander has no troops to lead.

Common Pitfalls

1. Scope Error: supply_units must be executed within a CHARACTER scope. If written directly in a country-level effect block without properly limiting scope through characters = { ... } or the event protagonist, the command will be silently ignored by the game or cause errors. Beginners often mistakenly believe the effect worked as a result.
2. Unit Value Confusion: The parameter unit is hours rather than days. Setting 7 only amounts to approximately 7 hours of supply, not 7 days. If testing reveals supply quantity is "suspiciously low", it is often because forgetting to convert days to hours (×24).