一款基于 Nonebot2 用多种方式与 Minecraft 交互的 Python QQ 机器人。功能丰富,使用简单,性能高强且可以自行配置,仅需简单配置即可使用。目前已实现的功能有:
- 多服互联,群服互通。
- 在不同服务器之间转发消息。
- 可在游戏内看到 QQ 群的消息。
- 可使用指令在游戏内向 QQ 群发送消息。
- 可播报服务器开启、关闭,玩家进入离开服务器以及死亡消息。
- 使用 WebUi 简单配置。
- 戳一戳机器人发送一言卡片。
- 可自行配置指令的开启或关闭。
- 对 QQ 群指令相应。目前已实现的指令有:
luck
查看今日幸运指数。list
查询每个服务器的玩家在线情况。help
查看帮助信息。server
查看当前在线的服务器并显示对应编号,也可用于查看服务器占用。bound
有关绑定白名单的指令。command
发送指令到服务器。
更多功能还在探索中……
本机器人可通过各种方式与 Minecraft 服务器进行交互,包括:
- Fabric 模组(开发中)
- Spigot 插件
- McdReforged 插件
请前往你需要插件的仓库按照说明进行安装。请注意,不同的插件所提供的功能可能是不一样的,您可根据需求选择安装。
如你有能力开发其他的对接插件,欢迎联系并加入我们!
Warning
本机器人 V2.x.x 并不向下兼容 V1.x.x,请在更新后重新配置。只有新版的机器人可以支持多种对接的方式,旧版机器人仅支持 Mcdr 插件。 如需从 V1 升级,请查看 V1 升级指南
在命令行内输入以下指令安装依赖:
pip3 install "nonebot2[fastapi]>=2.3.1"
pip3 install "nonebot-adapter-onebot>=2.4.3"
pip3 install "requests>=2.32.3"
pip3 install "matplotlib>=3.9.0"
如果你看到控制台输出 install successfully
类似的日志,说明你安装依赖完毕,可以正常使用机器人。
Warning
此机器人仅支持 Python 3.8 及以上版本。若版本过低,否则可能会出现不可预知的错误。
你可以到 Releases 下载最新版本的机器人服务器。
在 V2.0.0 版本中,我们加入了 Webui 配置界面,帮助使用者更容易的调整配置。
要想使用 WebUi 请先运行机器人,双击解压后的 BotServer
文件夹内的 Start.bat
运行。在控制台中会打印出一串类似
05-25 19:49:08 [INFO] WebUi http://host:port/webui?token=********
复制链接到浏览器里,就可以使用 WebUi 进行配置。注意,配置完成后请重启机器人配置才会生效。
本机器人仅支持 Onebot V11 协议,建议用 Websocket 反向链接。
解压下载的 BotServer.zip
到任意位置,进入 BotServer
文件夹,编辑文件夹下的 .env
文件,按照注释配置即可。
对于 QQ 机器人(如 GoCqHttp,LLOneBot,NapCat 等)的配置请见 Onebot 适配器文档。
双击解压后的 BotServer
文件夹内的 Start.bat
运行机器人服务器。当看到出现类似如下的日志时,
05-25 19:49:08 [INFO] nonebot | OneBot V11 | Bot 2********6 connected
即代表机器人连接成功,你可以向群内发送help
指令,若机器人正常回复,那么恭喜你已经安装成功了。若无反应,请检查配置是否正确,或联系作者寻求帮助。开始使用你的机器人吧!
Q: 如何使用指令?
A: 你可以在 QQ 群内发送 help
指令查看机器人的帮助信息,也可以用 help <指令名称>
查看具体指令的帮助信息。
Q: 为什么我发送的指令没有响应?
A: 请检查你是否加上了指令前缀(即 .env 内的 COMMAND_START)。
感谢以下人员为此机器人开发提供帮助,在此特别鸣谢:
- Msg_Lbo 提供网站服务器以及域名,贡献 WebUi 代码。
- meng877 提出意见,贡献部分代码。
- Decent_Kook 提供测试环境,提出意见,帮忙宣传。
- creepebucket 提供测试环境。
Tip
若遇到问题,或有更好的想法,可以加入 QQ 群 962802248
或者提交 Issues
向作者反馈。若你有能力,欢迎为本项目提供代码贡献!
- TQM 服务器
- LemonFate 服务器
- RedstoneDaily 红石日报