Donut Leaderboard
Every server owner knows the feeling: players want to know who is richest, who has mined the most blocks, and who has been grinding the longest. Answering those questions usually means clunky commands or chat spam. Donut Leaderboard solves that problem with a clean, GUI-powered ranking system that works on Spigot, Paper, Purpur and Folia servers running Minecraft 1.20.1 through 26.3. One lightweight jar covers every supported version, so you are not juggling separate builds for each server type.
What Makes Donut Leaderboard Different
Most leaderboard plugins dump a wall of text into chat. Donut Leaderboard takes a different approach. Everything runs through a chest GUI, starting with a category menu that lists every built-in and custom board in one place. Players open it with /leaderboard, /lb, /top or /leaderboards — no complicated syntax required.
From there, each category opens a paginated six-row leaderboard featuring player heads, distinct styling for the top three ranks, and a viewer rank slot that shows where you stand even when you are not on the current page. Previous and next page buttons keep navigation simple, and a back button returns you to the category menu.
Built-In and Custom Categories
Out of the box, Donut Leaderboard tracks balance through Vault, kills, deaths, playtime, blocks mined, mob kills, animals bred, fish caught and damage dealt. If that is not enough, you can build custom boards from any PlaceholderAPI placeholder, complete with a full placeholder expansion using the identifier donutleaderboard. That means scoreboards, holograms, tab lists and chat can all display your top players anywhere on the server.
Daily, Weekly, Monthly and All-Time Boards
Every category can be viewed across four periods: daily, weekly, monthly and all-time. Players switch between them using a clock button inside the GUI, and period boundaries follow a configurable timezone so resets happen at the right moment for your community. Admins can also force a reset with /lb reset <category> <period> when a new season begins.
If you prefer a launcher that handles all of this for you, the foxygame.net launcher keeps Donut Leaderboard updated automatically and flags version compatibility issues before they reach your players. It is a convenient option for admins who would rather spend time building than troubleshooting.
Storage, Performance and Safety
Donut Leaderboard defaults to SQLite, which works instantly for small servers and simple installations. Larger networks can switch to MySQL, which adds HikariCP connection pooling and automatic schema migrations. Database drivers are declared as server libraries and downloaded on first start, keeping the plugin jar at around 100 KB.
Performance matters on busy servers, so rankings refresh asynchronously on a background executor. The plugin deduplicates refreshes, uses a configurable interval, and includes Folia region and global scheduler support. Open leaderboard inventories are also protected against item theft and duplication, with clicks, drags, number-key swaps and double-click collects all blocked.
How to Install Donut Leaderboard
- Download Donut Leaderboard and place the jar in your server's plugins folder.
- Restart the server to generate the default configuration.
- Optionally install Vault with an economy plugin for the balance board, and PlaceholderAPI for custom categories.
- Adjust categories, GUI rows, titles, slots and messages in the config files.
- Grant permissions such as donutleaderboard.use and donutleaderboard.admin.reload as needed.
Config files update automatically when new options are added, so upgrading never wipes your settings. Commands include tab completion throughout, and aliases like lb, top and leaderboards make the plugin feel native to your server.
Requirements at a Glance
You need a Spigot, Paper, Purpur or Folia server on Minecraft 1.20.1 to 26.3, with Java 17 or newer. Java 25 is required for 26.3 servers. Vault and PlaceholderAPI are optional but unlock the balance board and custom placeholder rankings respectively.
Final Thoughts
Donut Leaderboard delivers exactly what most servers need from a ranking plugin: a friendly GUI, flexible periods, custom PlaceholderAPI support, and solid performance without bloating your setup. Whether you run a small survival world or a large network, it is a practical choice that players will actually enjoy using. Grab the jar, drop it in, and let your community see who really leads the server.