Introduction

SoapsArena runs 1v1 kit fights on Paper 26.2. Players queue or duel without camping in an arena lobby.

Core concepts

Term	Meaning
Room	A saved arena (bounds, spawns, exit, kit, settings)
Queue	Per-room FIFO; players stay in the world until matched
Prepare	Warning countdown before teleport (default 30s)
Match	Prepare → countdown → fight → ending → restore
Kit	Inventory loadout applied for every fight
Wand	Admin creative editor for creating and editing rooms
Duel	Direct challenge; same fight engine as public queue

What players do

1. /sar join <room>, /sar quickjoin, /sar menu, or /sar duel <player>.
2. Keep playing while queued.
3. Get a prepare warning when a match is ready.
4. Teleport in, short countdown, then fight.
5. Winner is last standing (or most kills on time-up). Inventory is restored afterward.

What admins do

1. Save kits with /sar kit save <name>.
2. /sar wand create <name> and set bounds, spawns, exit, kit, and options.
3. Save from the hotbar (or /sar wand done), then /sar enable <name>.
4. Optional: /sar setlobby, WorldEdit for destructible rooms, rewards in config.
5. Tune config.yml and /sar reload.

Plugin files

plugins/SoapsArena/
  config.yml
  messages.yml
  gui.yml
  rooms/
  kits/
  data/
  schematics/
  data/wand-sessions/

Rooms and kits are YAML under rooms/ and kits/. Wand crash progress is stored under data/wand-sessions/ and resumes on rejoin.