Donut Leaderboards Replica | Modern GUI v1.0 Alpha

About The Plugin

ArLeaderboards is a modern, feature-rich leaderboard plugin for Minecraft 1.20 - 1.21.x. It utilizes AJLeaderboards as its data engine, presenting your server's top statistics in beautiful, highly customizable GUI menus. Designed with performance and enterprise-grade security in mind, all operations—including database lookups, player head fetching, and placeholder parsing—run entirely asynchronously!

Key Features

• Zero Lag (Fully Asynchronous): Database queries, skin fetching, and GUI generation all happen on background threads, meaning absolutely 0% impact on your server TPS.
• Donut SMP Style GUIs: Beautiful, out-of-the-box GUI configurations replicating the popular Donut SMP design.
• MiniMessage & Hex Color Support: Use modern <gradient:red:blue> and legacy &c formats interchangeably in GUI titles, items, lore, and chat messages.
• Advanced Player Search System: Search for any player via an Anvil GUI to instantly find their exact position and value on the leaderboard, complete with partial name matching and history!
• Offline Player Heads: Native integration with Paper/Spigot profile cache to safely fetch and display premium player skins, even for offline players.
• Dynamic Pagination: Uncapped GUI pagination automatically generated as your leaderboards grow.
• Smart Automation:

* Auto-downloads required PlaceholderAPI expansions (statistics, vault).
* Auto-registers missing leaderboards in AJLeaderboards based on your config.

• "Your Position" Tracking: Instantly view your own leaderboard rank and stats with a dedicated button.
• 100% Configurable: Customize GUI sizes, slots, materials, lores, sounds, search messages, and more!
• Exploit Protected: Built-in click cooldowns (250ms), search cooldowns, and anti-dupe protections.

Required Dependencies

The plugin automatically validates these dependencies and handles internal setup:
1. ajLeaderboards - The backbone for data tracking.
2. PlaceholderAPI - For fetching statistics.
3. Vault - (Soft-Depend) Required if tracking economy/money top.

Default Leaderboards Included

• Top Kills
• Top Deaths
• Top Playtime
• Top Blocks Broken
• Top Blocks Placed
• Top Mob Kills
• Top Money

Commands & Permissions

* /leaderboard (Aliases: /leaderboards, /lb, /top) - Opens the Main Leaderboard Menu.
* Permission: arleaderboards.use (Default: True)

• /leaderboards <board name> - Directly open a specific leaderboard.
• /leaderboards reload - Instantly reload configurations and update cached values.

* Permission: arleaderboards.admin (Default: OP)

Configuration

Every aspect of ArLeaderboards is customizable. The plugin automatically generates structured files:

• config.yml - Database options, cache limits, auto-refresh settings.
• lang.yml - Configure every chat message, prefix, and sound effect.
• placeholders.yml - Easily link your desired ajLeaderboards values.
• Leaderboards/leaderboard_main.yml - Customize the main hub GUI.
• Leaderboards/top_*.yml - Individually configure each specific top category (Playtime, Kills, etc.).

Installation

1. Install ajLeaderboards and PlaceholderAPI in your plugins folder.
2. Drop ArLeaderboards.jar into your plugins folder.
3. Start the server! The plugin will auto-download needed PAPI expansions and setup everything!
4. Customize the generated files and run /leaderboards reload.