服务器状态查询

以 SSE 流式返回 Java / 基岩版服务器的在线状态、MOTD、玩家与延迟。

GET /api/v1/server/status

该接口以 SSE(text/event-stream)流式返回结果:先逐步推送解析进度,最后推送完整状态。 适合在前端实时展示「正在解析 → 连接中 → 握手 → 完成」的过程。

事件序列

eventdata说明
stepdns / connecting / handshake当前进行到的阶段
result完整状态 JSON查询成功,随后关闭流
error{ message, ... }任一阶段失败

Java 版优先解析 SRV 记录(_minecraft._tcp.<host>),失败后回退默认端口 25565; 基岩版使用 RakNet Unconnected Ping(默认端口 19132)。超时:DNS 3s / TCP 3s / 读取 2s。

结果字段

{
  "host": "mc.hypixel.net",
  "port": 25565,
  "ip": "172.65.197.160",
  "online": true,
  "latency": 42,
  "version": "Requires MC 1.8 / 1.21",
  "protocol": 47,
  "players": { "online": 24972, "max": 200000, "sample": [] },
  "motd": { "raw": "§a...", "html": "<span ...>", "plain": "..." },
  "favicon": "data:image/png;base64,..."
}

motd 同时提供三种形态:raw(原始含 § 码)、html(带颜色的 span)、plain(纯文本)。