# 描述
TabListPing 在标签栏玩家列表中显示每个玩家的延迟（ping）时间。与其他使用服务器不准确值的插件不同，TabListPing 直接测量延迟时间。格式是可配置的，可以显示玩家的常规名称或 "显示名称"。无需任何配置。只需将其放入插件文件夹并重启服务器即可。
如果您安装了 [EssentialsX](https://modrinth.com/plugin/essentialsx)，TabListPing 还会为任何离线（AFK）的玩家添加一个离线指示器。
TabListPing 可以选择性地显示标签栏标题和页脚，并包含变量，如玩家的世界名称和服务器的 TPS。 这需要进行一些小的配置和权限更改。
# 详情
大约在 1.12 版本发布时，服务器维护每个玩家延迟时间的方式被破坏了，结果是这些值过高。 显然，使用服务器维护的延迟时间的插件也会显示这些膨胀的延迟时间。 TabListPing 计算自己的延迟时间，比依赖服务器值的插件更准确。
它的工作原理是什么？ 每 15 到 25 秒，服务器会向每个客户端发送一个“保持活动”消息。客户端随后会用自己的“保持活动”消息进行响应。TabListPing 监控每个消息的发送/接收时间，并使用时间差作为延迟时间。 您会看到值每 15-25 秒更新一次。 显示的值是最后三个测量值的平均值。
# 配置
**format** - 这表示显示在标签栏列表中的条目的格式，应该用单引号括起来。 您可以使用三个变量：**%name%** 用玩家的常规名称替换，**%displayname%** 用玩家的 "显示名称" 替换，包括颜色（如果有），**%ping%** 用毫秒单位的延迟时间替换。 您也可以使用标准的 Minecraft 颜色代码。
**format-afk** - 当玩家离线 (AFK) 时使用的格式。 如果您不需要离线指示器，只需编辑 config.yml 文件，使 **format-afk** 与 **format** 相同即可。（不要将其设置为 null。）离线指示器需要 EssentialsX。
**enable-tps** - 启用标签栏标题和页脚的显示。 为了最大限度地与其他标签栏插件的兼容性，默认情况下禁用此功能。
**format-header** 和 **format-footer** - 分别是标题和页脚的格式。 支持的变量是 **%name%**、**%displayname%**、**%tps%**、**%mspt%**、**%load%** 和 **%world%**。 请注意，Spigot 不支持 **%tps%**、**%mspt%** 或 **%load%**。 玩家需要具有 **tablistping.header** 和/或 **tablistping.footer** 权限。
默认配置如下：
```yaml
# 支持的变量是 %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 reload** - 重新加载配置文件。
**/tablistping report** - 生成所有登录玩家的当前延迟时间的报告。 这主要用于控制台（玩家可以直接查看标签栏来查看延迟时间）。
# 权限
**tablistping.header** - 为此玩家显示标签栏标题
**tablistping.footer** - 为此玩家显示标签栏页脚
**tablistping.command** - 所有子命令所需的权限
**tablistping.command.reload** - 允许使用重新加载命令
**tablistping.command.report** - 允许使用报告命令
# 杂项
此插件使用 bStats 统计系统来提供 _匿名_ 用法数据。 您可以通过更改 plugins/bStats/config.yml 文件全局选择退出。 统计数据可在 [https://bstats.org/plugin/bukkit/TabListPing2](https://bstats.org/plugin/bukkit/TabListPing2) 查看
