如何使用Python获取Java+基岩兼容Minecraft服务器的Ping状态信息
跨Java/基岩兼容Minecraft服务器的Python探测实现方案
原有探测工具失效的核心原因
- 目前主流的Java版服务器基岩兼容插件(典型如Geyser)部署后,常见的三类配置会直接导致原有Java版探测失效:
- 部分整合部署方案会将原Java版默认的TCP 25565端口迁移,把该端口分配给基岩版的UDP监听,导致原本指向TCP Java端口的探测请求直接打到UDP基岩服务上,自然无法获得正常响应
- 部分兼容插件会开启流量过滤规则,对无正常客户端特征的TCP探测请求直接丢弃,避免工具误将混合服务器识别为纯基岩服务
- mcipc的常见调用错误:基岩版探测走UDP RakNet协议流程,和Java版的TCP握手流程完全独立,若统一使用Java版的客户端实例请求UDP端口,几乎不可能拿到返回数据
可靠的双协议探测实现方法
Java版探测能力修正
原有基于mcstatus的探测逻辑不需要重构,仅需要调整端口匹配规则即可恢复能力,不需要默认绑定25565端口:
- 典型调用代码:
from mcstatus import JavaServer # 明确指定Java版服务实际监听的TCP地址与端口 server = JavaServer.lookup("服务器IP:Java版实际TCP端口") status = server.status() # 可获取完整Java侧信息:在线玩家数、最大容量、服务端版本、MOTD文本、网络延迟 - 只要传入Java版服务真实的监听端口,哪怕和默认25565端口不一致,也可以和插件部署前一样正常获取Java侧的全部状态信息
基岩版探测能力实现
mcstatus本身已经内置了完整的基岩版探测支持,不需要额外引入mcipc这类第三方库,从根源上避免不同库的协议版本适配滞后问题:
- 注意确保mcstatus版本在0.14.0以上,该版本开始才稳定支持新版基岩协议的探测,旧版本同样会出现握手失败的问题
- 典型调用代码:
from mcstatus import BedrockServer # 基岩版走UDP协议,需传入Geyser配置的基岩监听UDP端口(默认值为19132) server = BedrockServer.lookup("服务器IP:基岩版实际UDP端口") status = server.status() # 可获取完整基岩侧信息:在线玩家数、最大容量、基岩协议版本、世界名称、网络延迟 - 此前使用mcipc探测失败的核心原因:mcipc的基岩版实现对1.20.5之后的新版基岩协议适配滞后,旧版本会直接出现RakNet握手超时,和调用方式错误无关
探测过程的常见踩坑提醒
- 严格区分两种协议的端口属性:Java版探测走TCP协议,基岩版探测走UDP协议,同一端口不会同时承载两种协议流量,绝大多数探测失败的本质是混淆了端口对应的协议类型
- 遇到端口转发类的服务器配置时,不要凭默认端口发起探测,可通过服务端控制台的兼容插件导出指令,查看Java、基岩版对应的真实监听端口
- 尽量用单一套依赖完成双协议探测,多套协议实现的依赖库很容易出现版本冲突、适配不全的问题
内容的提问来源于stack exchange,提问作者shnap
相关产品推荐
相关产品推荐

