DonutTab

# 🍩 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. ---