PlayerPing

模组

· 作者 Phoenix_28

由 HoneyBerries 制作的原始 Player-Ping 插件的移植版本。

0 本站下载 0 关注 更新于 6 天前

最新 1.2.0 · 26.3 · NeoForge

一键开服(送7天)

PlayerPing 模组

这是 HoneyBerries 制作的原始 PlayerPing 插件的服务端移植版,适用于模组化的 Minecraft 服务器。

Fabric 服务器需要 Fabric API。

? 1.2.0 更新内容

  • 支持从 1.21.x 到 26.3 的版本。
  • 更精确的延迟测量:服务端每秒自行测量每个连接的延迟,因此 /ping 现在还会显示 抖动(jitter) 和 丢包率。
  • 标签页列表保留 队伍颜色和前缀,而不是替换玩家名称。
  • 标签页列表改为每秒刷新一次,而非每秒 20 次,从而减轻繁忙服务器的负载。
  • 新增 /ping list:一次性查看所有在线玩家的延迟,按从高到低排序(管理员专用,也支持在控制台使用)。
  • 新增 /pingplayer reload:无需重启即可应用配置更改。如果配置文件存在错误,重载将被拒绝,当前设置保持不变。
  • 新增 Placeholder API 支持,使全息图及其他相关模组能够显示玩家的延迟。
  • /ip 命令现在显示“IP(服务端视角)”,以便更清晰地说明。

✨ 功能特性

  • ? 延迟检测 - /ping 查看自身延迟,/ping <player> 及 /ping list 供管理员使用。
  • ? 实测延迟 - 真实往返时间,包含抖动和丢包数据,而非 Minecraft 默认的平滑值。
  • ? IP 查询 - /ip 查看自身 IP,/ip <player> 供管理员查询其他玩家 IP。
  • ? 标签页延迟显示 - 在标签页中显示延迟,并根据质量着色,兼容记分板队伍。
  • ?️ 实时阈值管理 - 在游戏中通过 /pingplayer threshold ... 编辑延迟等级阈值。
  • ? 占位符 - %pingplayer:ping% 和 %pingplayer:quality%,供使用 Placeholder API 的模组调用。
  • ?️ 调试与诊断工具 - 内置诊断功能,便于故障排查。

命令

命令 描述 权限要求
/ping 获取自身延迟 所有玩家
/ping <player> 检查其他玩家的延迟 管理员
/ping list 列出所有在线玩家的延迟 管理员
/ip 获取自身 IP 所有玩家
/ip <player> 获取其他玩家的 IP 管理员
/pingplayer help 显示管理员命令帮助 管理员
/pingplayer reload 重新加载配置文件 管理员
/pingplayer debug 开启或关闭完整调试模式 管理员
/pingplayer dump 生成完整的诊断报告 管理员
/pingplayer threshold <excellent|good|fair|poor|terrible> 显示某等级的当前阈值 管理员
/pingplayer threshold <tier> equal-or-more <value> 设置该等级阈值为 >= 指定值 管理员
/pingplayer threshold <tier> equal-or-less <value> 设置该等级阈值为 <= 指定值 管理员
/pingplayer threshold <tier> equal <value> 设置该等级阈值为等于指定值 管理员
/pingplayer threshold <tier> <min> <max> 设置该等级阈值为区间范围 管理员

管理员定义为:原版操作者(OP)、拥有 playerping.admin 权限的玩家,或 LuckPerms 组权重至少为 minLuckPermsWeight(默认 8)的玩家。

示例

  • /pingplayer threshold terrible equal-or-more 500
  • /pingplayer threshold fair 101 250
  • /pingplayer reload

⚙️ 配置文件

设置保存在 config/player-ping/config.json 中。你可以在游戏中修改延迟等级阈值,并在文件中编辑其他设置,然后运行 /pingplayer reload 生效。

  • showPingOnTab(默认 true):在标签页中显示延迟。
  • tabRefreshTicks(默认 20):标签页更新的频率(20 tick = 1 秒)。
  • accuratePing(默认 true):每秒向每个玩家发送一个小数据包以测量延迟。如果反作弊系统对此有异议,可设为 false,此时将改用 Minecraft 的默认延迟值。
  • minLuckPermsWeight(默认 8):被视为管理员所需的 LuckPerms 权重值。

? 占位符

安装 Placeholder API(可选),并搭配能显示占位符的模组,例如全息图模组:

占位符 示例输出
%pingplayer:ping% 42 ms(根据等级着色)
%pingplayer:quality% excellent(根据等级着色)

全息图文本示例:Welcome %player:displayname%, your ping is %pingplayer:ping% 将显示为 Welcome Steve, your ping is 10 ms。

? 诊断信息

运行 /pingplayer dump 后,模组会在以下位置生成完整的诊断报告:

config/player-ping/crash_reports/

Fabric 文件命名格式:pingplayer_crash_MMddyyyy_fabric.txt

? 延迟质量指示器

  • ? 绿色 - 优秀(50 ms 或更低)
  • ? 黄色 - 良好(51 - 100 ms)
  • ? 金色 - 一般(101 - 200 ms)
  • ? 红色 - 较差(201 - 300 ms)
  • ? 深红色 - 极差(301 ms 或更高)

(默认范围,可在游戏中配置。)

? 安装方法

  1. 下载与你的加载器和 Minecraft 版本匹配的 .jar 文件。
  2. 将其放入服务器的 /mods 文件夹中。
  3. 重启服务器。

? 兼容性

  • Fabric:1.21.x 需要使用 Java 21,26.1 - 26.3 需要使用 Java 25。
  • NeoForge:开发中(WIP)。
  • 客户端/服务端:仅限服务端。
  • Fabric 需要 Fabric API。Placeholder API 为可选。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源