QQBot

一个基于 Nonebot2 的 Minecraft 服务器 QQ 机器人,支持多服使用

信息
管理

一键安装指令

!!MCDR plugin install qq_bot

数据同步于

...

上次更新

...

最新版本

总下载量

114

返回插件仓库

McdReforged

文档

项目简介

一款基于 Nonebot2 用多种方式与 Minecraft 交互的 Python QQ 机器人。功能丰富,使用简单且可以自行配置,仅需简单配置即可使用。目前已实现的功能有:

  • 多服互联,群服互通。
    • 在不同服务器之间转发消息。
    • 可在游戏内看到 QQ 群的消息。
    • 可使用指令在游戏内向 QQ 群发送消息。
    • 可播报服务器开启、关闭,玩家进入离开服务器以及死亡消息。
  • 使用 WebUi 简单配置。
  • 戳一戳机器人发送一言卡片。
  • 可自行配置指令的开启或关闭。
  • 对 QQ 群指令相应。目前已实现的指令有:
    • luck 查看今日幸运指数。
    • list 查询每个服务器的玩家在线情况。
    • help 查看帮助信息。
    • server 查看当前在线的服务器并显示对应编号,也可用于查看服务器占用。
    • bound 有关绑定白名单的指令。
    • command 发送指令到服务器。

更多功能还在探索中……

Warning

本项目采用 GPL3 许可证,请勿商用!如若修改请务必开源并且注明出处。

本项目为与 BotServer 机器人进行对接的 MCDR 插件。

特色功能

  • 可以使用 !!qq 发送 QQ 群消息。

Tip

请注意,本插件的玩家列表依赖于原版的 List 指令获取。如果你的 List 指令输出由于模组被篡改,请自行尝试修改代码解决,或是提交 Issues 向作者反馈,但我们并不保证接纳所有的 List 格式。

插件安装

你可以到 Releases 下载最新版本 MCDR 服务器插件。

使用此插件前,你需要先安装 Websocket-Client 依赖。输入如下指令安装:

pip3 install websocket-client

将下载好的 QQBot.mcdr 文拷贝到 MCDR 的 插件文件夹 下,安装完成。

插件配置

编辑 配置文件夹 qq_bot 下的 config.json 文件。配置文件内容参考如下:

{
  "uri": "ws://127.0.0.1:8000/",
  "name": "服务器名称",
  "token": "令牌",
  "reconnect_interval": 5
}

其中各个字段的含义如下:

字段名类型含义
uri字符串WebSocket 连接的 Uri,格式为 ws://host:port/
name字符串服务器名称,中英文都可。
token字符串口令,和服务器配置文件下的 TOKEN 保持一致即可。
reconnect_interval整数重连间隔,单位为秒,通常来说不需要修改。

其中 Uri 的 host 和 port 就是你的主机名和机器人配置的端口号。

当你看到类似 身份验证完毕,连接到机器人成功! 的日志时,说明你的服务器已经成功连接到机器人服务器。若出现错误提示,请确保你的机器人服务器已经开启,或者配置文件的 Port 是否正确。你可以通过 server 指令查看服务器是否连接上机器人。

Tip

若插件遇到问题,或有更好的想法,可以加入 QQ 群 962802248 或者提交 Issues 向作者反馈。若你有能力,欢迎为本项目提供代码贡献!