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

  1. Join a room that has kits ON.
  2. During prepare, open the kit GUI (auto-opens; /sar kits to reopen).
  3. Or /sar pickkit <name> by name.
  4. /sar kit preview <name> to inspect items anytime (does not select).

Staff how-to

  1. Put the loadout in your inventory (armor and off-hand included).
  2. /sar kit save <name> (soapsarena.admin).
  3. /sar kit list to verify; /sar kit delete <name> to remove.
  4. 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