CrystalCounter

Track End Crystal placements and breaks in real-time with zero lag! Built specifically for competitive PvP, Anarchy, and Crystal PvP servers, CrystalCounter delivers server-authoritative tracking, zero-impact asynchronous database handling, and an interactive stats interface for your players.

Works completely server-side—no client mods required!

Features

Server-Authoritative Tracking: Prevents client-side spoofing, ghost counting, and fake statistics during rapid combat.
Interactive Stats GUI: Run /cstats to open a sleek in-game chest menu displaying total placements, breaks, and placement-to-break ratios.
Dual Storage Engines: Out-of-the-box support for lightweight SQLite (zero setup) and high-performance MySQL for multi-server networks.
PlaceholderAPI Integration: Display player stats directly on scoreboards, tablists, hover messages, and chat formats.
Fully Asynchronous: Database reads, flushes, and calculations run completely off the main tick thread to keep TPS rock-solid.

Commands & Permissions

Command	Permission	Short Description
`/cstats`	`crystalcounter.stats`	Open your personal crystal statistics GUI
`/cstats <player>`	`crystalcounter.stats.others`	Inspect another online or offline player's stats
`/cstats reload`	`crystalcounter.reload`	Reload configuration files and database connections
`/cstats reset <player>`	`crystalcounter.admin.reset`	Clear all recorded statistics for a player

General Settings (config.yml)

Configure core tracking behavior and performance options directly in your configuration file:

Setting	Description	Default
`database.type`	Select storage backend (`SQLITE` or `MYSQL`)	`SQLITE`
`tracking.track-placements`	Count every End Crystal placed by players	`true`
`tracking.track-breaks`	Count every End Crystal detonated by players	`true`
`gui.title`	Display header title for the `/cstats` menu	`&d&lCrystal Statistics`
`performance.cache-interval`	Time in seconds before stats flush to the database	`300`

PlaceholderAPI Support

Expose live player data anywhere across your server setup with built-in PAPI expansions:

%crystalcounter_placed% — Returns total crystals placed by the player.
%crystalcounter_broken% — Returns total crystals broken/exploded by the player.
%crystalcounter_ratio% — Returns the calculated placement-to-break ratio (K/D style).

Important Advice

Network Syncing: When using MySQL across multiple sub-servers (e.g., BungeeCord / Velocity network), ensure all instances point to the same database schema for automatic cross-server stat syncing.
Compatibility: Native for Paper, Spigot, and Purpur on Minecraft 1.20+ running Java 21.