NexoraStatistics | Player Stats, Leaderboards & Achievements

About

NexoraStatistics is a comprehensive player statistics plugin built for modern Minecraft servers. It tracks every meaningful thing your players do (blocks broken, mobs killed, distance walked, time online, items crafted, and dozens more) and presents it back to them through a polished in-game experience that rewards progress and encourages engagement.

The plugin ships with a themed GUI, cross-server leaderboards, an achievements system, configurable milestone rewards, a live sidebar, and an embedded web dashboard you can host as a public stats page. Everything is wired up to feel cohesive and easy to navigate.

Under the hood, it is engineered for performance. Async writes, Hikari-pooled SQL, cached leaderboards, batched event handling, and idempotent schema migrations. The goal is for it to do its job quietly in the background while your players enjoy the result.


For your players

• A themed /stats menu with category tabs and drill-down on any stat
• A Top-5 leaderboard around them on every drill-down view
• A sparkline showing their progress over the last 30 hours
• Leaderboards across daily, weekly, monthly, and all-time
• Achievements with title-screen pops and optional broadcasts
• Milestone rewards configured from yaml. For example: 1,000 blocks broken gives a diamond pickaxe, or 10 hours played awards an MVP role.
• A live sidebar they can toggle on for the stats they care about
• A friendly welcome-back greeting on join showing their headline stat and rank
• Tab-list rank chips with gold for #1, silver for #2, and bronze for #3

For server owners

• Custom stats defined in yaml. Use block_break, entity_kill, or item_pickup triggers with material and entity filters. No coding required.
• Discord webhook that fires a themed embed every time someone unlocks an achievement or crosses a milestone
• Public web stats page with an embedded HTTP server and JSON API. Host it at stats.yourserver.net for a public-facing leaderboard.
• Hologram leaderboards via DecentHolograms or HolographicDisplays
• Competitive seasons that archive the top 25 per stat and roll over automatically
• Automatic backups before every destructive command, so a typo never costs you data
• /nexorastats diagnostics gives you live visibility into the plugin's runtime behaviour
• Folia support, region-scheduler aware
• PlaceholderAPI integration covering all stats, periods, and medal-formatted ranks
• Pretty-printed JSON exports with metadata, and BOM-CSV that opens cleanly in Excel

Player commands

• /stats, opens your stats menu
• /stats <player>, view another player
• /stats top [period] <stat>, leaderboard for any stat
• /stats compare <a> [b], side-by-side comparison
• /stats history <stat>, sparkline of the last 30 hours
• /stats achievements, achievements and progress
• /stats sidebar, toggle the live sidebar

Admin commands

• /nexorastats reload
• /nexorastats flush, force-flush the cache to disk
• /nexorastats reset <player> [stat], with an automatic backup first
• /nexorastats export <csv|json>
• /nexorastats backup
• /nexorastats diagnostics
• /nexorastats seasons <info|rollover|show>
• /nexorastats holograms <reload|list>

PlaceholderAPI


Installation

1. Drop NexoraStatistics.jar into your plugins/ folder
2. Start the server. The plugin generates its config files and sets up SQLite automatically.
3. Open plugins/NexoraStatistics/config.yml to tailor anything to your server
4. Run /nexorastats reload or restart the server

SQLite works with zero configuration. If you prefer MySQL, it is four lines in the config file.


Integrations

• PlaceholderAPI: auto-registers, no additional setup needed
• LuckPerms: enables /stats top group <name> <stat>
• Vault: turns balance changes into money_earned and money_spent stats
• DecentHolograms or HolographicDisplays: powers the leaderboard holograms
• Discord webhook: paste a URL in the config to start receiving achievement and milestone embeds

Performance notes

• Movement events are batched every 10 ticks (configurable) so they do not pressure the event loop
• Stats are cached in memory and flushed to disk every 5 minutes by default. Online player operations never block on the database.
• Leaderboards are cached and rebuilt on a low-frequency timer. Reads are O(1).
• Stat-change events skip event allocation entirely when no plugin is listening, so the common case is free
• Snapshots for /stats history run hourly with 30-day retention
• All schema migrations are forward-compatible and idempotent. Upgrading is a jar swap.

Support

If you run into a bug or have a feature in mind, please reach out. I am active in the Nexora Labs Discord and aim to respond to every report.

• Discord: Nexora Labs
• Documentation: docs.nexoralab.uk
• Other plugins: nexoralab.uk

Thank you for considering NexoraStatistics. I hope it makes your server a little more fun.