š Overview
Better Leaderboards is a Minecraft Forge mod that allows you to create beautiful, customizable holographic leaderboards anywhere in your world. Display player statistics like kills, deaths, mob kills, K/D ratio, and playtime with style!
āØ Features
- Holographic Leaderboards - Floating armor stand-based leaderboards that display player rankings
- Custom Headers - Add custom headers with Minecraft color codes support
- Medal Colors - Top 3 players are highlighted with Gold š„, Silver š„, and Bronze š„ colors
- Multiple Statistics - Track various player stats
- Auto-Refresh - Leaderboards automatically refresh every 5 seconds
- Persistent Data - All data is saved per-world and persists across restarts
š Available Statistics
| Stat Type |
Aliases |
Description |
kills |
playerkills, pk |
Player vs Player kills |
deaths |
playerdeaths, pd |
Times killed by other players |
mobs |
mobkills, mk |
Hostile mob kills |
time |
timeplayed, playtime, tp |
Time spent playing (e.g., 2h 30m) |
kd |
kdratio, ratio |
Kill/Death ratio (e.g., 2.50) |
š® Commands
All commands use the /bl prefix. Leaderboard management requires operator permission level 2.
Create a Leaderboard
/bl lb create <id> [statType] [topN] [npcEnabled] [header]
| Parameter |
Default |
Description |
id |
required |
Unique identifier for the leaderboard |
statType |
kills |
The statistic to display |
topN |
10 |
Number of players to show (1-50) |
npcEnabled |
false |
Reserved for future use |
header |
auto |
Custom header (supports color codes) |
Examples:
/bl lb create pvp
/bl lb create killboard kills 5
/bl lb create topkills kills 10 false &6&lTOP KILLERS
/bl lb create deathboard deaths 10 false &cā Most Deaths ā
Delete a Leaderboard
/bl lb delete <id>
Move Leaderboard to Your Position
/bl lb moveHere <id>
Move Leaderboard to Coordinates
/bl lb moveTo <id> <x> <y> <z>
Refresh Leaderboards
/bl lb refresh [id]
List All Leaderboards
/bl lb list
Check Your Rank (Available to all players)
/bl rank [statType]
Displays your current rank for the specified statistic. Defaults to kills if no stat type is provided.
Examples:
/bl rank
/bl rank kills
/bl rank deaths
/bl rank kd
/bl rank time
šØ Color Codes
Custom headers support Minecraft color codes using the & symbol:
Colors
&0 Black |
&1 Dark Blue |
&2 Dark Green |
&3 Dark Aqua |
&4 Dark Red |
&5 Dark Purple |
&6 Gold |
&7 Gray |
&8 Dark Gray |
&9 Blue |
&a Green |
&b Aqua |
&c Red |
&d Light Purple |
&e Yellow |
&f White |
Formatting
&l Bold |
&o Italic |
&n Underline |
&m <s>Strikethrough</s> |
&r Reset |
š Medal Colors
The top 3 players on each leaderboard are highlighted with special colors:
- š„ 1st Place - Gold (#FFD700)
- š„ 2nd Place - Silver (#C0C0C0)
- š„ 3rd Place - Bronze (#CD7F32)
āļø Technical Details
- Refresh Rate: Leaderboards update every 5 seconds
- Time Tracking: Player time is tracked every 60 seconds to minimize server load
- Actionbar Range: Position indicator shows within 32 blocks of a leaderboard
š Requirements
- Minecraft 1.20.1
- Forge 47.4.13 or higher
š§ Installation
- Install Minecraft Forge for Minecraft 1.20.1
- Download the Better Leaderboards JAR file
- Place the JAR file in your
mods folder
- Start your Minecraft server or client
ā Troubleshooting
Leaderboard not appearing?
- Ensure you have operator permissions
- Check if you're in the correct dimension
- Use
/bl lb list to verify the leaderboard exists
Statistics not updating?
- Statistics update every 5 seconds automatically
- Use
/bl lb refresh to force an immediate update
Created by Austizz
