PF-QQchat（支持离线服务器）

PFingan服务器 MCDR的QQ机器人插件，集QQ群管理和白名单管理一体，添加许多功能。

Note

由于 GUGUbot 和 WebUI 项目庞大，但迄今为止仅有开发者一名，所以我们从现在开始招募有志者加入我们！
有意者请加 QQ1377820366 或 QQ群726741344

Tip

[腾讯文档] GUGUbot文档
此Github文档不再维护详细内容，仅保留必要说明
访问腾讯文档查看更详细的说明: https://docs.qq.com/aio/p/sct29j7ammzw142

腾讯文档快速导航

GUGUbot

CQ-QQ-API

本文档快速导航

依赖配置
快速开始
功能列表
详细配置
- 前置cq_qq_api配置
- GUGUbot机器人配置
有BUG或是新的IDEA
TODO
贡献

依赖配置

Python 包: 请确保已安装 Python™ 和 pip (pip通常在安装完python后会默认安装)。

Python 模块: 参考插件目录内的 requirements.txt 文件，使用命令 pip install -r requirements.txt 进行安装。

前置插件

可选插件

PF-MCDR-WebUI : 在 2.0.0 版本后将是必选前置插件

安装

MCDR快捷安装:

MCDR服务端输入 !!MCDR plugin install gugubot
加载后，在/config/cq_qq_api/config.json中配置接收api
加载后，在/config/GUGUbot/config.yml中配置机器人
重载 cq_qq_api: !!MCDR plugin reload cq_qq_api

github下载安装:

下载前置插件并放入/plugins
前往Release下载GUGUbot.mcdr放入/plugins
加载后，在/config/cq_qq_api/config.json中配置服务
加载后，在/config/GUGUbot/config.yml中配置机器人
重载 cq_qq_api: !!MCDR plugin reload cq_qq_api

必要配置

机器人

正向websocket服务端口: 接收数据上报的端口，例如8080
消息上报格式: 机器人基于CQ码进行解析

CQ-qq-api

host: 接收数据上报的地址，默认 127.0.0.1
port: 对应数据上报的端口，默认8080

GUGUbot

admin_id: 管理员QQ号默认拥有GUGUbot管理员权限(仅私聊)
group_id: 聊天转发的群

Important

注: 如果您在安装完成后启动提示没有配置文件请下载config_default.yml重名名为config.yml放入/config/GUGUbot/config.yml再运行
请注意，以上仅为必要配置项，如果您想要更加私有的体验，请完整的阅读可选配置项！

功能列表

QQ部分帮助，向QQ机器人发送，可以私聊也可以群聊发送 #帮助

基本功能

聊天互相转发: 支持 MCDR 与 QQ 群组/私聊之间的消息互通。
白名单绑定: 支持在QQ群内进行白名单绑定，退群自动解绑；支持离线服务器或者正版与离线的混合服务器。

详细功能

GUGUbot - 功能列表 - 腾讯文档

游戏内指令

!!klist','显示游戏内关键词
!!qq <msg>', '向QQ群发送消息(可以触发qq关键词)
!!add <关键词> <回复>','添加游戏内关键词回复
!!del <关键词>','删除指定游戏关键词
@ <QQ名/号> <消息>','让机器人在qq里@

群聊功能

命令帮助如下:
#玩家                -> 获取在线玩家列表
#假人                -> 获取在线假人列表
#服务器              -> 同时获取在线玩家和假人列表
#绑定 <游戏ID>       -> 绑定你的游戏ID
#mc <消息>           -> 向游戏内发送消息（可以触发游戏内关键词）
#风格                -> 机器人风格帮助
#游戏关键词 列表     -> 显示现有游戏内关键词列表
#删除假人 <假人名字> -> 删除游戏内指定假人

关键词相关: 
#添加 <关键词> <回复> -> 添加游戏内关键词回复
#添加图片 <关键词>    -> 添加关键词图片
#删除 <关键词>        -> 删除关键词
#列表                 -> 获取关键词回复列表
#帮助                 -> 查看关键词相关帮助

管理功能(管理员私聊触发)

管理员命令帮助如下
#绑定   -> 查看绑定相关帮助
#白名单 -> 查看白名单相关帮助
#启动指令 -> 查看启动指令相关帮助
#违禁词 -> 查看违禁词相关帮助
#关键词 -> 查看关键词相关帮助
#游戏内关键词 -> 查看游戏内关键词相关帮助
#uuid   -> 查看uuid 匹配相关帮助
#名字   -> 查看机器人名字相关帮助
#审核   -> 协助审核功能
#执行 <command> -> 执行指令
#重启 -> 重载机器人

配置

机器人的必要配置

配置项	默认值	说明
正向websocket服务端口	`8080`	接收数据上报的端口
消息上报格式	CQ码	机器人基于CQ码进行解析

前置cq_qq_api配置

配置项	默认值	说明
host	`127.0.0.1`	接收数据上报的地址
port	`8080`	对应数据上报的端口
post_path	""	对应数据上报的终点名
token	""	对应数据上报的token，用于加密信息

{
    "host": "127.0.0.1",
    "port": 8080,
    "post_path": "",
    "token": ""
}

以上为正向websocket

GUGUbot机器人配置

Important

非常建议看看默认的配置文件

QQ相关设置 - 必要项

admin_id: 管理员QQ号默认拥有GUGUbot管理员权限(仅私聊)
group_id: 聊天转发的群

QQ相关设置 - 可选项

请前往：GUGUbot - 配置 - 腾讯文档

有BUG或是新的IDEA

如果需要更多联动或提交想法和问题请提交 issues 或 QQ 1377820366 提交！
如需要帮助或者交流请通过 QQ群 726741344 进行询问或者交流
视情况添加，请勿联系他人（开发者: 雪开）

TODO

贡献

代码贡献: QQChat | AnzhiZhang

技术支持: XueK__