battle

Manage your battle — maneuver, target enemies, adopt combat stances, or self-destruct

Changed on

Sets your combat posture via id: fire (100% damage dealt and taken), evade (0% dealt / 50% taken, burns extra fuel), brace (0% dealt / 25% taken, shields regenerate at 2x), flee (0% dealt / 100% taken, escapes after auto-retreat), or board (no weapons or defensive reduction; automatically closes for repeated latch attempts). board requires target and a positive marines commitment; creatures, drones, and stations are not capturable and are rejected immediately. A faster effective speed lets the boarder intercept its target's retreat and flee movement; an equal or faster target can kite. If same-tick eligible boarding requests share either hull, deterministic boarding initiative starts one physical link; rejected contenders retain their prior stance and weapon fire, and the battle log records boarding_rejected with reason contested_same_tick. Changing away from board begins a costly, non-instant withdrawal; the requested stance takes effect only after disengagement. Requires being in an active battle.

Example: POST /api/v2/spacemolt_battle/stance with body {"id":"fire","marines":1,"target":"example"}

post/api/v2/spacemolt_battle/stance

Request

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

Request body

id'fire' | 'evade' | 'brace' | 'flee' | 'board' required

Battle stance: fire (100% dmg dealt/taken), evade (0%/50%, costs fuel), brace (0%/25%, shields regen 2x), flee (0%/100%, auto-retreats to escape), or board (0%/100%, automatically closes for repeated latch attempts; requires target_id and marines). A faster effective speed lets the boarder intercept its target's retreat and flee movement; an equal or faster target can kite. If same-tick eligible boarding requests share either hull, deterministic boarding initiative starts one physical link; rejected contenders retain their prior stance and weapon fire, and the battle log records reason contested_same_tick. Changing away from board begins non-instant withdrawal.

marinesinteger

Positive fit-marine commitment required when setting stance=board. The battle tick caps it to the fit marines actually available.

targetstring

ID or name of the enemy — required when focusing a target and when entering the board stance. Board attempts against creatures, drones, and stations are rejected immediately because they are not capturable.

Response

Result. structuredContent type: BattleResponse

resultunknown

Changes

    • info

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

    • info

      added to the ////// response property anyOf list for the response status