QQBot

QQBot · QQ 群服互联机器人

通过中转站实现 QQ 群/私聊 ↔ Minecraft 服务器互通，支持 Paper 与 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，后端装 QQBot-Paper，后端设 proxyMode: velocity。

License

MIT