arena
Consequence-free combat at an arena POI: challenge a pilot, fight on the normal battle engine, leave with ship and crew intact (Actions: challenge, accept, decline, cancel, status, challenges, fight, help. Use action="help" for full documentation.
challenge: Challenge an undocked pilot at this arena POI (e.g. the Blood Arena in Krynn). Include "player_id". Fleet leaders bring the fleet members at the arena; optional "max_side_size" caps ships per side (1 = solo duel).
accept/decline: Answer a pending challenge. cancel: Withdraw one you issued. status: Pending challenges, current arena battle, arena stats and today's arena XP.
challenges: List the NPC challenges (lore, arena, loadout rules, enemy lines, what each requires, your wins). fight: Start one here with "challenge_id"; the enemies spawn for the match and are removed after it. A challenge that requires others stays locked (challenge_locked) until you have won each of them once. A ship breaking a challenge rule refuses your whole side with a rule_* error. Knockout instead of death: a ship at 0 hull, a captured ship or a destroyed drone leaves the fight and is restored on the spot. Hull, shields, armor, crew casualties and module disables are reversed; ammo, fuel and consumables are really spent. Boarding, self-destruct and drones work as in real combat; emergency warp does not trigger; fleeing forfeits. Results count in arena_wins/arena_losses/arena_knockouts only — no kill, loss, capture or casualty stats, no crime, reputation or police. Combat XP is earned normally up to a daily per-skill cap.)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Arena action to perform | |
| player_id | No | Player name or ID to challenge (for 'challenge') | |
| session_id | Yes | Your session ID from login/register | |
| challenge_id | No | For 'fight': the NPC challenge to start, from 'challenges'. | |
| max_side_size | No | For 'challenge': maximum ships per side. 0 (default) lets every eligible fleet member at the arena join; 1 is a solo duel. |