✦ AutoLeaderboards — ALB ✦
The Last Leaderboard Plugin You'll Ever NeedStop wasting hours configuring leaderboards.
AutoLeaderboards lets you create a beautiful, live-updatinghologram leaderboard for ANY stat in under 10 seconds —
with a single command. No YAML editing. No restarts. No headaches.
Why ALBEvery server needs leaderboards. Players love competition.
But every existing solution either requires hours of config,breaks on updates, or only supports 2-3 stats.
AutoLeaderboards was built from the ground up to be:
Instant to set up — one command, done Universal — supports ANY stat, ANY economy, ANY plugin Zero-lag — fully async, never touches your TPS Beautiful — hologram display with color, hex codes & animations Reliable — works with or without hologram plugins installed
QUICK START1. Drop AutoLeaderboards.jar into your /plugins folder
2. Start your server
3. Stand where you want the leaderboard
4. Type: /alb setup kills
5. Done. Your live leaderboard is up.
No YAML editing required. No restart needed. Ever.
FEATURE OVERVIEW◆ ONE-COMMAND SETUP
/alb setup <stat> — creates a fully live leaderboard
at your exact location instantly. No forms. No GUI.
No config file editing required.
◆ SUPPORTS EVERY STAT
Kills • Deaths • KDR • Playtime • Money • Coins
Blocks Mined • Mob Kills • Wins • Votes • Joins
Damage Dealt • Items Crafted • Fish Caught • Arrows Shot
+ ANY PlaceholderAPI placeholder as a leaderboard stat
◆ BUILT-IN COINS LEADERBOARD
Full coins tracking built directly into ALB.
Works with PlayerPoints, CoinsAPI, EconomyShopGUI,
or ALB's own internal coins engine — auto-detected.
Players earn coins from kills, mob kills, fishing
and more — all configurable in config.yml.
◆ UNIVERSAL ECONOMY SUPPORT
Vault hook supports every economy plugin automatically:
EssentialsX • CMI • EconomyShopGUI • TheNewEconomy
iConomy • and any other Vault-compatible plugin.
◆ SMART HOLOGRAM ENGINE (3-TIER SYSTEM)
Tier 1 → DecentHolograms (if installed)
Tier 2 → HolographicDisplays (if installed)
Tier 3 → Built-in ArmorStand Engine (zero dependencies)
ALB always works — no matter what plugins you have.
◆ REAL-TIME AUTO REFRESH
Leaderboards update automatically on a configurable
interval (default 60s). Each leaderboard has its own
independent refresh rate. Zero TPS impact — 100% async.
Smart diff engine: only updates if data actually changed.
◆ FULL COLOR CODE SUPPORT
& legacy codes • &#RRGGBB hex colors
MiniMessage format (Paper) • PlaceholderAPI in titles
Every leaderboard line is fully customizable.
◆ ANIMATED TITLES
Configure multiple title frames that cycle automatically.
Make your leaderboards look alive and premium.
◆ OFFLINE PLAYER SUPPORT
Players stay on the leaderboard even when offline.
Scores cached in database with configurable expiry.
Fair rankings — no one disappears just for logging off.
◆ PLUGIN INTEGRATIONS
✓ PlaceholderAPI — use any %placeholder% as a stat
✓ Vault — universal economy support
✓ LuckPerms — full per-node permission control
✓ McMMO — skill level leaderboards
✓ Jobs Reborn — job XP and level leaderboards
✓ PlayerPoints — points leaderboard
✓ CoinsAPI — coins leaderboard
✓ EconomyShopGUI — top buyer/seller leaderboards
✓ DecentHolograms — premium hologram display
✓ HolographicDisplays — hologram display fallback
✓ Citizens — attach leaderboard to NPC display
✓ CMI / EssentialsX — vanish compatibility
◆ PLACEHOLDERAPI EXPANSION
ALB exposes its own placeholders for use anywhere:
%alb_top1_kills_name% → #1 player name
%alb_top1_kills_score% → #1 player score
%alb_player_rank_kills% → your current rank
%alb_player_score_kills% → your current score
Works with any stat, any rank position.
◆ MOVE & MANAGE ANYWHERE
/alb move <id> — relocate any leaderboard instantly
/alb edit <id> — change stat, title, size, refresh live
/alb delete <id> — remove cleanly with no leftover data
/alb list — browse all leaderboards in a chest GUI
/alb info <id> — full details on any leaderboard
◆ IMPORT & EXPORT
/alb export <id> — save leaderboard config as JSON
/alb import <file> — deploy leaderboard from JSON file
Share leaderboard setups between servers in seconds.
◆ AUTOMATIC REWARDS SYSTEM
Auto-reset leaderboards daily / weekly / monthly.
Run configurable commands for top 1, 2, 3 players.
Broadcast reset announcements to the whole server.
Each leaderboard can have its own reset schedule.
◆ DEVELOPER API
Register custom stat providers from your own plugin:
ALBApi.registerStatProvider(new StatProvider() {
public String getName() { return "my_stat"; }
public CompletableFuture<Double> getScore(UUID uuid) { ... }
});
Full Javadoc included. Clean, stable public API.
◆ LUCKPERMS PERMISSION NODES
alb.setup • alb.move • alb.delete • alb.edit
alb.list • alb.reload • alb.reset • alb.stats
alb.export • alb.import • alb.admin
alb.bypass.limit — bypass leaderboard creation cap
Works perfectly with LuckPerms rank-based permissions.
◆ MYSQL & SQLITE STORAGE
MySQL with HikariCP connection pooling for networks.
SQLite out-of-the-box for single servers — zero setup.
Auto schema migration — never lose data on update.
ALL COMMANDS
/alb setup <stat> Create leaderboard at your location
/alb move <id> Move leaderboard to your location
/alb delete <id> Delete a leaderboard
/alb edit <id> <option> <value> Edit a leaderboard live
/alb list Browse all leaderboards (chest GUI)
/alb info <id> View leaderboard details
/alb reset <id> Manually reset leaderboard data
/alb stats <player> View all stats for a player
/alb export <id> Export leaderboard as JSON
/alb import <filename> Import leaderboard from JSON
/alb reload Reload config + all leaderboards
SUPPORTED STATS
kills deaths kdr playtime
money coins blocks_mined blocks_placed
mob_kills player_kills wins losses
votes joins jumps damage_dealt
damage_taken items_crafted fish_caught arrows_shot
mcmmo_<skill> jobs_<job>_xp
%any_placeholderapi_placeholder%
TECHNICAL SPECIFICATIONS
Server Software → Paper / Spigot / Bukkit
Minecraft Version → 1.21.11
Java Version → Java 21+
Database → MySQL or SQLite (auto-detect)
Dependencies → NONE (all optional)
Performance → 100% Async — Zero TPS Impact
