TabListPing - 玩家延迟显示

TabListPing 是一款在玩家列表（Tab 列表）中显示每位玩家实时网络延迟（Ping 值）的插件。与其他依赖服务器不准确数据的插件不同，TabListPing 会自行测量延迟时间，结果更为精确。显示格式可自定义，并能使用玩家的常规名称或“显示名称”。无需复杂配置，放入插件文件夹并重启服务器即可使用。

💡核心特性

• 精确测量延迟：通过监控服务器与客户端之间的“Keep Alive”数据包往返时间来计算 Ping 值，而非使用服务器可能不准确的内置数值。
• 自动更新：每 15 至 25 秒更新一次显示的 Ping 值，该值为最近三次测量的平均值。
• 开箱即用：无需任何配置即可运行。
• AFK 状态显示：若安装了 EssentialsX 插件，TabListPing 会自动为挂机玩家添加 AFK 标识。
• 可自定义格式：支持在玩家名称前后添加颜色代码和自定义文本。
• 页眉页脚支持：可配置 Tab 列表的顶部标题和底部脚注，并支持显示服务器 TPS、MSPT、负载和玩家所在世界等变量。

🎮配置说明

配置文件为 config.yml。主要配置项如下：

基础格式

• format：定义 Tab 列表中玩家条目的显示格式，需用单引号包裹。
• format-afk：定义玩家处于 AFK 状态时的显示格式。若不需要 AFK 标识，将此值设置为与 format 相同即可（请勿设为 null）。

可用变量：

• %name%：玩家的常规游戏名。
• %displayname%：玩家的“显示名称”（包含颜色代码）。
• %ping%：玩家的延迟时间（单位：毫秒）。

页眉与页脚

• enable-tps：设置为 true 以启用 Tab 列表的页眉和页脚显示。默认为 false 以确保与其他 Tab 列表插件的兼容性。
• format-header：页眉的显示格式。
• format-footer：页脚的显示格式。

页眉/页脚可用变量：

• %name%, %displayname%
• %world%：玩家所在的世界名称。
• %tps%：服务器每秒刻数（仅 Paper 等服务端支持）。
• %mspt%：服务器每刻毫秒数（仅 Paper 等服务端支持）。
• %load%：服务器负载（仅 Paper 等服务端支持）。

注意： %tps%、%mspt% 和 %load% 变量在 Spigot 服务端上不受支持。

默认配置示例

# 支持变量：%name%, %displayname%, %ping%
format: '%name% &7[&a%ping%ms&7]'
format-afk: '%name% &7[&a%ping%ms&7] &eAFK'

# 启用页眉/页脚显示
# 支持变量：%name%, %displayname%, %tps%, %mspt%, %load%, %world%
# Spigot 不支持 %tps%, %mspt%, %load%
enable-tps: false
format-header: ''
format-footer: '&7TPS: %tps%   &7MSPT: %mspt%'

🔧命令

所有命令均需要基础权限 tablistping.command。

• /tablistping reload
• 重新加载插件配置文件。
• 所需权限：tablistping.command.reload
• /tablistping report
• 在控制台或聊天栏生成当前所有在线玩家的 Ping 值报告。
• 所需权限：tablistping.command.report

✨权限节点

• tablistping.header：允许玩家查看 Tab 列表页眉。
• tablistping.footer：允许玩家查看 Tab 列表页脚。
• tablistping.command：允许使用所有子命令的基础权限。
• tablistping.command.reload：允许使用 /tablistping reload 命令。
• tablistping.command.report：允许使用 /tablistping report 命令。

⭐注意事项与依赖

• EssentialsX 集成：AFK 标识功能需要安装 EssentialsX 插件。
• 页眉/页脚变量支持：变量 %tps%、%mspt% 和 %load% 仅在 Paper、Purpur 等基于 Paper 的服务端上有效，Spigot 不支持。
• 数据统计：本插件使用 bStats 收集匿名使用数据以帮助开发。您可以通过修改 plugins/bStats/config.yml 全局禁用此功能。统计数据可见于：https://bstats.org/plugin/bukkit/TabListPing2