Better Leaderboards (BL)
Modby Austizz_TDS
A Leaderboard mod that tracks player and mob kills , time played, player deaths and KD (kill / death) Ratio
Description

📊 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
modsfolder - 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 listto verify the leaderboard exists
Statistics not updating?
- Statistics update every 5 seconds automatically
- Use
/bl lb refreshto force an immediate update
Created by Austizz
Recommended Gear
AffiliateHardware and extras that pair well with this mod.
As an Amazon Associate I earn from qualifying purchases.
Screenshots
Similar Mods
Tonic and Wild Medicine
This mod adds natural healing tonics and items with simple recipes and great utility. Perfect for those seeking quick re...
Create: SpawnerBoxer
Deployers from Create mod can now activate spawners!
Cell Terminal
An AE2 addon providing a centralized terminal to manage storage cells and storage buses directly
Doom's Markers
All new land markers without a whole map mod!
PurpurClient
Fixes client-side vanilla bugs
The Hydra: Reborn
A recreation of The Dweller King produced by Flamc04.
