一、准备工作
-
系统要求
-
Python ≥ 3.8（64 位）
-
Java 版 Minecraft 服务端（Spigot / Paper / Fabric 均可，或用 MCDReforged）
-
专用 QQ 小号（建议 NapCat/LLOneBot 框架）
-
-
安装 Python 依赖
pip3 install -U "nonebot2[fastapi]>=2.3.1" "nonebot-adapter-onebot>=2.4.3" requests国内可换清华源加速：pip3 config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple -
获取 BotServer
GitHub 搜索「Minecraft-QQBot/BotServer」→ 下载最新 Release 并解压，得到：
二、配置 BotServer（机器人后端）
编辑
编辑
.env 仅改 4 项：SUPERUSERS=["你的QQ号"]
ONEBOT_ACCESS_TOKEN=abc123
TOKEN=abc123
COMMAND_GROUPS=[123456789]三、配置 QQ 客户端（OneBot 实现）
官方推荐 NapCat.Win 绿色版：
官方推荐 NapCat.Win 绿色版：
-
解压 → 运行
napcat.bat→ 扫码登录 -
浏览器打开日志里的 WebUI → 网络配置 → 新增 WebSocket 服务器
地址：ws://127.0.0.1:8080/onebot/v11/ws -
保存并启用，看到「反向 WebSocket 已连接」即成功
四、接入 Minecraft 服务端
方案 A：MCDReforged（支持 Fabric / Paper）
方案 A：MCDReforged（支持 Fabric / Paper）
-
安装 MCDR 后把
QQBot.mcdr扔进plugins/ -
启动一次生成
config/qq_bot/config.json：{ "name": "生存服", "port": 8000, "token": "abc123", "sync_all_messages": false } -
重载插件，日志提示「发送服务器启动消息成功！」即可
方案 B：Spigot / Paper 直装
-
Releases 下载
Plugin.Spigot.jar→ 放入plugins/ -
修改
plugins/QQBot/config.yml：uri: ws://127.0.0.1:8080/onebot/v11/ws token: abc123 name: 生存服 -
重启服务端，出现「[Listener] 与机器人成功建立链接！」即连通
五、启动顺序（务必按序）
-
启动 BotServer：
python bot.py→ 看到「NoneBot is running」 -
启动 NapCat（已登录则直接运行）
-
启动 Minecraft 服务端
三者就绪后，QQ 群会收到「服务器 生存服 已启动」提示
六、常用群内指令（前缀
/ 可改）/luck # 今日幸运指数
/list # 查看在线玩家
/server # 列出已连接服务器
/command 编号 天气 clear # 远程执行命令
/bound add 玩家名 QQ号 # 绑定白名单
/help # 帮助菜单在游戏内输入
/qq 你好 会把消息反向发到 QQ 群七、常见问题速查
-
8080 端口被占：改
.env与 NapCat 配置，保持统一 -
收不到消息：检查 TOKEN / 端口 / 防火墙；确认 NapCat 日志显示「反向 WebSocket 已连接」
-
关闭死亡提示：在
.env追加DEATH_MESSAGE=false
至此，Minecraft ↔ QQ 群双向消息、玩家上下线/死亡广播、远程指令、白名单绑定等功能全部可用。更多高阶玩法（AI 回复、自定义指令）可查阅官方文档或提交 Issue。
Minecraft-QQBot官方GitHub地址：https://github.com/Minecraft-QQBot/BotServer
© 版权声明
本站内容均转载于互联网，并不代表末地驿站立场！
如若本站内容侵犯了原著者的合法权益，可联系我们进行处理！
本网站所有发布的源码、软件和资料均为作者提供或网友推荐收集各大资源网站整理而来;仅供学习和研究使用,下载后请24小时内删除。不得使用于非法商业用途，不得违反国家法律。否则后果自负！"Minecraft"以及"我的世界"为Mojang Synergies AB的商标 本站与Mojang以及微软公司没有从属关系。
拒绝任何人以任何形式在本站发表与中华人民共和国法律相抵触的言论！
THE END
暂无评论内容