TidyTab
一个整洁、按等级排序的标签页列表 —— 内置 LuckPerms 支持。
TidyTab 为你的标签页列表添加了头部/尾部信息、等级前缀以及正确的排序(工作人员在顶部,默认玩家在底部)。无论是否安装 LuckPerms,它都能正常工作。
功能
- 头部与尾部 — 显示在线人数、最大玩家数以及实时颜色编码的 TPS;自动刷新
- 等级前缀 —
[Owner]、[Admin]、[VIP]… 仅在标签页列表中显示(你的聊天插件继续负责聊天内容)
- 等级排序 — 高等级玩家出现在标签页列表的顶部
- 兼容 LuckPerms — 如果安装了 LuckPerms,TidyTab 会自动使用你真实的 LuckPerms 前缀和组权重。如果没有安装,则使用
config.yml 中的等级设置。无论如何,它都能正常运行。
安装
- 将
tidytab-x.y.z.jar 放入你的 plugins/ 文件夹中。
- 重启服务器。
- (可选)编辑
plugins/TidyTab/config.yml,然后运行 /tidytab reload。
需要 Paper 1.21.x(或其分支)以及 Java 21。LuckPerms 为可选组件。
配置(简版)
refresh-interval-seconds: 5 # 头部/尾部更新的频率
sort-players: true # 如果 ANOTHER 插件管理
# scoreboard teams(标签页/名牌插件),设为 false
header: # 占位符:{online} {max} {tps}
- "&6&lMy Server"
- "&7Players online: &f{online}&7/&f{max}"
footer:
- "&7TPS: {tps}"
ranks: # 匹配你的 LuckPerms 组名
- group: admin
weight: 90 # 权重越高,在标签页列表中越靠前
prefix: "&4[Admin] "
color: "&4"
- group: default
weight: 0
prefix: ""
color: "&7"
颜色使用 & 代码(&a 绿色,&c 红色,&6 金色,&l 加粗,……)。
命令与权限
| 命令 |
作用 |
权限 |
默认值 |
/tidytab reload |
重新加载 config.yml |
tidytab.reload |
OP |
与其他插件和谐共存
- 聊天不受影响 — 仅更改标签页列表中的名称。
- 排序使用 scoreboard teams。TidyTab 只创建/删除其自己的团队,如果玩家已经属于其他插件的团队,TidyTab 会退让而不是抢夺。如果其他插件完全管理团队(如 nametag 插件等),请设置
sort-players: false。
- 在关闭时,TidyTab 会清理自身留下的痕迹:标签页名称、头部/尾部以及所有其团队都会恢复至原版状态。
唯一的网络活动是启动时的一次更新检查(Modrinth 公共 API,仅通知)和匿名的 bStats 使用统计。
排序工作原理(供好奇者了解)
Minecraft 按 scoreboard 团队名称字母顺序对标签页列表进行排序。TidyTab 将其团队命名为 NNN_group,其中 NNN = 999 - weight —— 因此权重 90 变为 909_admin,在字母排序上排在 999_default 之前。权重越高 → 数字越小 → 在列表中越靠前。排序由客户端完成;插件仅负责分配团队。
从源代码构建
./gradlew :tidytab:build
输出:tidytab/build/libs/tidytab-<version>.jar
TidyTab
A clean, rank-sorted tab list — with LuckPerms support built in.
TidyTab gives your tab list a header/footer, rank prefixes, and proper sorting (staff at the top, default players at the bottom). It works with or without LuckPerms.
Features
- Header & footer — shows online count, max players, and live color-coded TPS; refreshes automatically
- Rank prefixes —
[Owner], [Admin], [VIP]… shown in the tab list only (your chat plugin stays in charge of chat)
- Rank sorting — higher ranks appear at the top of the tab list
- LuckPerms aware — if LuckPerms is installed, TidyTab uses your real LuckPerms prefixes and group weights automatically. If not, it uses the ranks from
config.yml. Either way it just works.
Install
- Drop
tidytab-x.y.z.jar into your plugins/ folder.
- Restart the server.
- (Optional) Edit
plugins/TidyTab/config.yml, then run /tidytab reload.
Requires Paper 1.21.x (or a fork) and Java 21. LuckPerms is optional.
Config (the short version)
refresh-interval-seconds: 5 # how often the header/footer updates
sort-players: true # set false if ANOTHER plugin manages
# scoreboard teams (nametag/tab plugins)
header: # placeholders: {online} {max} {tps}
- "&6&lMy Server"
- "&7Players online: &f{online}&7/&f{max}"
footer:
- "&7TPS: {tps}"
ranks: # match your LuckPerms group names
- group: admin
weight: 90 # higher weight = higher in the tab list
prefix: "&4[Admin] "
color: "&4"
- group: default
weight: 0
prefix: ""
color: "&7"
Colors use & codes (&a green, &c red, &6 gold, &l bold, …).
Command & permission
| Command |
What it does |
Permission |
Default |
/tidytab reload |
Reloads config.yml |
tidytab.reload |
OP |
Plays nice with other plugins
- Chat is never touched — only the tab list name is changed.
- Sorting uses scoreboard teams. TidyTab only creates/removes its own teams, and if a player already belongs to another plugin's team, TidyTab backs off instead of stealing them. If another plugin fully manages teams (nametag plugins etc.), set
sort-players: false.
- On shutdown, TidyTab cleans up after itself: tab names, header/footer, and all its teams are restored to vanilla.
The only network activity is a one-time update check on startup (Modrinth public API, notify-only) and anonymous bStats usage stats.
How the sorting works (for the curious)
Minecraft sorts the tab list alphabetically by scoreboard team name. TidyTab names its teams NNN_group where NNN = 999 - weight — so weight 90 becomes 909_admin, which alphabetically sorts before 999_default. Higher weight → smaller number → higher in the list. The client does the sorting; the plugin just assigns teams.
Building from source
./gradlew :tidytab:build
Output: tidytab/build/libs/tidytab-<version>.jar
评论 0
登录后参与评分
还没有评论,来抢沙发吧