(Abandoned) [Animated Tab] - TabList - [Animated Tab] 动态标签页

💡项目状态说明

此插件项目已被作者放弃维护。由于缺乏使用、时间不足、功能更新有限，以及 Paper 对 Spigot 的硬分叉将带来大量适配工作，作者决定不再公开开发。插件未来将从 Spigot 资源页面移除，但源代码会暂时保留在 GitHub 上，供有兴趣的用户 Fork 并自行修改或继续开发（作者可能提供有限帮助）。继续使用此插件需自行承担风险。

---

🎮功能特性

Bukkit 版本功能

• 创建可在标题/页脚或玩家列表名称中显示的动画
• 可随机化显示的文本
• 可为每个动画设置刷新间隔
• 以服务器刻为单位自动刷新玩家列表
• 支持显示自定义 JSON 文本
• 可自定义玩家列表分组（前缀 + 列表名 + 后缀）
• 可在玩家挂机或隐身时隐藏其所在分组
• 通过命令设置指定分组的前缀、后缀或列表名
• 可在列表名中使用任何占位符
• 可限制分组仅在特定世界生效
• 支持使用 Vault 分组或权限来显示前缀集
• 可通过权限提供插件将 Vault 分组同步到玩家列表
• 可在玩家列表中显示挂机状态格式
• 支持文本格式化
• 支持 160 个符号，可使用 Unicode 且不破坏文件编码
• 支持 1.16+ 版本的十六进制颜色代码
• 支持基础颜色代码
• 支持 1.16+ 版本的自定义字体（详见文档）
• 可移除旁观者玩家在列表中的灰色名称
• 可创建假玩家并添加到玩家列表（随机名称）
• 可设置假玩家的显示名称和 Ping 值
• 可使用真实玩家的皮肤属性为假玩家设置皮肤
• 支持对 Ping 和 TPS 占位符进行逻辑运算符格式化
• 支持按世界显示不同的玩家列表
• 可在不同世界共享同一玩家列表
• 提供多种列表选项，并可针对以下情况设置限制：
• 按世界/按分组/按玩家
• 按权限
• 可切换列表可见性（针对所有玩家或单个用户）
• 支持列表对象类型（生命值、Ping 标签和自定义值）
• 可禁用玩家列表和计分板显示的世界
• 可将挂机玩家排序到列表底部或单独显示
• 可自动下载并应用新版本，无需手动点击下载
• 可在玩家挂机或隐身时将其从列表中隐藏

Bungee 版本功能

• 支持动画标签页（标题/页脚）
• 可限制标签页不对某些玩家显示
• 标签页自动更新（以毫秒为单位）
• 可开关标签页
• 每个服务器可使用不同的玩家列表
• 可禁用标签页显示的服务器
• 支持按玩家显示不同的列表
• 支持动画分组
• 支持对 Ping 占位符进行逻辑运算符格式化
• 支持 160+ 个符号

---

🔧命令与权限

所有命令和权限的详细列表请查阅 Wiki。

---

✨可选依赖与功能

Bukkit 版本

• PlaceholderAPI (可选)
• 启用占位符使用功能
• Vault (可选)
• 启用按分组显示玩家列表的功能
• 允许使用 Vault 分组名称作为分组前缀/后缀显示，无需额外权限
• EssentialsX 或 CMI (可选)
• 使 %online-players% 占位符忽略隐身玩家
• 显示玩家挂机状态
• SuperVanish, PremiumVanish (可选)
• 使 %online-players% 占位符忽略隐身玩家

---

❓常见问题解答 (FAQ)

能否在玩家列表的名字后面显示客户端版本或其他变量？

• 可以。所有 PlaceholderAPI 支持的占位符都可以在玩家列表分组中指定使用。

如果我使用 `%online-players%` 占位符，隐身玩家会被计入在线玩家数吗？

• 这取决于配置选项 ignore-vanished-players-in-online-players。如果启用，则不会计入隐身玩家。

为什么 Citizens NPC 会出现在玩家列表中？

• 这不是由 TabList 或其他插件引起的，而是客户端问题，无法避免。根据 Citizens 文档，此问题已不再存在。

为什么新玩家加入服务器时玩家列表会卡住？

• 请尝试以下操作：
• 确保 tablist.yml 文件中的 refresh-interval 选项设置为 1 或更高，以使列表持续更新。
• 确保服务器上没有安装会取消其他插件任务调度器的插件。

是否支持临时分组？

• 支持！如果使用 LuckPerms 插件，你可以使用其临时命令设置分组权限的持续时间。时间结束后，玩家将不会在列表中看到该分组。

如何使用玩家列表名称，同时保留玩家的昵称和前缀/后缀？

• 你可以在 groups.yml 中使用 tabname 选项将玩家名称更改为合适的名字。例如：

  groups:
    playerName:
      tabname: "%essentials_nickname%"

能否在玩家列表名字的左侧显示自定义目标（计分板）？

• 可以。使用 玩家列表分组 功能，并在前缀部分使用像 %player-ping% 这样的占位符。

如何在玩家列表中显示玩家的金钱？

• 使用 PlaceholderAPI，安装 Vault 插件，并在此处查找与经济相关的占位符：Vault-Economy。

为什么设置的玩家列表分组权限不生效？

• 你可能需要安装一个权限插件才能使其工作，我们推荐使用 LuckPerms。

为什么无法用分组修改玩家头顶的名称标签？

• 名称标签与玩家列表功能无关。本插件专门用于扩展玩家列表功能，不涉及聊天、名称标签等其他方面。配置文件中可能有一两个相关选项，但它们的存在只是为了确保本插件不会破坏其他功能（例如使用分组时名称标签消失）。

---

⭐支持平台与要求

• 支持的服务端：
• Spigot, Paper, Pufferfish

- 不支持 Forge-Bukkit 修改版（可能运行，但玩家列表功能不受支持）

• BungeeCord（用于在 Bungee 服务器上使用此插件）
• Java 版本：Java 8 或更高版本

---

🔧PlaceholderAPI 使用指南

• 下载合适的扩展到你的服务器：

    /papi ecloud download Player

• 重新加载 PlaceholderAPI 和 TabList 插件：

    /papi reload
    /tl reload

更多信息请访问：PlaceholderAPI Wiki

---

💡重要提醒

• 请勿在评论区提交问题或功能建议！ 你将无法在那里获得支持。发布虚假、无效或粗鲁的评论可能导致你无法获得作者的帮助。
• 感谢 @Nety 创建图像徽章！