Kits
Last updated Oct 28, 2026
Kits
Rooms can run with kits ON or kits OFF. Toggle in wand Room Settings (hotbar slot 3).
| Mode | Default for new rooms | Behavior |
|---|---|---|
| ON | default (kits-enabled: true on new arenas) |
During prepare, players pick a kit from a GUI (/sar kits to reopen). Applied when the fight starts. |
| OFF | Toggle off in Room Settings | Players keep their own gear. Inventory is still restored after the match. |
Kits are stored as YAML under plugins/SoapsArena/kits/.
Default kits
On first load, if missing, the plugin generates:
| File | Kit name |
|---|---|
duelist.yml |
Duelist |
archer.yml |
Archer |
tank.yml |
Tank |
Player how-to
- Join a room that has kits ON.
- During prepare, open the kit GUI (auto-opens;
/sar kitsto reopen). - Or
/sar pickkit <name>by name. /sar kit preview <name>to inspect items anytime (does not select).
Staff how-to
- Put the loadout in your inventory (armor and off-hand included).
/sar kit save <name>(soapsarena.admin)./sar kit listto verify;/sar kit delete <name>to remove.- In wand Room Settings, turn kits ON (save fails if ON with zero kits on the server).
Commands
| Command | Who | Description |
|---|---|---|
/sar kit preview <name> |
play | View kit items in a GUI (custom items supported) |
/sar kit save <name> |
admin | Save your current inventory as a kit |
/sar kit list |
admin | List kits |
/sar kit delete <name> |
admin | Delete a kit |
/sar kits |
play | Open kit picker during prepare |
/sar pickkit <name> |
play | Pick a kit by name during prepare |
Notes
- Kits ON requires at least one saved kit on the server.
- If a player never picks before teleport, a kit is auto-selected.
- If GUIs are disabled, prepare shows clickable chat kit links instead.
Intent: Want kits · Want own gear · Config Reference
Still stuck? Ask about this page