TabListPro - TabListPro

TabListPro 是 TabListEdit 的升级版本。只需一个轻量级插件，你就能为玩家名称、前缀、后缀、页眉和页脚添加动画，通过分组清晰排序玩家，并利用强大的 PlaceholderAPI 创建终极的玩家列表体验。

💡重要须知

• TabListPro 是 TabListEdit 的更新版。如果你过去使用过 TabListEdit，请务必根据新版本更新你的配置文件！
• 对于 1.16 及以上版本，配置文件全面支持十六进制颜色代码（如 #FFAA00）。

🎮功能特色

• 动态动画：为玩家名称、列表页眉和页脚创建流畅的动画序列。
• 智能分组：通过权限或命令将玩家分配到不同组，并为每个组设置独立的显示名称动画。
• 清晰排序：根据指定的权限顺序，在玩家列表中自上而下排序玩家。
• 全面兼容：所有部分均支持 PlaceholderAPI（非必需），可插入各种动态变量。
• 高度可定制：可自定义玩家显示名、前缀、后缀，并控制动画更新速度。

🔧安装与设置

安装 PlaceholderAPI（可选）

若要使用 TabListPro 配置模板中的占位符，在安装 PlaceholderAPI 后，可能需要执行以下命令来下载并加载扩展：

/papi ecloud download Server
/papi reload

配置文件说明

主要配置选项位于 `config.yml` 中

• 页眉与页脚：启用并设置动画文本，使用 \n 换行。
• 排序规则：在 sortByPerms 列表中按权限从上到下排序玩家。
• 显示名称：可选择使用玩家的聊天显示名，并为其添加前缀和后缀。
• 玩家分组：定义不同的组，设置组权限和该组玩家的名称显示动画。

⭐命令与权限

可用命令

• /tablistpro set 或 /tlp set
• 将指定玩家设置为某个组。
• /tablistpro reload 或 /tlp reload
• 重新加载插件配置。

所需权限

• tablistpro.set
• 允许使用 /tablistpro set 命令。
• tablistpro.reload
• 允许使用 /tablistpro reload 命令。

❓常见问题

如何将玩家分配到组？

有两种方式

• 通过命令：管理员使用 /tlp set 。
• 通过权限：在组的配置中设置 orHasPermission 节点，拥有该权限的玩家会自动加入该组。更高优先级的组权限会覆盖低优先级组。

玩家列表的排序原理是什么？

插件会按照 config.yml 中 sortByPerms 列表定义的权限顺序，从上到下排列玩家。拥有列表中靠前权限的玩家会显示在列表顶部。未匹配任何权限的玩家将按用户名排序并置于底部。

前缀/后缀不显示或显示异常？

请确保

• use-displayname 选项已设置为 true。
• 最终生成的前缀或后缀文本（在所有占位符替换后）长度不超过 16 个字符。错误的占位符可能导致长度超限。

如何获得技术支持？

如有任何问题、建议或错误报告，请在插件的官方讨论页面发帖。

---

> 感谢您选择 TabListPro！