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.

Support

Bug reports, preset requests and questions: Discord v_eno.

Licensed under the MIT License.