SiteZero

# 💣 SiteZero **SiteZero** is a tactical, round-based **bomb-defusal** game mode for your Paper server. Two teams face off: one side pushes in to plant the bomb, the other holds the sites and defuses it. Win rounds, earn money, buy a smarter loadout each round, and take the match – with a side switch at halftime to keep it fair. ## ⚔️ Features ### Matches & Rounds - Round-based matches (first to 13 round wins, sides switch at halftime) - Plant & defuse with a progress display, defuse-kit support and an interrupt when the defuser takes fire - The planted explosive stays exactly where you place it – the defenders have to find it - Halftime side switch with a fresh economy, automatic match restart from the lobby - Winner title, MVP announcement and kill/assist tracking at round end ### Gunplay - **Hitscan weapons** (no slow arrow projectiles): instant ray-traced shots with dust tracers and muzzle/impact smoke - A large arsenal across pistols, SMGs, rifles, snipers, shotguns and machine guns – each with its own damage, fire rate, range, falloff, headshot multiplier, armor penetration, magazine and **limited reserve ammo** - **Scoped weapons**: right-click (or F) to zoom; left-click to fire - Reload system with progress bar and a magazine/reserve ammo HUD - Body armor & helmet, plus flashbang, smoke and high-explosive grenades - Friendly fire toggle and enemy nametags hidden during matches ### Economy & Shop - Tactical economy: kill / plant / defuse rewards, win money and a scaling loss bonus - Clean shop GUI sorted by category and price; the defuse kit is only offered to the defending side - **Team-exclusive weapons**: each side gets its own signature guns (fully configurable per weapon) - Round survivors keep their gear into the next round – eliminated players restart with the default loadout - Pick up weapons dropped by fallen players, or top up ammo from a matching gun on the ground ### Arenas & Setup - Unlimited arenas with lobby, team/spectator spawns, two bomb sites, optional buy zones and an arena boundary - **Spawn areas**: define spawns as pos1/pos2 regions so players spawn spread out - A setup checklist command and bomb-site holograms make arena creation quick - Per-player scoreboard HUD with score, timer, money and team info ### Quality of Life - **SQLite stats** (kills, deaths, assists, K/D, wins, plants, defuses, headshots) - **Fixed or random teams** – pick a side in the lobby or let the plugin balance it - **Config merger**: plugin updates add new options automatically – your settings are never overwritten - **Update checker** (toggleable) and bStats metrics - Every item's material, **custom model data** and shoot sound is configurable – build your own resource pack. ## 🚀 Quickstart ``` /sitezero createarena warehouse /sitezero setlobby warehouse /sitezero setspawn warehouse attackers (oder: ... attackers pos1/pos2 für Spawn-Bereiche) /sitezero setspawn warehouse defenders /sitezero setspawn warehouse spectator /sitezero setsite warehouse A pos1 → pos2 /sitezero setsite warehouse B pos1 → pos2 /sitezero checklist warehouse /sitezero enablearena warehouse /sitezero join warehouse ``` ## 📋 Commands | Command | Description | |---|---| | `/sitezero join ` | Join a match | | `/sitezero leave` | Leave the current match | | `/sitezero team attackers\|defenders\|auto` | Choose your team in the lobby | | `/sitezero shop` | Open the weapon shop | | `/sitezero stats ` | View statistics | | `/sitezero start/stop <arena>` | Force-start / stop a match | | `/sitezero createarena/deletearena <name>` | Manage arenas | | `/sitezero setlobby/setspawn/setsite/setbuyzone/setboundary` | Arena setup | | `/sitezero checklist <arena>` | Setup checklist | | `/sitezero reload` | Reload configuration | ## 🔑 Permissions | Permission | Purpose | Default | |---|---|---| | `sitezero.play` | Join and play matches (join, leave, shop, stats, team) | all players | | `sitezero.setup` | Arena setup commands | op | | `sitezero.start` | Start/stop matches | op | | `sitezero.reload` | Reload configs | op | | `sitezero.admin` | All of the above + update notices | op | Regular players only need `sitezero.play`, which is granted to everyone by default. ## ⚙️ Requirements - **Paper 1.21.4** (or Paper forks like Purpur). Spigot is **not** supported – the plugin uses Paper APIs. - **Java 21** ## 📊 Telemetry SiteZero uses (https://bstats.org/plugin/bukkit/SiteZero/31946) (opt-out via `plugins/bStats/config.yml`) and can check Modrinth for updates on startup (disable with `update-checker: false`).