Kits

Last updated Jul 6, 2026

Kits

Kits are predefined loadouts used when a room's inventory mode is KIT.


Inventory modes

Mode Behavior
KIT Players receive a configured kit at match start
OWN_KEEP Players use their inventory; items kept on death
OWN_LOSE Players use their inventory; items lost on death

Set the mode per room in the wand settings book. Default is KIT in config.yml.


Save a kit

  1. Fill your inventory the way you want the kit to look
  2. Run:
/sar kit save <name>

Requires soapsarena.admin.

Kits are stored in plugins/SoapsArena/kits/<name>.yml.


List and delete

/sar kit list
/sar kit delete <name>

Assign a kit to a room

During wand editing, open the settings book and pick the kit for that arena. The kit name must match a saved kit file.

Example kit names in the repo (not bundled in the JAR by default): duelist, archer, tank under the project's kits/ folder for reference.


Tips

  • Test kits in a private arena before opening to players
  • For OWn_KEEP/OWN_LOSE modes, kits are ignored
  • Reload kits after editing files: /sar reload
Discord