Leaderboard Hologram
Your server already tracks play time, kills, blocks mined and trades. This mod puts those numbers in the world, on floating boards that update by themselves.
Players see the boards with a normal Minecraft client. You only install the mod on the server.
What you get
- 44 ready-made statistics, with short names like
diamonds,woodandkills - Boards for one stat or for a group, such as all ores mined or all items crafted
- Four looks: clean, gold, dark and compact
- Named boards that survive restarts
- Automatic refresh every 5 minutes, plus a manual refresh command
- Works with vanilla clients. No client mod, no resource pack.
Versions
| Loader | Minecraft |
|---|---|
| Fabric | 1.20.1 to 1.21.11, 26.1 and 26.1.1 |
| NeoForge | 1.20.1, 1.21.1, 1.21.10, 1.21.11, 26.1.2, 26.2, 26.3 |
Download the file that matches your loader and exact Minecraft version.
Most 1.20.1 to 1.21.11 builds need Java 21. The NeoForge 1.20.1 build runs on Java 17. The 26.x builds need Java 25.
Fabric servers also need Fabric API. NeoForge servers need nothing else.
Install
- Put the jar in your server's
modsfolder. - Start the server.
That is it. The first board can be made in game.
First board
Stand where you want it and run:
/leaderboard create quick play_time
You get a board named play_time with the top 10 players by play time.
Want a different name, size or look?
/leaderboard create preset miners diamonds_collected 10
/leaderboard settheme miners gold
To use a statistic that has no preset, give it the full path:
/leaderboard create path totems "minecraft:used/minecraft:totem_of_undying" 5
Commands
Operator level 2 or the console can use these. Creating a board and moving it to yourself need a player in game.
| Command | What it does |
|---|---|
/leaderboard create quick <preset> |
Make a board where you stand |
/leaderboard create preset <name> <preset> [rows] |
Make a named board from a preset |
/leaderboard create path <name> <path> [rows] |
Make a board from a full statistic path |
/leaderboard create <name> <category> <key> [rows] |
Make a board from a category and key |
/leaderboard remove <name> |
Delete a board |
/leaderboard remove nearest |
Delete the closest board |
/leaderboard rename <name> <new_name> |
Rename a board |
/leaderboard move <name> |
Move a board to you |
/leaderboard setpos <name> <pos> |
Move a board to exact coordinates |
/leaderboard settop <name> <rows> |
Set how many players to show, 1 to 25 |
/leaderboard settheme <name> <theme> |
Change the look |
/leaderboard setstat preset <name> <preset> |
Point a board at another preset |
/leaderboard setstat path <name> <path> |
Point a board at a full statistic path |
/leaderboard setstat <name> <category> <key> |
Point a board at a category and key |
/leaderboard info <name> |
Show a board's details |
/leaderboard list |
List all boards |
/leaderboard presets [query] |
List or search presets |
/leaderboard themes |
List the four looks |
/leaderboard search <query> |
Search presets by name |
/leaderboard refresh |
Update every board now |
/leaderboard reload |
Reload the config file |
Presets
Run /leaderboard presets in game for the full list.
Time: play_time, time_since_death, time_since_rest, deaths, games_left
Combat: mob_kills, player_kills, damage_dealt, damage_taken, zombie_kills, skeleton_kills, creeper_kills, spider_kills, enderman_kills, dragon_kills, wither_kills
Movement: distance_walked, distance_sprinted, distance_swum, distance_flown, jumps, elytra_uses
Gathering: diamonds_collected, iron_ingots_collected, gold_ingots_collected, emeralds_collected, redstone_collected, coal_collected, lapis_collected, copper_ingots_collected, netherite_scrap_collected
Mining: blocks_broken_total, ores_mined_total, diamond_ore_mined, iron_ore_mined, gold_ore_mined, obsidian_mined, ancient_debris_mined, logs_chopped
Crafting: items_crafted_total, items_used_total, items_picked_up_total
Trading and fishing: villager_trades, fish_caught
Themes
| Theme | Look |
|---|---|
clean |
Soft rows, easy to read |
gold |
Warm colors with a premium feel |
dark |
Sharp and simple |
compact |
Smaller rows for tight spaces |
Storage
Boards are saved in config/leaderboard_holograms.json in your server folder. The file keeps each board's name, statistic, world, position, row count and theme.
Stop the server before editing the file. Then start it again, or run /leaderboard reload.
Boards read player statistics from the world they are placed in. A new world with no player data will show an empty board until people play.
Common questions
Do players need the mod? No. Only the server.
Does it work on Paper? No. It needs Fabric or NeoForge.
How many rows can a board show? Up to 25. The default is 10.
Will it lag? Boards update every 5 minutes, not every tick. A few boards are light.
Can two boards show the same stat? Yes. Each board has its own name, position and theme.
Can I use stats from other mods? Usually yes. Use the statistic path the other mod registers. The mod warns if the category looks unusual.
Source
The code is open under the MIT license: https://github.com/ismaildzf/leaderboard-hologram
Bug reports and preset requests can go to Discord v_eno or the GitHub issue tracker.
Live top-10 playtime board.
Playtime and jumps boards placed together in a survival world.
Clean theme with per-rank rows.
Server-side hologram leaderboards at a glance.
Play time, kills, mining, crafting, trades and more.
Clean, gold, dark and compact.
Vanilla clients see the boards.
Create, move, restyle and refresh boards.
Playtime board on a real NeoForge 26.3 server.
| Version | Minecraft | Loader | Download |
|---|---|---|---|
|
Leaderboard Hologram 1.3.1 (NeoForge 26.3) 1.3.1-neoforge-26.3 |
26.3
|
neoforge
|
Download |
|
Leaderboard Hologram 1.3.1 (NeoForge 26.2) 1.3.1-neoforge-26.2 |
26.2
|
neoforge
|
Download |
|
Leaderboard Hologram 1.3.1 (NeoForge 26.1.2) 1.3.1-neoforge-26.1.2 |
26.1.2
|
neoforge
|
Download |
|
Leaderboard Hologram 1.3.1 (NeoForge 1.21.11) 1.3.1-neoforge-1.21.11 |
1.21.11
|
neoforge
|
Download |
|
Leaderboard Hologram 1.3.1 (NeoForge 1.21.10) 1.3.1-neoforge-1.21.10 |
1.21.10
|
neoforge
|
Download |
|
Leaderboard Hologram 1.3.1 (NeoForge 1.21.1) 1.3.1-neoforge-1.21.1 |
1.21.1
|
neoforge
|
Download |
|
Leaderboard Hologram 1.3.1 (NeoForge 1.20.1) 1.3.1-neoforge-1.20.1 |
1.20.1
|
neoforge
|
Download |
|
Leaderboard Hologram 1.3.1 1.3.1 |
1.21.2, 1.21.3
|
fabric
|
Download |
|
Leaderboard Hologram 1.3.1 1.3.1 |
1.21.5, 1.21.6, 1.21.7, 1.21.8
|
fabric
|
Download |
|
Leaderboard Hologram 1.3.1 1.3.1 |
1.21.10, 1.21.9
|
fabric
|
Download |
|
Leaderboard Hologram 1.3.1 1.3.1 |
26.1, 26.1.1
|
fabric
|
Download |
|
Leaderboard Hologram 1.3.1 1.3.1 |
1.21.11
|
fabric
|
Download |
|
Leaderboard Hologram 1.3.0 1.3.0 |
1.21.11
|
fabric
|
Download |
|
Leaderboard Hologram 1.3.0 1.3.0 |
1.21.10
|
fabric
|
Download |
|
Leaderboard Hologram 1.3.0 1.3.0 |
1.21.9
|
fabric
|
Download |
|
Leaderboard Hologram 1.3.0 1.3.0 |
1.21.8
|
fabric
|
Download |
|
Leaderboard Hologram 1.3.0 1.3.0 |
1.21.7
|
fabric
|
Download |
|
Leaderboard Hologram 1.3.0 1.3.0 |
1.21.6
|
fabric
|
Download |
|
Leaderboard Hologram 1.3.0 1.3.0 |
1.21.5
|
fabric
|
Download |
|
Leaderboard Hologram 1.3.0 1.3.0 |
1.21.4
|
fabric
|
Download |
|
Leaderboard Hologram 1.3.0 1.3.0 |
1.21.3
|
fabric
|
Download |
|
Leaderboard Hologram 1.3.0 1.3.0 |
1.21.2
|
fabric
|
Download |
|
Leaderboard Hologram 1.3.0 1.3.0 |
1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6
|
fabric
|
Download |
|
Leaderboard Hologram 1.3.0 1.3.0 |
1.21, 1.21.1
|
fabric
|
Download |