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> ` | 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