Wiki

effect · send_equipment

Definition

  • Supported scope:COUNTRY
  • Supported target:THIS, ROOT, PREV, FROM, OWNER, CONTROLLER, OCCUPIED, CAPITAL

Description

Sends to target scope specified amount of equipment.

Hands-On Notes

Hands-on notes are AI-generated and checked against the vanilla command vocabulary — treat them as a starting point, not authoritative reference. The definition above is the game's own documentation.

Hands-On Usage

send_equipment is commonly used in alliance aid, puppet support, or scripted events to transfer equipment to allied nations. For example, in decisions or national events, it allows the player or AI to transfer rifles, tanks, and other equipment to a target nation. A typical scenario is the "Military Aid" series of decisions—when the player chooses to support a minor nation, this effect is triggered, directly deducting equipment from the sender's stockpile and adding it to the recipient's.

# In a national event option, send equipment to FROM (the event initiator)
option = {
    name = my_event.1.a
    FROM = {
        send_equipment = {
            equipment = infantry_equipment_1
            amount = 500
            sender = ROOT
        }
    }
}

Synergy

  • [has_army_manpower](/wiki/trigger/has_army_manpower): Check whether the target nation has sufficient manpower to utilize the equipment before sending, avoiding wasted aid.
  • [add_equipment_to_stockpile](/wiki/effect/add_equipment_to_stockpile): These can be combined—send_equipment handles cross-border transfers, while add_equipment_to_stockpile directly adds equipment to a nation's own stockpile from nothing. Use them at opposite ends of an aid chain.
  • [add_manpower](/wiki/effect/add_manpower): Equipment transfers often pair with manpower or reinforcement shipments to create a complete "military aid package" effect.
  • [country_event](/wiki/effect/country_event): Trigger a follow-up event after sending equipment to notify the sender or receiver that aid has arrived, creating a complete narrative closure.

Common Pitfalls

  1. Failing to verify sender's stockpile: send_equipment deducts equipment directly from the sender nation's actual stockpile. If stockpile is insufficient, the actual amount sent will be less than specified, and the script will not error but silently fall short. It is recommended to combine with triggers like [has_army_manpower](/wiki/trigger/has_army_manpower) or design with buffer margins.
  2. Confusing scope and target: This effect must be written within the recipient's scope (i.e., "whoever receives the equipment gets it in their scope"). The sender field specifies which nation's stockpile is deducted. Beginners often write the entire block in the sender's scope but forget to switch scopes, causing the equipment to be sent from the sender to themselves.