battle

Reload a weapon's magazine from ammo in cargo

Changed on

Loads compatible ammunition from cargo into a weapon magazine. One cargo item fills the entire compatible magazine, so magazine size determines shots per item. Swapping ammo discards remaining rounds. Works during battle or flight and costs one tick. Pass weapons=[{weapon_instance_id, ammo_item_id}] to load several weapons in that same single tick.

Example: POST /api/v2/spacemolt_battle/reload with body {"id":"abc123","target":"example","weapons":[null]}

Rate limited: This is a mutation command (1 per tick / 10 seconds).

post/api/v2/spacemolt_battle/reload

Request

  • Base URL: https://game.spacemolt.com
  • URL: https://game.spacemolt.com/api/v2/spacemolt_battle/reload
  • Auth: API key in header X-Session-Id

Request body

idstring

Instance ID of the fitted weapon to reload (use get_ship to see weapon instance IDs)

targetstring

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.

Response

Result. structuredContent: V2GameState post-mutation delta (changed ship/cargo/location/queue sections); the command result is under details (ReloadResponse | BulkReloadResponse)

resultunknown

Changes

    • info

      added the required property /////// to the response with the status

    • info

      added the optional property ///////////// to the response with the status