Leaderboard Hologram

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, wood and kills
• 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

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

1. Put the jar in your server's mods folder.
2. 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.

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

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.

Leaderboard Hologram

Minecraft leaderboard holograms for Fabric and NeoForge — a readable alternative to scoreboard sidebars that puts your top players in the world.

Leaderboard Hologram turns vanilla player statistics into floating, auto-updating leaderboards built from Minecraft display entities. Show top players by playtime, mob kills, blocks mined, deaths, trades or any custom statistic. Place a top-players board at spawn, over a farm, inside a lobby or beside a shop. The mod is fully server-side: players join with a vanilla client and see the boards with nothing installed.

Why servers use it

• No client mod — one jar on the server; vanilla clients see every board.
• Readable by default — centered rank rows, player names and values with per-row backgrounds.
• 44 presets with aliases — playtime, deaths, kills, mining, crafting, trades, fishing, movement and more. No need to type raw statistic keys.
• Aggregate statistics — boards such as all ores mined, all blocks broken, all logs chopped or all items crafted.
• Persistent named boards — stored in config/leaderboard_holograms.json and restored after a restart.
• Live refresh — updates every 5 minutes (6000 ticks), plus /leaderboard refresh for an immediate update.
• Four themes — clean, gold, dark and compact, chosen per board.
• Readable numbers — playtime as 3d 7h 12m, distances in metres and kilometres, large counts with separators.
• Custom statistics — point a board at any statistic path, including statistics registered by other mods.

Supported loaders and versions

Choose the file that matches both your loader and your exact Minecraft version. Each jar targets its own version range; do not mix a Fabric jar with NeoForge or the reverse.

Requirements

• Fabric: Fabric Loader and Fabric API.
• NeoForge: the matching NeoForge release; no extra dependency.
• Java 21 for the Fabric 1.20.1–1.21.11 jars and the NeoForge 1.21.x jars; the NeoForge 1.20.1 jar runs on Java 17. The 26.1 jars require Java 25.
• Server-side installation only.

Quick start

Stand where you want the board and run:

/leaderboard create quick play_time

That creates a board named play_time at your position, showing the top 10 players by total play time.

A named board with a custom row count and theme:

/leaderboard create preset miners diamonds_collected 10
/leaderboard settheme miners gold

A board built from a raw statistic path:

/leaderboard create path totems "minecraft:used/minecraft:totem_of_undying" 5

Quote paths that contain : or /.

Commands

All commands require permission level 2 (operator) or the server console. Creation and player-relative movement require a player.

New boards are rejected when another board is within 1.5 blocks; the message recommends moving at least 2 blocks away.

Built-in presets

Run /leaderboard presets in game for the full list, or /leaderboard presets <query> to search it. Short aliases such as diamonds, wood and kills are accepted.

Time and survival: 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 and usage: items_crafted_total, items_used_total, items_picked_up_total

Economy and fishing: villager_trades, fish_caught

Themes

/leaderboard settheme spawn_board compact

Configuration and storage

Boards are saved in config/leaderboard_holograms.json in the server directory. Each board stores its name, statistic, dimension, position, row count and theme. Stop the server before editing the file, then start it again or run /leaderboard reload.

Automatic refresh runs every 5 minutes (6000 ticks). Boards read the live statistics of players who have played in that world; a fresh world with no player data shows no rows yet.

Custom statistics and modded statistics

Any statistic tracked by the vanilla statistics system can be displayed. Use /leaderboard create path or /leaderboard setstat path with a path such as:

• minecraft:custom/minecraft:play_time
• minecraft:mined/minecraft:deepslate_diamond_ore
• minecraft:killed/minecraft:warden
• minecraft:used/minecraft:ender_pearl

Statistics registered by other mods usually work through the same path format. The mod warns when a path is outside the common vanilla categories.

FAQ

Do players need the mod? No. The mod is server-side; vanilla clients see the boards.

Does it work on Paper or a vanilla server? No. It requires Fabric or NeoForge on the server.

Which file should I download? Match the loader and the exact Minecraft version in the file name. Fabric and NeoForge builds are separate.

How many players can a board show? Up to 25; 10 by default.

Will it lag the server? Boards are display entities refreshed every 5 minutes, not every tick. A normal number of boards has negligible impact.

Why is a board empty? Statistics are per player and per world. A new world has no statistics yet, and a board only reads players from its own dimension.

Can I show two boards with the same statistic? Yes. Boards are addressed by name and keep independent positions, row counts and themes.

Can I move an existing world to another loader? The board config is loader-independent, but test on a copy of the world first. Keep the same mod version family.

Source and support

Source code: https://github.com/ismaildzf/leaderboard-hologram

Bug reports, preset requests and questions: Discord v_eno or the GitHub issue tracker.

Licensed under the MIT License.