Configuration

Main file: plugins/SoapsArena/config.yml

---

gui

Key	Default	Description
enabled	true	Master switch for inventory menus

---

integrations.soapsquest

Key	Default	Description
enabled	false	Run console commands after each match
match-end-commands	[]	Commands with {room}, {winner}, {participants}, {duel}, {player}, {uuid}

---

features

Key	Default	Description
stats.enabled	true	Track match stats
stats.gui-enabled	true	/sar stats opens GUI when suite GUI is on

---

queue

Key	Default	Description
prepare-seconds	30	Warning before teleport into the arena
prepare-cancel-on-death	true	Cancel match if a player dies during prepare
quickjoin-prefer-waiting	true	Prefer rooms that already have someone queued

---

defaults

Key	Default	Description
countdown	5	In-arena countdown after teleport (seconds)
destructible	false	Allow block breaking in arena
time-limit	0	Match limit in seconds (0 = none)
fall-damage	true	Fall damage in arenas
hunger-drain	false	Hunger drain in arenas

Matches are always 1v1 with kits.

---

worldedit

Key	Default	Description
enabled	true	Use WE/FAWE when installed
auto-save	true	Save schematic before game
auto-restore	true	Restore schematic after game

---

wand

Key	Default	Description
particle-interval	10	Ticks between particle updates
particle-density	0.5	Edge particle spacing
arena-particle-color	#FF6B35	Arena selection color
wand-range	100	Block raycast range

---

duel

Key	Default	Description
request-timeout	30	Duel request expiry (seconds)

---

game

Key	Default	Description
teleport-on-death	true	Send eliminated players to exit spawn
end-delay	5	Seconds before cleanup after a win
scoreboard	true	Sidebar during matches

---

sounds

Key	Default	Description
enabled	true	Play match sounds
countdown-tick	BLOCK_NOTE_BLOCK_PLING	Countdown tick
game-start	ENTITY_ENDER_DRAGON_GROWL	Fight start
kill	ENTITY_EXPERIENCE_ORB_PICKUP	Kill confirm
elimination	ENTITY_WITHER_HURT	Elimination
win	UI_TOAST_CHALLENGE_COMPLETE	Win

---

rewards

Key	Default	Description
enabled	false	Run console commands on win
commands	eco give {player} 100 example	{player} = winner name

See Economy and Rewards.

---

lobby

Optional global return spawn used after matches when enabled. Set in-game with /sar setlobby. This is not an in-arena waiting lobby.

Key	Default	Description
enabled	false	Use this location as return spawn
world / x / y / z / yaw / pitch	—	Coordinates

Full YAML: Default Config Files.