/FlameBot

Primary LanguagePython

FlameHuo Bot 框架

针对BDS服务器推出的QQ开放平台机器人框架

  • 使用QQ开放平台开发，无违反协议规定
  • 使用Websocket协议对接

安装

  1. 安装python 3.9+
  2. 克隆本仓库
  3. 执行如下命令
pip install -r requirements.txt
  1. 将BDSAdapter中的FlameHuo.js文件放入BDS/plugins文件夹内，创建文件夹完毕后，将剩余文件放入FlameHuo文件夹
  2. 对config.json进行配置
    • sendGroupId和recvGroupId可在机器人正式上线后使用/查本群来查询
    • wsUrl在程序正常运行之后会输出
    • serverName可自行更改
    • addSimulatedPlayerTip对服内玩家列表中的模拟玩家加上(假人)的后缀

使用

  1. 在QQ开放平台中注册账号并创建机器人，具体参见QQ开放平台文档
  2. 使用如下命令运行程序
python index.py
  1. 根据程序提示输入机器人在QQ开放平台上的信息
  2. 若要屏蔽群内信息，可使用/flamehuo来进行调整
  3. 正式上线后，需要对adminList.json进行配置才有权限操作机器人

开放平台机器人配置

如需完整体验开放平台，则需要按下列操作配置指令

  1. 打开开放平台的发布设置-功能配置 发布设置
  2. 打开指令配置面板 指令配置面板
  3. 点击添加指令 添加指令
  4. 按模板配置指令(请参考下列功能一览) 模板
  • ⚠ 必须严格按照下列功能一览来填写指令，否则会审核不通过⚠
  • 提交审核后请开启审核模式，并在您的沙箱测试群中进行自测，否则会不过审!

附件（!!!下载后红字部分需修改!!!）

贡献

如果您有任何问题，请开启一个 issue 来讨论
欢迎 PR

功能一览:

指令 权限 说明
/添加白名单 {Xbox Id} 管理员 向服务器内添加一个白名单
/删除 {Xbox Id} 管理员 向服务器内删除一个白名单
/帮助 任何人 显示此帮助
/查群号 任何人 显示本群OpenId
/查自己 任何人 显示自己OpenId
/加管理 {groupId} {authorId} 管理员 为本群添加一个机器人管理员
/查管理 {groupId} {authorId} 任何人 查询此人是否为本群机器人管理员
/删管理 {groupId} {authorId} 管理员 为本群删除一个机器人管理员
/设置名称 {昵称} 任何人 设置自己在本群群服互通的名称
/发信息 {消息} 任何人 群服互通向服务器内发送消息
/执行命令 {命令} 管理员 向服务器发送执行命令的请求
/查白名单 {页码或关键词} 管理员 查询服务器内置白名单
/查在线 任何人 查询服务器在线名单
  • 注:若XboxId有空格请打上双引号,如:"XboxId"

部分功能展示

添加白名单 在线玩家列表

Todo List: