koishi-plugin-mc-status-bot

📌 一个通过TCP协议获取Minecraft Java版服务器状态的Koishi插件，支持多群组隔离管理。

功能特性

✅ 核心功能

• 实时获取服务器状态（版本、在线玩家、延迟等）
• 内置数据库存储群组专属服务器列表
• 自动移除描述中的颜色代码等非文本内容（可配置）
• 几乎兼容所有标准Java版服务器

⚡ 性能优势

• 延迟计算（显示ping值）
• 批量查询支持（一次查看所有服务器状态）
• 轻量级TCP请求（1.0.10+）

使用指南

主指令 mc

获取服务器状态（不接参数时显示所有服务器）

示例输出：
lmy[mc.123456:25565]
描述：EF Island
延迟: 31ms
版本：1.12.2
在线人数：4/30
当前在线：玩家1,玩家2,玩家3,玩家4
mod数：123
***********************
atm7-sky[mc.123456.top:25565]
版本：1.18.2
在线人数：0/20

子指令系统

1. 管理服务器列表

指令	参数	功能说明
mc set	<名称> <地址:端口>	添加/修改服务器信息
mc del	<名称>	删除指定服务器
mc list	无	查看当前服务器列表

mc list 示例：
服务器名称：lmy
服务器IP：mc.123456
服务器端口：25565
***********************
服务器名称：gtnh
服务器IP：node.123456
服务器端口：25565

2. 临时查询

指令	参数	功能说明
mc ping	<地址:端口>	临时查询指定服务器状态

配置项

# koishi.yml 配置示例
mc-status-bot:
  adminUsers: []       # 管理员用户qq，根据koishi提供的`user.id`字段，不同适配器有所不同
  groupKeep: true      # 启用群组隔离，在哪个群聊中新增的服务端信息，只能在其群聊中查看（默认true）
  descriptionFormatting: true  # 自动清理描述中的非纯文本（默认true）

兼容性说明

• 几乎支持所有标准Minecraft Java版服务端（Vanilla/Forge/Fabric等） • 需要服务器开启TCP ping响应（默认25565端口）