基于 Nonebot2 的 QQ 机器人服务端
支持多个 Minecraft 服务器同时接入,消息跨服转发,统一管理。
可视化配置界面,实时修改配置,支持热重载,无需重启服务。
可接入 AI 功能,支持智能对话,一言卡片,戳一戳互动。
git clone https://github.com/IamJokerZHEN/QQBotServer_Rebuild cd BotServer docker-compose up -d
HOST=0.0.0.0 PORT=8000 TOKEN=your_token_here SUPERUSERS=["your_qq"]
与 BotServer 对接的 Fabric 模组
在 config/qq_bot.json 中创建配置文件:
{
"uri": "ws://127.0.0.1:8000/",
"name": "生存服",
"token": "your_token",
"reconnect_interval": 5
}
| 字段 | 类型 | 说明 |
|---|---|---|
| uri | string | WebSocket 连接地址,格式 ws://host:port/ |
| name | string | 服务器名称,中英文均可,显示在QQ群中 |
| token | string | 验证令牌,需与 BotServer 配置一致 |
| reconnect_interval | int | 断线重连间隔(秒),默认5秒 |
/qqbot
查看 QQBot 状态信息
/qqbot reconnect
手动重连 WebSocket
/qqbot config
查看当前配置
/qqbot config uri "ws://..."
修改连接地址
/qqbot config token "xxx"
修改验证令牌
/qqbot test
测试与 BotServer 的连接
/qqbot info
查看详细的连接信息
QQ群指令与游戏内管理指令
.luck
娱乐
查看今日幸运指数
.mcdr
管理
在指定服务器执行 MCDR 指令
.list
查询
查询各服务器在线玩家
.server
查询
查看服务器列表与资源占用
.bound
白名单
绑定/解绑白名单
.command
高级
发送原始指令到服务器
/qqbot
管理员
显示状态面板
/qqbot reconnect
连接
重新连接 WebSocket
/qqbot config
配置
查看当前配置
/qqbot config uri "ws://..."
配置
修改服务器地址
/qqbot config token "xxx"
配置
修改验证令牌
/qqbot test
测试
测试连接状态
三步完成群服互联搭建
使用 Docker Compose 快速启动服务端
git clone https://github.com/IamJokerZHEN/QQBotServer_Rebuild cd QQBotServer_Rebuild docker-compose up -d
在 Minecraft 服务器中安装模组并配置连接
QQBot-Fabric-1.x.x.jar
{
"uri": "ws://your-server:8000/",
"token": "match-botserver"
}
启动服务并验证连接状态