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
ranked.enabled	false	Ranked rating system (foundation)
ranked.k-factor	32	Elo K-factor for 1v1 when ranked is on
modes.ffa.multiplayer-enabled	true	Allow FFA join on rooms with max players > 2

---

defaults

Key	Default	Description
countdown	10	Pre-game countdown (seconds)
max-players	8	Max players per room
min-players	2	Min players to start countdown
destructible	false	Allow block breaking in arena
inventory-mode	KIT	KIT, OWN_KEEP, or OWN_LOSE
time-limit	0	Match limit in seconds (0 = none)
fall-damage	true	Fall damage in arenas
hunger-drain	false	Hunger drain in arenas

---

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
lobby-particle-color	#55FFFF	Lobby selection color
wand-range	100	Block raycast range

---

duel

Key	Default	Description
request-timeout	30	Duel request expiry (seconds)
wagers.enabled	false	Vault wagers
wagers.max-amount	10000	Max wager amount

---

game

Key	Default	Description
teleport-on-death	true	TP to exit on death
allow-spectate	false	Spectate after elimination
end-delay	5	Cleanup delay after game ends (seconds)
scoreboard	true	Sidebar during games

---

sounds

Key	Default
enabled	true
countdown-tick	BLOCK_NOTE_BLOCK_PLING
game-start	ENTITY_ENDER_DRAGON_GROWL
kill	ENTITY_EXPERIENCE_ORB_PICKUP
elimination	ENTITY_WITHER_HURT
win	UI_TOAST_CHALLENGE_COMPLETE
streak	ENTITY_PLAYER_LEVELUP

Set sounds.enabled: false to mute all.

---

rewards

Key	Default	Description
enabled	false	Run win commands globally
commands	eco give {player} 100	Console commands; {player} placeholder

Per-room rewards override via /sar arena set <room> rewards <cmds>.

---

lobby

Set with /sar setlobby. Stored in config when saved.

Key	Default
enabled	false
world	world
x/y/z	0.0 / 64.0 / 0.0
yaw/pitch	0.0 / 0.0