SIXsBoom

---

⚠️ This plugin is currently in active development. Some features may be incomplete or subject to change. Feel free to report any bugs or feedback on the Discord server!

---

SIXsBoom is a PvE arena minigame for Bukkit, Spigot, and Paper servers. Players survive waves of increasingly dangerous creepers — last one standing wins. Every aspect of the game is configurable, from creeper types to wave sequences to arena shapes.

---

✨ Features

• 🎮 PvE survival arena — waves of creepers spawn each round; last player alive wins
• 💥 17 built-in creeper types — Base, Fast, Turbo, Sonic, Armored, Tank, Mega Boom, Charged, Thunder, Nuke, Invisible, Phantom, Ghost Fast, Ninja, Berserker, Mini Boss, Thunder King
• 🧩 Custom creeper types — add any new creeper by dropping a YAML file in creepers/
• 🌊 Dual wave system — automatic scaling waves or fully custom sequences loaded from waves/
• 🗺️ Multi-arena support — configure and run multiple arenas simultaneously
• 🔵 Cuboid & Circle arena shapes — set boundaries, height limits, and center+radius for circular arenas
• ⚠️ Out-of-bounds elimination — players leaving the arena are warned or instantly eliminated (configurable)
• 🖥️ In-game setup GUI — /boom gui to pick arena, configure lives, players, and wave mode with one click
• ❤️ Multi-life system — give players more than one life before spectator mode kicks in
• 🎯 Arena protection — no block break, no PvP, no hunger loss during games
• 🏆 Custom win commands — run any console command when a player wins
• ✨ Particle bounds visualizer — preview arena boundaries in-game
• 🔄 Live reload — /boom reload applies all config changes without restart
• 🔔 Modrinth update checker — async, non-blocking, notifies admins on join

---

📦 Requirements

• Minecraft: 1.21.x (Paper, Spigot, Bukkit and major forks)
• Java: 21+
• Optional: PlaceholderAPI

---

🛠️ Commands

Command	Description
/boom join <arena>	Join an arena lobby
/boom leave	Leave your current arena
/boom list	List all arenas and their status
/boom spectate <arena>	Spectate an active game
/boom gui	Open the game setup GUI (admin)
/boom start <arena> [waveFile]	Start a game manually (admin)
/boom stop <arena>	Force-stop an active game (admin)
/boom wave list	List available wave files (admin)
/boom reload	Reload all configuration files (admin)
/boom info	Show plugin status and loaded data (admin)
/boom arena create <name>	Create a new arena
/boom arena delete <name>	Delete an arena
/boom arena list	List all arenas with details
/boom arena info <name>	Show full arena configuration
/boom arena enable/disable <name>	Enable or disable an arena
/boom arena setlobby <name>	Set the lobby point to your position
/boom arena addspawn <name>	Add a player spawn at your position
/boom arena clearspawns <name>	Remove all player spawns
/boom arena addcreeperspawn <name>	Add a creeper spawn at your position
/boom arena clearcreeperspawns <name>	Remove all creeper spawns
/boom arena setshape <name> <CUBOID|CIRCLE>	Set arena shape
/boom arena setpos1/setpos2 <name>	Set cuboid corners
/boom arena setcenter <name>	Set circle center
/boom arena setradius <name> <value>	Set circle radius
/boom arena setheight <name> <min> <max>	Set height bounds
/boom arena set <name> <key> <value>	Set any arena property
/boom arena visualize <name>	Preview arena bounds with particles

---

🔐 Permissions

Permission	Description	Default
sixsboom.join	Join an arena	true
sixsboom.leave	Leave an arena	true
sixsboom.list	List arenas	true
sixsboom.spectate	Spectate a game	true
sixsboom.admin.reload	Reload the plugin	op
sixsboom.admin.info	View plugin status	op
sixsboom.admin.arena	Manage arenas	op
sixsboom.admin.start	Start games manually	op
sixsboom.admin.stop	Stop games forcefully	op
sixsboom.admin.wave	List wave files	op
sixsboom.admin.gui	Open setup GUI	op
sixsboom.admin.notify	Receive update notifications	op
sixsboom.group.admin	All admin permissions	op

---

⚙️ Configuration

Everything is configurable without touching code:

• config.yml — game defaults (lives, player counts, countdown, end delay), out-of-bounds behaviour and timing, wave delay and auto-wave scaling, particle visualizer settings, update checker
• messages.yml — every message, title, action bar, prefix and colour, fully supports & codes, &#RRGGBB hex, MiniMessage, and {placeholders}
• arenas.yml — all arena definitions (auto-managed via commands, no manual editing needed)
• creepers/*.yml — one file per creeper type; add new types by creating new files
• waves/*.yml — one file per wave sequence; loaded automatically on startup or reload

---

🐛 Bug Reports & Support

Got a bug? A question? Just want to know what's coming next? The Discord server is the place to be — support tickets, changelogs, announcements and more, all in one place.

👉 Join the Discord

---

Made by SIXs — built for 1.21+