StatsPlugin

A modern, GUI-based stats and leaderboard plugin for Paper/Spigot servers. See what any player — online or offline — has been up to, browse a server-wide leaderboard, and track economy activity, all from a clean in-game menu.

Features

• /stats — open your own stats GUI
• /stats <player> — view another player's stats, online or offline
• /stats top [stat] — browse a server-wide leaderboard with clickable categories
• /stats reload — reload the configuration without restarting
• Full offline player support (kills, deaths, playtime, and more all work for players who are not online)
• Vault economy integration, including automatic "Money Earned" and "Money Spent" tracking over time
• Optional PlaceholderAPI expansion (%statsplugin_<stat>%)
• Permission-based access control for every subcommand
• Safe, asynchronous database access — no main-thread lag from stat lookups
• Clean, bordered GUI with a leaderboard, refresh button, and clickable player heads

Stats Tracked

• Money (live balance), Money Earned, Money Spent
• Kills, Deaths, Mobs Killed
• Playtime
• Blocks Placed, Blocks Broken

Commands & Permissions

Command	Permission	Default
/stats	statsplugin.use	true
/stats <player>	statsplugin.others	true
/stats top [stat]	statsplugin.top	true
/stats reload	statsplugin.reload	op

Leaderboard stat keys: kills, deaths, mob-kills, playtime, blocks-placed, blocks-broken, money-earned, money-spent.

Requirements

• Paper / Spigot 1.21+
• Vault (optional, enables money tracking)
• An economy plugin such as EssentialsX (optional)
• PlaceholderAPI (optional)

Installation

1. Download the plugin jar
2. Place it into the plugins folder
3. Restart the server
4. (Optional) Edit plugins/StatsPlugin/config.yml to adjust the leaderboard sync interval

License

MIT License