💣 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).