- Tested MC versions
- 1.21
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.
Similar projects
Plugin →VeinMiner
Mine the whole vein on mining a single ore/block. Make the tedious mining experience to something satisfying and fun! FTB Ultimine alternative
99.3MSueta
Simple Voice Chat
A working voice chat in Minecraft!
76.8MSueta
Chunky
Pre-generates chunks, quickly and efficiently
18.4MSueta
VeinMiner Enchantment
Veinminer Addon - Adds vineminer enchantment to enchanting tables. Only tools with the enchantment can veinmine
18MSueta
JourneyMap
Real-time map used for mapping in-game or your browser as you explore.
14.7MSueta
WorldEdit
A Minecraft Map Editor... that runs in-game! With selections, schematics, copy and paste, brushes, and scripting. Use it in creative, or use it temporarily in survival.
11.6MSueta