💣 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 [arena] | 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 [player] | 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 bStats (opt-out via plugins/bStats/config.yml) and can check Modrinth for updates on startup (disable with update-checker: false).