# QQBot · QQ 群服互联机器人
通过中转站实现 QQ 群/私聊 ↔ Minecraft 服务器互通，支持 Paper 与 Velocity 双端部署。
## 仓库
| 平台 | 仓库 |
|---|---|
| Paper（后端） | [QQBot-Paper](https://github.com/ttwlwlbb51522/QQBot-Paper) |
| Velocity（代理） | [QQBot-Velocity](https://github.com/ttwlwlbb51522/QQBot-Velocity) |
推荐组合：Velocity 代理 + 各后端 Paper 插件。
## 架构
```
中转站 ──WebSocket── Velocity ──bridge(qqbot:bridge)── 各 Paper 后端
```
- **Velocity**：负责连接鉴权、指令处理、聚合各后端状态。
- **Paper**：上报 TPS/MSPT/人数；检测到 Velocity 后连接鉴权交由 Velocity 版，忽略 `wsUrl`。
## 功能
- QQ 指令：`/list` `/tps` `/ping` `/bind` `/unbind` `/me` `/help`
- 游戏内：`/bind accept <验证码>` `/unbind`
- 验证码绑定：8 位、5 分钟过期、游戏内确认
- 上线私聊提醒、双语、密钥鉴权
- `/xx` 默认全部服务器，`/xx <服务器名>` 查单个，找不到提示
## 部署
1. 启动中转站，生成 `forwarding.secret`。
2. 密钥放插件数据目录（Paper：`plugins/QQBot/`，Velocity：`plugins/qqbot/`）。
3. Velocity 装 [QQBot-Velocity](https://github.com/ttwlwlbb51522/QQBot-Velocity)，后端装 [QQBot-Paper](https://github.com/ttwlwlbb51522/QQBot-Paper)，后端设 `proxyMode: velocity`。
## License
MIT
QQBot is a free Minecraft Java mod. Compatible with Minecraft 1.20, 1.20.1, 1.20.2, 1.20.3 and newer. Downloaded 1 times (via Hangar). Download it and open it directly in the game.