TAB - 标签栏编辑插件

TAB 是一款功能强大的 Minecraft 插件，最初由 NEZNAMY 开发，目前由 Wisky987 维护。它允许服务器管理员高度自定义玩家的 Tab 列表、头顶名称前缀/后缀以及页眉/页脚，并支持动画、多世界/多服务器差异化显示以及 MySQL 数据存储。

💡核心功能

BungeeCord 网络功能

• 向玩家发送自定义的 Tab 列表页眉和页脚。
• 为不同的子服务器设置不同的页眉和页脚。
• 支持动画页眉/页脚。
• 可以创建自定义动画。

Bukkit/Spigot 服务器功能

• 向玩家发送自定义的 Tab 列表页眉和页脚。
• 为不同的世界设置不同的页眉和页脚。
• 可配置玩家头顶名称的前缀/后缀（限制 16 字符）。
• 可配置 Tab 列表中的前缀/后缀（无字符限制）。
• Tab 列表和头顶名称可以使用不同的前缀/后缀。
• 支持按世界设置不同的前缀/后缀。
• 支持 PlaceholderAPI（包括关系型占位符）。
• 在 Tab 列表的连接条旁显示玩家延迟（Ping）。
• 可启用/禁用插件的任何部分。
• 通过命令即时更改前缀/后缀。
• Tab 列表中的玩家自动排序。
• 权限管理依赖 Vault。请检查您的权限插件是否兼容：https://docs.neolumia.com/vault/1.6.1/en/supported/permissions.html
• 占位符可用于页眉/页脚以及前缀/后缀。
• 支持在玩家列表中使用 Essentials 的 /nick 昵称。
• 支持动画页眉/页脚，并可创建自定义动画。
• 可选的多世界独立玩家列表。
• 完全客户端渲染，不影响服务器端记分板（兼容性好）。
• 完全异步运行，不会造成服务器卡顿。
• 支持 MySQL（详见下文）。

✨未来计划

• 支持未来的 1.13 版本。
• 修复罕见 Bug（Bukkit）：Tab 未完全加载的提示信息。
• 修复非常罕见 Bug（Bukkit）：未设置后缀时出现的“空格”问题。

🎮命令与权限

BungeeCord 命令

• /btab reload (tab.reload) - 重载插件和配置。

Bukkit/Spigot 命令

• /tab reload (tab.reload) - 重载插件和配置。
• /tab group <组名> tabprefix <前缀...> (tab.change) - 为指定组设置 Tab 列表前缀。
• /tab group <组名> tagprefix <前缀...> (tab.change) - 为指定组设置头顶名称前缀。
• /tab group <组名> tabsuffix <后缀...> (tab.change) - 为指定组设置 Tab 列表后缀。
• /tab group <组名> tagsuffix <后缀...> (tab.change) - 为指定组设置头顶名称后缀。
• /tab player <玩家名> tabprefix <前缀...> (tab.change) - 为指定玩家设置 Tab 列表前缀。
• /tab player <玩家名> tagprefix <前缀...> (tab.change) - 为指定玩家设置头顶名称前缀。
• /tab player <玩家名> tabsuffix <后缀...> (tab.change) - 为指定玩家设置 Tab 列表后缀。
• /tab player <玩家名> tagsuffix <后缀...> (tab.change) - 为指定玩家设置头顶名称后缀。
• /tab debug (tab.debug) - 显示关于您自身的内部调试信息，有助于排查问题。

拥有 tab.admin 权限即可执行所有命令。

🔧MySQL 支持

MySQL 仅适用于 Bukkit/Spigot 版本。

重要提示：

• MySQL 仅用于设置 Tab 列表和头顶名称的前缀/后缀，无法用于其他配置。
• 在 MySQL 模式下，前缀/后缀无法通过命令修改，此功能将在未来更新中添加。

使用方法：

• 插件会生成一个名为 mysqlconfig.yml 的新文件。
• 打开该文件，将 MySQLenabled 设置为 true。
• 您只需要设置您的 MySQL 服务器信息。
• 建议重启服务器，也可以使用 /tab reload 命令。
• 此后，服务器的前缀/后缀将通过 MySQL 数据库工作，而非 config.yml。
• 进入您的 MySQL 数据库，按需配置数据。

❓已知问题

通用问题

