Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
StatsPlugin
A modern, beautiful stats plugin for Paper servers: a clean GUI, server leaderboards with daily / weekly / monthly rankings, player comparison, PlaceholderAPI support and 9 languages — with zero setup.
Requires Paper 1.21+ (or a Paper fork such as Purpur / Pufferfish) and Java 21. Spigot is not supported.
Features
- Stats GUI with category tabs (Overview, Combat, World, Travel, Economy), server rank on every stat and "today" gains
- 22 stats: playtime, logins, jumps, nights slept, player kills, deaths, mob kills, blocks placed/broken, fish caught, animals bred, villager trades, items enchanted, total/walked/sprinted/swum/elytra/ridden distance, balance, money earned/spent
- Leaderboards for every stat with All time / Today / This week / This month, paging (up to 100 players) and your own rank
- Player comparison:
/stats compare <player>shows who wins every stat - Instant start: existing players are imported automatically on first launch, so leaderboards are never empty
- Privacy:
/stats togglehides your stats from other players and the leaderboards - PlaceholderAPI: leaderboard names/values, ranks and per-period values for holograms and scoreboards
- Vault support for balance and money earned/spent (works with whichever economy plugin loads, in any order)
- 9 languages: English, 日本語, 简体中文, Español, Deutsch, Français, Português (BR), Русский, 한국어 — all editable
- Fast and light: stats are cached in memory and written to SQLite in batches off the main thread
- Console friendly:
/stats top,/stats info <player>work from the console - Update notifications from Modrinth for operators (can be disabled)
Commands
| Command | Description | Permission |
|---|---|---|
/stats |
Open your stats | statsplugin.use |
/stats <player> |
View another player's stats | statsplugin.others |
/stats top [stat] [period] |
Open the leaderboards (periods: all, daily, weekly, monthly) |
statsplugin.top |
/stats compare <player> |
Compare your stats with a player | statsplugin.compare |
/stats info [player] |
Show a stats summary in chat | statsplugin.use |
/stats toggle |
Hide or show your stats | statsplugin.hide |
/stats reload |
Reload config and language files | statsplugin.reload |
/stats import |
Re-import existing players | statsplugin.admin |
/stats reset <player> |
Remove a player from the database | statsplugin.admin |
Other permissions: statsplugin.bypass (view hidden stats), statsplugin.update (update notifications), statsplugin.* (everything).
Players get use, others, top, compare and hide by default.
PlaceholderAPI
Stat keys: playtime, joins, jumps, sleeps, kills, deaths, mob-kills, blocks-placed, blocks-broken, fish-caught, animals-bred, trades, enchants, distance, distance-walked, distance-sprinted, distance-swum, distance-elytra, distance-ridden, balance, money-earned, money-spent
| Placeholder | Result |
|---|---|
%statsplugin_kills% |
Formatted value (e.g. 1,250, 3d 4h 12m, 12.50 km) |
%statsplugin_kills_raw% |
Raw number |
%statsplugin_kills_weekly% |
Gain this week (daily, weekly, monthly also work) |
%statsplugin_rank_kills% |
Server rank (%statsplugin_rank_kills_weekly% for a period) |
%statsplugin_top_kills_1_name% |
Name of the #1 player |
%statsplugin_top_kills_1_value% |
Value of the #1 player |
%statsplugin_top_kills_weekly_3_name% |
Name of the #3 player this week |
%statsplugin_kdr% |
Kill/death ratio |
%statsplugin_firstjoin% / %statsplugin_lastseen% |
Dates |
Configuration
plugins/StatsPlugin/config.yml lets you choose the language, sync interval, leaderboard size, GUI sounds, creative-mode block tracking and more.
To change a language, set language: (for example ja, zh_CN, es) and run /stats reload. Language files live in plugins/StatsPlugin/lang/.
Notes
- Blocks placed/broken, logins and money earned/spent are tracked by the plugin from the moment it is installed. Everything else comes from Minecraft's own statistics, so existing progress is available immediately.
- Period leaderboards (today / week / month) start filling from the moment the plugin is installed.
- Upgrading from 1.x/2.x keeps your existing database.