MC 双版本 MOTD API

一个简单高效的Minecraft基岩版(BE)和Java版(JE)服务器状态查询接口

接口地址: http://motd.uniteban.xyz:19132/api.php?ip=服务器地址&port=端口&type=版本

API简介

MC 双版本 MOTD API 是一个同时支持Minecraft基岩版和Java版的服务器状态查询接口。

基岩版(BE)支持

使用UDP协议查询服务器
支持标准基岩版服务器
默认端口: 19132
高效检测服务器状态

Java版(JE)支持

使用TCP协议查询服务器
支持标准Java版服务器
默认端口: 25565
完整JSON信息解析

请求参数

参数名	是否必需	说明
ip	是	服务器IP地址或域名
port	是	服务器端口号
type	可选	服务器类型：be(基岩版) 或 je(Java版)，默认为be

使用示例

基岩版服务器查询

GET http://motd.uniteban.xyz:19132/api.php?ip=play.example.com&port=19132&type=be

Java版服务器查询

GET http://motd.uniteban.xyz:19132/api.php?ip=java.example.com&port=25565&type=je

成功响应示例 (基岩版)

{
  "code": 200,
  "status": "online",
  "ip": "play.example.com",
  "real": "192.0.2.1",
  "location": "北京市 某数据中心",
  "port": 19132,
  "motd": "我的Minecraft服务器",
  "protocol": 448,
  "version": "1.19.60",
  "online": 24,
  "max": 50,
  "gamemode": "Survival",
  "delay": 86,
  "type": "be"
}

成功响应示例 (Java版)

{
  "code": 200,
  "status": "online",
  "ip": "java.example.com",
  "real": "192.0.2.2",
  "location": "上海市 某数据中心",
  "port": 25565,
  "motd": "Java服务器欢迎您",
  "protocol": 755,
  "version": "1.20.1",
  "online": 42,
  "max": 100,
  "gamemode": "",
  "delay": 56,
  "type": "je"
}

在线测试

服务器地址 (IP或域名)

服务器端口

服务器类型

服务器状态

准备查询...

JSON响应数据:

{/* 响应数据将显示在这里 */}

响应字段说明

字段名	类型	说明
code	整数	状态码 (200=在线, 201=参数缺失, 202=无法连接, 203=离线, 204=无效类型)
status	字符串	服务器状态 ("online"或"offline")
ip	字符串	查询的服务器地址
real	字符串	服务器真实IP地址
location	字符串	服务器地理位置
port	整数	服务器端口
motd	字符串	服务器名称 (已去除颜色代码)
protocol	整数	协议版本号
version	字符串	游戏版本
online	整数	当前在线玩家数
max	整数	服务器最大玩家容量
gamemode	字符串	游戏模式 (仅基岩版)
delay	整数	网络延迟 (毫秒)
type	字符串	服务器类型 (be/je)
raw	JSON	完整JSON信息解析

状态码说明

200: 在线

服务器在线且响应正常，返回完整的服务器信息。

201: 参数缺失

缺少必要的查询参数 (ip 或 port)。

202: 无法连接

无法与服务器建立连接。

203: 离线

服务器可能处于离线状态或响应无效。

204: 无效类型

不支持的查询类型 (type参数错误)。