Player Guide

Player how-to

1. /sar list or /sar menu to find an enabled arena.
2. /sar join <name> or /sar quickjoin (or /sar join with no name).
3. Keep playing in the world until the prepare warning.
4. If kits are ON, pick a kit in the GUI (/sar kits to reopen) before teleport.
5. Fight; /sar leave forfeits or cancels prepare/queue.
6. Optional: /sar duel <player> [room], then accept/decline; /sar stats and /sar top.

You need soapsarena.play (default: true).

Staff how-to

1. Build and save rooms with /sar wand (see Arena Creation).
2. /sar enable <room> after setup validates (rooms save disabled).
3. Save kits with /sar kit save <name> when rooms use kits ON.
4. Test solo with /sar forcejoin <room> (soapsarena.admin).
5. /sar disable <room> or clear queues before editing a busy room.
6. /sar reload after config / messages / gui edits.

Join a fight

GUI: /sar menu then pick an arena or use quick join.

Commands:

Command	What it does
/sar join <name>	Queue for a specific arena
/sar quickjoin	Queue for the best available arena
/sar join	Same as quickjoin
/sar list	Arenas, queue sizes, and status
/sar leave	Leave queue, cancel prepare, or forfeit

While queued you keep playing in the world. When a match is ready you get a prepare warning, then teleport into the fight.

If the room has kits ON, a kit GUI opens during prepare (/sar kits to reopen). If kits are OFF, you fight with your own gear.

Queue timing (config)

Key	Default	Effect
queue.prepare-seconds	30	Warning before teleport into the arena
queue.prepare-cancel-on-death	true	Cancel the match if a participant dies during prepare
queue.quickjoin-prefer-waiting	true	Prefer rooms that already have someone waiting

---

Game flow

1. Queue. Waiting in the world (not parked in an arena lobby)
2. Prepare. Warning countdown (default 30 seconds)
3. Countdown. Short in-arena timer on spawn (players stay frozen until fight start)
4. Active. 1v1; last player standing wins
5. Ending. Winner announced, rewards, restore, optional map reset

Leaving during prepare cancels the match without a loss. A sidebar scoreboard shows during matches when enabled in config.

---

Duels

/sar duel <player>
/sar duel <player> <room>

Omit the room to pick a random free arena (enabled, idle, nobody queued).

/sar duel accept
/sar duel decline

Requests expire after duel.request-timeout seconds (default 30).

---

Stats and leaderboards

Command	What it does
/sar stats	Your stats (GUI if enabled, otherwise chat)
/sar top	Top 10 kills
/sar top wins	Top 10 game wins
/sar top streak	Top 10 best win streaks

---

In-game rules

• During countdown and fight, only /sar works unless you are an admin (prepare allows normal commands)
• Kits: if the room has kits enabled you pick one in prepare; otherwise you keep your inventory
• On death you teleport to the exit if game.teleport-on-death is true
• Soft death / back / vanish behavior: Match Soft Hooks

Defaults: Default config.yml · Commands: Commands and Permissions