Leaderboard
by SrMaster
Leaderboard, a Fabric library by SrMaster, creates ranked leaderboards on a server from player statistics such as blocks mined, time played and kills.
What it does
Each leaderboard is defined by a holder, which is the statistic it tracks. A server can run several leaderboards at once, and the top entries are computed from connected players and stored in a database. Offline players are tracked too, so their standing is kept between sessions. Results can be saved to MongoDB to build global top lists shared across servers.
Leaderboard runs its work asynchronously, so the heavy processing stays off the server thread and is handled by worker threads. Per-holder update intervals can be set in seconds. The top-K selection is built to keep input and output and CPU use low on servers with thousands of players. The values are exposed through native placeholders from the pb4 and Patbox placeholder API, which tab lists, HUDs and hologram plugins or mods can read.
Key features
Multiple leaderboards
Several leaderboards can be defined at once, each tracking its own holder such as blocks mined or kills.
Placeholder output
Ranking values are published as placeholders that tab lists, scoreboards and hologram displays can read.
Per-holder update timing
The refresh interval of each holder can be set separately, in seconds.
Online and offline tracking
Players are ranked whether they are online or offline, so the list does not depend on who is logged in.
Asynchronous processing
Heavy ranking work runs on worker threads, keeping the server thread free during updates.
Compatibility
Latest build for each game version and loader.
26.x1 of 1 version with builds
1.21.x10 of 10 versions with builds
Only full game releases are shown. This mod publishes no snapshot builds.
Use cases
Server rankings
Server owners can publish top players for mined blocks, time played or kills on a tab list or hologram.
Who it’s for: Server owners who want ranked statistics shown in game, and plugin or mod authors who read placeholders for their own displays.
How it compares
Key Holder is a Fabric mod for 26.2 that runs client-side only, so it is installed on players' clients and not on the server. Stats Command is server-side only for 1.21.11 – 26.3 and is not open source under a Creative Commons Attribution Non Commercial No Derivatives 4.0 license. Leaderboard is server-side only as well, and it is not open source either, with files for 1.21.1 – 26.2.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Leaderboard | Fabric | 1.21.1 – 26.2 | Server-side only | 2026-08-19 |
| Key Holder | Fabric | 26.2 | Client-side only | 2026-07-09 |
| Stats Command | Fabric | 1.21.11 – 26.3 | Server-side only | 2026-09-22 |
Questions
Does Leaderboard need to be installed on clients?
Can Leaderboard store results in MongoDB?
Which game versions have files for Leaderboard?
In the catalog
Leaderboard is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 13,894 mods support Minecraft 26.2.
More from SrMaster
Similar mods
Official listing
- Modrinth page
- modrinth.com/mod/leaderboard
- Owner
- SrMaster
- Published
- 2025-09-10
- Updated on Modrinth
- 2026-08-19
- Facts verified
- 2026-10-15