🍩 DonutTab

By Voltrex

Bring the iconic DonutSMP tablist to your own Paper server in minutes.

---

What is DonutTab?

DonutTab is a lightweight tablist plugin that recreates the look and feel of the DonutSMP tablist on your own Paper server. It adds a custom header above the player list, a custom footer below it, formats how player names look inside the tab menu, and shows each player's rank prefix floating above their head in the world — all pulled straight from LuckPerms automatically.

No complicated setup. Drop it in, configure the one config file, and you're done.

---

✨ Features

🗂️ Custom Tab Header & Footer

The top and bottom of the tab menu are fully yours to design. By default it ships with the DonutSMP style — a gradient colored server name, an online player count, and a link bar at the bottom — but every single line is editable in tab.yml.

👤 Player Name Formatting

Control exactly how each player's name looks inside the tab list. By default it shows their LuckPerms rank prefix followed by their username, just like DonutSMP. You can change this to anything you want using the available placeholders.

🏷️ Rank Prefix Above Player Heads

Each player's LuckPerms rank prefix is automatically displayed floating above their head in the world. This uses a per-player scoreboard system so it never conflicts with LuckPerms or any other plugin. The prefix updates instantly the moment a rank is changed — no restart, no reload needed.

🔄 Live Updates

The tab refreshes on a configurable tick interval so placeholders like online count, TPS, time, and ping are always up to date.

⚙️ One Config File

Everything lives in a single tab.yml file. Header lines, footer lines, player name format, nametag prefix, nametag suffix, and the update speed — all in one place with helpful comments explaining every option.

---

📋 Placeholders

These work anywhere in the config — header, footer, player name format, and nametag:

Placeholder	What it shows
%online%	Number of players currently online
%playername%	The player's username
%ping%	The player's ping in milliseconds
%tps%	Server TPS
%mspt%	Milliseconds per tick
%worldname%	The world the player is in
%date%	Today's date (MM/DD/YYYY)
%12hourtime%	Current time in EST, 12-hour format (e.g. 3:45PM)
%24hourtime%	Current time in EST, 24-hour format (e.g. 15:45)
%luckperms_prefix%	The player's LuckPerms rank prefix
%blankline%	An empty line

---

🛠️ Commands & Permissions

Command	What it does
/donuttab reload	Reloads the config without restarting

Permission	Default	Description
donuttab.reload	OP	Allows use of /donuttab reload

---

🖥️ Compatibility

Version	Supported?
Paper 1.21.11	✅ Yes
Paper 26.1	✅ Yes
LuckPerms	✅ Optional but recommended

Requires Java 21 or newer. LuckPerms is optional — if it is not installed the %luckperms_prefix% placeholder simply shows nothing instead of crashing.

---

🚀 Setup

1. Drop DonutTab.jar into your plugins folder
2. Restart your server
3. Edit plugins/DonutTab/tab.yml to customize everything
4. Use /donuttab reload to apply changes live

---

❓ Common Questions

Will this conflict with LuckPerms? No. DonutTab gives every player their own private scoreboard so it never touches the same scoreboard that LuckPerms uses. They work side by side without issues.

Does the nametag update when I change someone's rank? Yes. DonutTab hooks directly into LuckPerms and listens for rank changes. The moment you run an /lp command to change a player's group, their nametag above their head updates instantly.

Can I turn off the nametag feature? Yes. Set nametag.enabled: false in tab.yml and the plugin will only handle the tablist, leaving nametags completely alone.

Does it work without LuckPerms? Yes. The tablist header, footer, and player name formatting all work fine without LuckPerms installed. You just won't have access to the %luckperms_prefix% placeholder.

---