TopStats for Minecraft
Minecraft server analytics that go deeper than a player counter.
Most Minecraft "analytics" stop at a player count and an uptime badge. TopStats treats your server like a product: every join, quit, death and lag spike becomes an event you can chart, funnel, and alert on - alongside a full server-health feed of tick rate, tick duration, memory, loaded chunks and entity counts.
One jar covers Spigot and Paper from 1.8.8 through current, built on a Java 8 compatible SDK, so the same file runs on your legacy 1.8 PvP network and your newest Paper build. Players are identified by UUID, so name changes never split a player’s history.
Tracked automatically
player_joined / player_quitwith session length and first-time-join detection
player_deathwho, where, and what killed them
server_statsTPS, mean tick ms, memory, loaded chunks, entities, player count - each its own chartable series
lag_spikean instant event whenever a tick freezes past your threshold
Install in two minutes
- Drop the TopStats jar from GitHub Releases into plugins/.
- Add your API key to plugins/TopStats/config.yml.
- Restart. Events appear in your dashboard within seconds.
api-key: "ts_live_..." # from Settings -> API keys
source: "minecraft"Common questions
Which Minecraft versions are supported?
Spigot and Paper from 1.8.8 through the current release, with one jar. Version-specific tick sources are detected at runtime, so Paper servers get native tick timings and older Spigot builds fall back to a sampled tick meter.
Will it lag my server?
No. Events are buffered in memory and sent in batches from a background thread - nothing runs on the main server thread, and a network outage drops analytics, never ticks.
Can my other plugins send custom events?
Yes. The plugin exposes a small API any plugin can call to track its own events - quests completed, items bought, arenas finished - which land in the same dashboards.