• 头顶名称的前缀和后缀总长度（包括颜色代码）不能超过 16 个字符。如果超长，插件会自动截断以避免玩家掉线。这是 Minecraft 的限制。
• 当玩家进入隐身状态（例如使用药水）时，其头顶名称可能仍然可见。这是 Minecraft 1.8.x 客户端的 Bug，其他版本不受影响。
• 使用任何会修改配置的命令（如更改某人的前缀/后缀）后，配置文件中的所有注释都会消失。这是 Bukkit API 的 Bug。
• 使用 Citizens 等 NPC 插件可能会导致一些错误。

插件特定问题

• 当使用 LuckPerms 并为玩家分配了“每服务器”组时，有时会显示玩家在其他服务器上分配的组。这似乎是 LuckPerms API 的 Bug。

⭐兼容性说明

• 插件适用于 Minecraft 1.8.x - 1.12.2。不支持 1.7.x。
• TAB 需要 Vault 来管理权限插件。
• 使用 Plugman 或 /reload 命令重载此插件是安全的（如果 /tab reload 不够用）。
• 已知与以下插件存在兼容性问题：
• SimpleAPI（注册了相同的 /tab 命令）
• 如果您发现更多不兼容的插件，请在讨论页面告知，我们会将其加入此列表。

🔧配置示例

保存更改后，请使用 /tab reload 来应用新配置。

Bukkit 默认配置要点

# 一些可用占位符示例
# %online% - 在线玩家数
# %ping% - 玩家延迟
# %nick% - 玩家昵称
# %rank% - 玩家权限组
# %world% - 玩家所在世界名
# %staffonline% - 在线管理数量（需在下方定义管理组）

change-nametag-prefix-suffix: true # 警告！禁用将破坏 Tab 列表排序！
change-tablist-prefix-suffix: true
enable-header-footer: true

# 刷新间隔（单位：游戏刻，1 tick = 50 毫秒）
nametag-refresh-interval-ticks: 200
tablist-refresh-interval-ticks: 200
header-footer-refresh-interval-ticks: 1

header:
- '&3%animated-object:Hi%&r &l%nick%!'
- '&7Online players:%animated-object:online% %online%'
footer:
- '&7Visit our webpage %animated-object:web%'

show-ping-in-tab: true
use-essentials-nickname-in-tab: false
per-world-playerlist: false

# 当玩家属于多个组时，将使用此列表中位置更高的组
if-a-player-is-assigned-to-more-than-1-group-the-group-higher-in-this-list-will-be-used-to-apply-prefix-suffix:
- "Owner"
- "Admin"
- "Mod"
- "Player"

# 组设置示例
Groups:
  Owner:
    tabprefix: "&0&l[&a&lOwner&0&l] &a&l"
    tagprefix: "&2&lOwner &a&l"

# 按世界覆盖设置
per-world-settings:
  world1:
    header:
    - "这个世界有自定义页眉"

BungeeCord 默认配置要点

refresh-interval-milliseconds: 50

header:
- '&3%animated-object:Hi%&r &l%nick%!'
footer:
- '&7Visit our webpage %animated-object:web%'

# 按服务器覆盖设置
per-server-header-footer:
  paintball:
    header:
    - "Welcome to paintball"
  lobby:
    header:
    - "Welcome to our network!"

❓常见问题解答

问：我可以在命令中使用空格来设置前缀/后缀吗？还是必须手动编辑配置文件？

• 答：可以，命令中可以使用空格，但空格不能是最后一个字符。例如，应使用 "&4Admin &f" 而不是 "&4Admin&f "。

问：如何按照我想要的顺序对 Tab 列表中的玩家进行排序？

• 答：玩家默认按前缀字母顺序排序。假设我们有 4 个组，前缀分别是：&2Owner, &4Admin, &bMod, &3Player（这是我们想要的顺序）。

由于颜色代码，它们会按字母排序为：Admin, Mod, Owner, Player。

要修正顺序，可以在他们的 Tab 前缀前添加一个额外的颜色代码，使其变为：

&0&2Owner, &1&4Admin, &2&bMod, &3Player。

额外的颜色代码会被覆盖，所以实际颜色不变，但玩家会按您想要的顺序正确排序。

如果您有超过 10 个组，可以使用 &a, &b, &c 等代码。

问：如果遇到问题该怎么办？

• 答：请使用插件的讨论页面寻求帮助，其他用户可能更快地为您提供解决方案，这比发送私信更有效。

---

Powered by AquaCore