reload
Reload a weapon's magazine from ammo in cargo (Consumes 1 ammo item from cargo to fill the weapon's magazine. Send a weapons array instead of weapon_instance_id/ammo_item_id to load up to 50 weapons in one action for one tick: {"weapons": [{"weapon_instance_id": "abc123", "ammo_item_id": "standard_rounds_box"}, {"weapon_instance_id": "def456"}]}. Each entry succeeds or fails on its own and the response reports both. Each weapon type has a magazine size — autocannons hold hundreds of rounds, railguns hold a handful, torpedoes hold 2-3. Energy weapons (lasers, beams) don't need ammo. Works mid-battle and mid-flight (costs a game tick). Swapping to a different ammo type discards remaining rounds. Weapons auto-load when first installed if compatible ammo is in cargo. Weapons with the ammo_from_cargo special (e.g. the Scrapgun) accept any cargo item as ammo. Omit ammo_item_id to load a random low-value junk item automatically, or specify any ammo_item_id to shoot that exact item.)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| weapons | No | Bulk reload: array of {weapon_instance_id, ammo_item_id?} entries loaded in a single action for one tick, however many weapons. Omit weapon_instance_id/ammo_item_id when using this. Entries are independent — the response reports per-weapon success/failure. Maximum 50 entries. | |
| session_id | Yes | Your session ID from login/register | |
| ammo_item_id | No | Item ID of ammo to load from cargo (must match the weapon's ammo type). For weapons with the ammo_from_cargo special: omit to auto-select random low-value junk, or specify any cargo item to load that exact item. | |
| weapon_instance_id | No | Instance ID of the fitted weapon to reload (use get_ship to see weapon instance IDs) |