? DonutTab
By Voltrex
在几分钟内,将标志性的 DonutSMP 标签页列表(tablist)带到你的 Paper 服务器上。
什么是 DonutTab?
DonutTab 是一个轻量级的标签页列表插件,它在你自己的 Paper 服务器上重现了 DonutSMP 标签页列表的外观和感觉。它在玩家列表上方添加自定义头部,在下方添加自定义尾部,格式化玩家在标签菜单中显示的名称,并在世界中每个玩家头顶上方显示其 LuckPerms 等级前缀——所有这些都直接从 LuckPerms 自动获取。
无需复杂的设置。将其放入服务器,配置唯一的配置文件即可。
✨ 特性
?️ 自定义标签页头部与尾部
标签页菜单的顶部和底部完全由你设计。默认情况下,它附带 DonutSMP 风格——带有渐变颜色的服务器名称、在线玩家数量以及底部的链接栏——但 tab.yml 中的每一行都是可编辑的。
? 玩家名称格式化
控制每个玩家在标签页列表中显示的名称样式。默认情况下,它会显示他们的 LuckPerms 等级前缀后跟用户名,就像 DonutSMP 一样。你可以使用可用的占位符将其更改为任何你想要的格式。
?️ 玩家头顶上方的等级前缀
每个玩家的 LuckPerms 等级前缀会自动显示在世界中他们头顶上方的悬浮文本中。这使用了基于每个玩家的记分板系统,因此永远不会与 LuckPerms 或任何其他插件冲突。当等级改变时,前缀会立即更新——无需重启或重载。
? 实时更新
标签页根据可配置的刻数间隔刷新,以确保在线人数、TPS、时间和延迟等占位符始终处于最新状态。
⚙️ 单一配置文件
所有内容都位于单个 tab.yml 文件中。头部行、尾部行、玩家名称格式、名牌前缀、名牌后缀以及更新速度——全部集中在一个地方,并附有解释每个选项的详细注释。
? 占位符
这些占位符可以在配置文件的任何地方使用——头部、尾部、玩家名称格式和名牌:
| 占位符 |
显示内容 |
%online% |
当前在线玩家数量 |
%playername% |
玩家的用户名 |
%ping% |
玩家的延迟(毫秒) |
%tps% |
服务器 TPS |
%mspt% |
每刻毫秒数 |
%worldname% |
玩家所在的世界名称 |
%date% |
今天的日期(MM/DD/YYYY) |
%12hourtime% |
EST 时区的当前时间,12 小时制(例如 3:45PM) |
%24hourtime% |
EST 时区的当前时间,24 小时制(例如 15:45) |
%luckperms_prefix% |
玩家的 LuckPerms 等级前缀 |
%blankline% |
空行 |
?️ 命令与权限
| 命令 |
功能 |
/donuttab reload |
无需重启即可重新加载配置 |
| 权限 |
默认值 |
描述 |
donuttab.reload |
OP |
允许使用 /donuttab reload 命令 |
?️ 兼容性
| 版本 |
是否支持 |
| Paper 1.21.11 |
✅ 是 |
| Paper 26.1 |
✅ 是 |
| LuckPerms |
✅ 可选但推荐 |
需要 Java 21 或更高版本。LuckPerms 是可选的——如果未安装,%luckperms_prefix% 占位符将简单地不显示任何内容,而不会导致崩溃。
? 设置步骤
- 将
DonutTab.jar 放入你的 plugins 文件夹
- 重启服务器
- 编辑
plugins/DonutTab/tab.yml 以自定义所有内容
- 使用
/donuttab reload 实时应用更改
❓ 常见问题
这会与 LuckPerms 冲突吗?
不会。DonutTab 为每个玩家提供独立的私有记分板,因此它绝不会触及 LuckPerms 使用的同一个记分板。两者可以并行工作,互不影响。
当我更改某人等级时,名牌会更新吗?
会的。DonutTab 直接挂钩到 LuckPerms 并监听等级变更。当你运行 /lp 命令更改玩家组别的那一刻,他们头顶的名牌就会立即更新。
我可以关闭名牌功能吗?
可以。在 tab.yml 中设置 nametag.enabled: false,插件将仅处理标签页列表,完全不管名牌。
如果没有安装 LuckPerms,它能工作吗?
可以。标签页头部、尾部以及玩家名称格式化在没有安装 LuckPerms 的情况下也能正常工作。只是你将无法使用 %luckperms_prefix% 占位符。
? 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
- Drop
DonutTab.jar into your plugins folder
- Restart your server
- Edit
plugins/DonutTab/tab.yml to customize everything
- 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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