Getting Started

Install SoapsArena 1.0.1 and confirm it loads.

Requirements

Requirement	Details
Plugins	SoapsCommon 2.0.x
Server	Paper 26.1, 26.2, and 26.3
Spigot	Not supported
Folia	Not supported
Java	21+ (Java 25 recommended)

Downloads are ZIPs. Extract the .jar into plugins/. Soft deps: Integrations.

Installation

1. Download SoapsCommon and SoapsArena; extract both jars.
2. Put jars in plugins/ and fully restart (not /reload).
3. Confirm both plugins are green and plugins/SoapsArena/ exists.
4. Give yourself soapsarena.admin (default: op). Players have soapsarena.play by default.

Symptom	Fix
Red plugin, no data folder	JAR still inside a ZIP, or SoapsCommon missing
SoapsCommon green, Arena red	Check logs/latest.log for Arena / SoapsCommon errors

First-run files

plugins/SoapsArena/
  config.yml
  messages.yml
  gui.yml

Full defaults: Config Reference

Admin path

1. /sar kit save <name> — save a kit from your inventory
2. /sar wand create <name> — set bounds, spawns, exit, Room Settings
3. Save on the hotbar (or /sar wand done), then /sar enable <name>
4. YAML — queue timers, WorldEdit, sounds in config.yml
5. /sar reload — after YAML edits (in-game; player-only)

Prefer the wand for room options; YAML for global queue and soft-hook toggles.

Reload policy

Change	What to run
Wand / Room Settings save	Applies when you save the room
YAML file edits (config.yml, messages.yml, gui.yml)	/sar reload in-game
Jar upgrade / first install	Full server restart (not /reload)

/sar (including reload) is player-only. Console cannot run /sar reload.

Verify

Check	Passes when
Plugin enables	Green in /plugins; plugins/SoapsArena/ exists
Help	/sar help lists commands
List	/sar list shows rooms (empty until you create one)
Hub	/sar menu opens when GUIs are enabled
Solo loop	/sar forcejoin <room> runs prepare → fight for testing

/sar help
/sar list
/sar menu

Common goals

Goal	Page
First arena	Want first arena
Kits	Want kits
Own gear	Want own gear
Destructible	Want destructible
Win rewards	Want win rewards

Next: Arena Creation · Configuration · Upgrading to 1.0.1