Comparator 1.0.0

First public release. Comparator rolls a stack of event and minigame systems into one plugin, so you don't have to run a dozen separate ones to put on a match. Built for Paper/Folia 1.21 on Java 21, and it runs properly on Folia's region threads (no global scheduler calls anywhere).

How it works

Your event runs through a five-stage state machine: lobby, pre-game, in-game, paused, and post-game. PvP, stat tracking, and the live event systems turn on and off automatically depending on the stage, and starting or ending a game fires reward triggers for you.

State	PvP	Stats	Event systems
Lobby	no	no	no
Pre-game	no	no	yes
In-game	yes	yes	yes
Paused	no	no	yes
Post-game	no	yes	no

What's in it

Events and teams - create, start, pause, resume, and stop events. Manage teams with display names and live membership, plus per-player profiles. A default event is set up for you on startup.

Hearts (lifesteal) — active and banked heart balances that actually change max health, a configurable steal-per-kill, and player-to-player transfers.

Combat and objectives — eliminations and revives with logged reasons, safe and no-build zones, and KOTH-style capture scoring. Capsule spawning samples the terrain in the background to spread players across the map, avoid water, and keep everyone spaced out.

Tournaments — single-elimination and round-robin brackets with seeding, result reporting, and live standings, all hooked into the dashboard and scoreboard.

Stats and rewards — async, batched tracking for 11 stats (kills, deaths, damage dealt and taken, healing, blocks placed and broken, items crafted, distance, captures, rewards earned) with leaderboards. Rewards are defined in rewards.yml and can run commands, give items, change health, or show titles on state changes.

Interfaces — a 7-page dashboard GUI, a state-aware sidebar scoreboard, and a lightweight web dashboard that's token-gated and runs on the built-in JDK HTTP server (no extra dependencies).

Storage and integrations — async batched SQLite for stats, audit log, and analytics, a PlaceholderAPI expansion, and bStats metrics.

There's also a public API so other plugins can soft-depend on Comparator, and /comparator reload reloads config and services without a restart.

World events

Six built-in events you can trigger live or from the dashboard:

ID	Effect
supply-drop	Drops contested loot for players to fight over
blood-moon	Forces night and opens a combat window
border-collapse	Shrinks the border to force late-game fights
meteor-storm	Rains explosive impacts across the arena
sudden-death	Shrinks the border to a small radius over 30s
resource-rush	Time-boxed resource surge

Commands

Everything runs under /comparator (alias /cmp), and all of it supports tab-completion for player names, enums, and live IDs.

Command	What it does
status	Overview: state, active event, teams, zones, tournaments, persistence
reload	Reload config and reloadable services
dashboard	Open the GUI
event <create|start|pause|resume|stop|list>	Manage the event lifecycle
state <state>	Force a state transition
team <create|join|leave|list>	Manage teams and assignments
capsule <plan|dispatch> [radius]	Plan or dispatch capsule spawns
eliminate <player> [reason]	Eliminate a player
revive <player>	Revive a player
hearts <balance|give|take|set|bank|withdraw|transfer>	Manage the heart economy
zone <create|list>	Create or list zones (create <id> <type> <radius>)
worldevent <trigger|list>	Trigger or list world events
tournament <create|entrant|seed|result|standings|list>	Run tournaments
stats [statistic]	Show a top-10 leaderboard

Permissions

comparator.admin covers everything and comparator.dashboard only opens the GUI. Both default to op.

Config

Settings live in config.yml. A few defaults worth knowing: the web dashboard runs on port 8087, capsule spawning uses a 1600 default radius, and there are sections for the SQLite database, lifesteal hearts (starting/min/max and steal-per-kill), zone capture timing, the scoreboard, and integration/metrics toggles.

Build

Paper/Folia 1.21, Java 21. Built with Gradle 9.3 and Shadow, producing Comparator-0.1.0.jar. SQLite is shaded but not relocated (it needs that for native libs), bStats is relocated, and PlaceholderAPI is compileOnly.