✅CustomLeaderboards [1.21-26.2]
1.3.8Flexible leaderboards with timed resets, rewards, placeholders and SQLite/MySQL support.
1.3.8latest1.3.8 – Citizens NPC LeaderboardsAug 23, 2026 Citizens NPC leaderboards are now available! Display your top players as full Citizens NPCs directly in the world. ✓ Place ranks 1, 2 and 3 individually. ✓ Show the current leaderboard or winners from the previous period. ✓ Move each NPC independently. ✓ Customize or completely disable the text above NPCs. ✓ Empty positions use a configurable fallback skin. ✓ Players can use /clb to browse all leaderboard categories through an interactive inventory GUI. Quick setup: Code (Text): /clb display create spawn_weekly weekly resource_points npc current /clb display place spawn_weekly 2 /clb display place spawn_weekly 3 Stand at the desired location before placing each NPC. Citizens is only required when using NPC displays. All other CustomLeaderboards features continue to work without Citizens.1.3.71.3.7 – Player-Placed Block ProtectionAug 13, 2026 Resource leaderboard protection is here! Version 1.3.7 prevents players from farming points by repeatedly placing and mining the same resource blocks. ✓ Player-placed resources now award zero points. ✓ Protection works even if another player mines the block. ✓ Placement data is stored in SQLite/MySQL and survives restarts. ✓ Placed blocks remain protected when moved by pistons. Add this to your weighted resource leaderboard: Code (YAML): server_generated_only : true Existing compatible resource leaderboards enable this protection automatically. Important: Blocks placed before version 1.3.7 was installed cannot be detected retroactively. Reset active resource competitions after updating if necessary.1.3.61.3.6 – Weighted Resource LeaderboardsAug 13, 2026 Weighted Resource Leaderboards are here! Version 1.3.6 introduces a new configurable leaderboard type where different resources can award different amounts of points. What’s new? · Combine multiple resources into one leaderboard. Configure an individual point value for every resource. Fortune enchantments do not award additional points because blocks mined are counted instead of item drops. Existing player statistics are used as a starting baseline, so only newly collected points count. Supports daily, weekly, monthly and permanent leaderboards. Works with existing placeholders, resets, rewards and offline reward delivery. Configuration example: Code (YAML): tops: resource_points: name : Resource Points type : weighted number_format : full sources: oak_log: placeholder : ' %statistic_mine_block:oak_log%' points : 1 iron_ore: placeholder : ' %statistic_mine_block:iron_ore%' points : 5 diamond_ore: placeholder : ' %statistic_mine_block:diamond_ore%' points : 20 ancient_debris: placeholder : ' %statistic_mine_block:ancient_debris%' points : 50 Example hologram line: Code (YAML): [LIST ] [*]content : '&eTop Resources : &f%customleaderboards_top_resource_points;weekly;top_name;1% &7 (&b %customleaderboards_top_resource_points;weekly;top_value;1% points&7)' height : 0.3 [/LIST] Important when updating: Existing configuration files are not overwritten. Replace the old JAR and manually add the new resource_points section from the included configuration or guide. Please note that the vanilla Minecraft mining statistic cannot distinguish naturally generated blocks from blocks placed and mined again. Consider using region rules or another anti-exploit solution where necessary. Thank you for the feature suggestion and for supporting CustomLeaderboards!
1.3.51.3.5 – Accurate Money Earnings, Compact Numbers & FishingAug 2, 2026 CustomLeaderboards 1.3.5 Accurate money earnings, cleaner values and more leaderboard options This update focuses on improving economy leaderboards, number formatting and configuration flexibility. What's New? · Accurate money-earned tracking – Current-balance placeholders can now track positive balance increases instead of simply displaying the player's current balance. Fast earnings detection – Economy balances are sampled in memory every second by default, while database saves continue using the normal update interval. Spending does not reduce earnings – Purchases and withdrawals never remove money a player has already earned during the period. Compact number formatting – Large values can now be displayed using the English abbreviations K,M,B and T. Improved large-number parsing – Supports normal decimals, English comma separators, scientific notation and compact suffixes. Fishing leaderboard example – New installations include a fishing category powered by %statistic_fish_caught%. Paper compatibility fix – Improved startup compatibility with Paper 1.21.11. Expanded configuration comments, examples and setup documentation. Money Leaderboard Example Code (Text): eco: name: Money Earned placeholder: '%vault_eco_balance%' track_earnings: true number_format: compact With this setup, a player earning $1,000,000 will gain $1M on the leaderboard. Spending money afterwards will not remove those recorded earnings. Existing configurations using %vault_eco_balance% remain compatible and are automatically detected as earnings leaderboards. Updating · Stop your server. Replace the previous CustomLeaderboards JAR. Keep your existing plugins/CustomLeaderboards/ folder. Start the server. If your previous weekly money values are incorrect, you can wait for the next scheduled reset or run: Code (Text): /customleaderboards forcereset weekly false Warning: This command resets every weekly leaderboard without giving rewards. CustomLeaderboards is my first public plugin, so feedback and bug reports are greatly appreciated. https://discord.gg/dtnyUccYkx']Join the Discord server for support[/URL]1.3.4New Playtime Formatting OptionJul 30, 2026 CustomLeaderboards 1.3.4 This update adds a new playtime formatting option for server owners who only want to display days and hours. What’s new? · Added time_format: days_hours Displays playtime as 2d 7h, 14h, or <1h Minutes and seconds are completely hidden when using the new format The selected format is used in placeholders, reward messages, and the leaderboard command · Added explanations and examples to the default configuration and setup guide To enable the new format, change your playtime configuration: Code (YAML): tops: playtime: name : Playtime placeholder : ' %statistic_time_played%' parse_time : true time_unit : ticks time_format : days_hours The existing time_format: short option remains available and continues to display detailed values including minutes and seconds. Existing configuration files are not overwritten during an update, so you must add or change time_format manually. No changes were made to leaderboard tracking, databases, reset schedules, or reward delivery.1.3.3Offline Rewards & Playtime FormattingJul 20, 2026 CustomLeaderboards 1.3.3 This update introduces persistent offline reward delivery and improves playtime formatting throughout the plugin. What's new? · Offline reward support: Rewards for offline winners are stored in SQLite/MySQL and delivered automatically when they log in. Pending rewards survive server restarts. Console commands, player commands and reward messages are delivered in their configured order. Normal commands such as give diamond 3 now work for offline winners. Fixed displaying raw ticks in playtime reward messages. Playtime is now displayed as readable time, such as 2h 16m or 3d 4h. · Hologram placeholders, reward messages and the admin top command now use the same value formatting. Updating Stop your server, replace the previous CustomLeaderboards JAR with version 1.3.3 and start the server again. Your existing CustomLeaderboards folder and configuration files can be kept. No configuration changes are required, and the new database table is created automatically.1.3.2Jul 18, 2026
Similar projects
Plugin →Let Me Despawn
Improves performance by tweaking mob despawn rules. Say bye to pesky unintentional persistent mobs.
25MSueta
JourneyMap
Real-time map used for mapping in-game or your browser as you explore.
14.7MSueta
Emotecraft
Create your own emotes in Minecraft.
7.5MSueta
Simple Tpa
A simple tpa plugin which sends requests
5.4MSueta
Common Network
Forge and Fabric Unified Networking Solution
3.9MSueta
Set Home
A lightweight plugin for players to set their homes.
3.8MSueta