Introduction

What is SoapsArena?

SoapsArena adds PvP arenas to your Paper server. You mark out arena bounds with a wand, set lobby and spawn points, then let players join FFA matches or challenge each other to duels.

Games run through clear phases: waiting for players, countdown, active fight, then cleanup. Stats, leaderboards, and GUIs are built in.

---

Main features

• Wand editor for arena bounds, lobby, spawns, and exit
• FFA rooms with configurable player counts
• 1v1 duels with optional Vault wagers
• Kit system or bring-your-own inventory modes
• WorldEdit schematics for destructible arenas that reset after each match
• In-game menus for browsing arenas and viewing stats
• PlaceholderAPI for scoreboards and chat
• Optional SoapsQuest hooks after matches end

---

Requirements

Plugin	Required?
Paper 1.21+	Yes
SoapsCommon	Yes
Java 21	Yes
WorldEdit or FAWE	Optional (schematic save/restore)
Vault + economy	Optional (wagers and money rewards)
PlaceholderAPI	Optional

---

Commands at a glance

All commands use /sar or /soapsarena. Players need soapsarena.play. Arena setup needs soapsarena.admin.

See Commands and Permissions for the full list.

---

Data folders

After first run:

plugins/SoapsArena/
  config.yml
  messages.yml
  gui.yml
  rooms/          One YAML per arena
  kits/           Saved kit loadouts
  data/           Per-player stats
  schematics/     WorldEdit schematics per room