# koishi-plugin-mc-status-bot

[![npm](https://img.shields.io/npm/v/koishi-plugin-mc-status-bot?style=flat-square)](https://www.npmjs.com/package/koishi-plugin-mc-status-bot)

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

## 功能特性

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

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

## 使用指南

### 主指令 `mc`
获取服务器状态（不接参数时显示所有服务器）
```tex
示例输出：
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`  | `-n <名称>` `-a <地址:端口>` | 添加/修改服务器信息 |
| `mc del`  | `-n <名称>`                  | 删除指定服务器      |
| `mc list` | 无                           | 查看当前服务器列表  |

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

#### 2. 临时查询

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

## 配置项

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

## 兼容性说明

• 几乎支持所有标准Minecraft Java版服务端（Vanilla/Forge/Fabric等）
• 需要服务器开启TCP ping响应（默认25565端口）
• 群组隔离模式下，不同群组的服务器列表相互独立