InfiniteBot-v3 分布式QQ机器人，支持SpringBoot、Minecraft

IllTamer
1,278 阅读4分钟

本文已参与「新人创作礼」活动， 一起开启掘金创作之路。

  • 本程序在 GitHub 上开源
 .___        _____.__       .__  __        __________        __    ________
 |   | _____/ ____\__| ____ |__|/  |_  ____\______   \ _____/  |_  \_____  \
 |   |/    \   __\|  |/    \|  \   __\/ __ \|    |  _//  _ \   __\   _(__  <
 |   |   |  \  |  |  |   |  \  ||  | \  ___/|    |   (  <_> )  |    /       \
 |___|___|  /__|  |__|___|  /__||__|  \___  >______  /\____/|__|   /______  /
          \/              \/              \/       \/                     \/

声明

  • 若您在使用时有任何疑问，欢迎入群讨论咨询 QQ: 863522624

  • 若您为 Minecraft 公益服主且服务器资源难以承受 go-cqhttp 的运行，欢迎 [联系我] 。我与我的云服务很乐意为您提供一份力所能及的援助。

运行环境

前置安装

Infinite Bot v3 摒弃了以往将 Mirai 嵌入程序主体的做法，转而使用高性能机器人 go-cqhttp 所提供的 websocket 与 http 服务。因此，您在使用本程序前应该先安装开启 go-cqhttp 服务。其详细步骤如下：

  1. 获取 go-cqhttp 的最新 [release]

  2. 运行压缩包中的可执行文件，生成 http + 正向websocket 配置文件 config.yml

未找到配置文件，正在为您生成配置文件中！
请选择你需要的通信方式:
> 0: HTTP通信
> 1: 云函数服务
> 2: 正向 Websocket 通信
> 3: 反向 Websocket 通信
请输入你需要的编号(0-9)，可输入多个，同一编号也可输入多个(如: 233)
您的选择是: 0 2

  1. 配置生成的 config.yml 中的 account 与 servers 节点。

    如果您将 http 服务开放到公网，建议您额外配置 default-middlewares.access-token 字段，并将该 token 设置到 plugins\InfiniteBot3\config.yml 的 connection.authorization 字段，以对暴露在公网的 go-cqhttp 服务提供保护。

    Notice：若您将 http/websocket 服务开放到公网，供 InfiniteBot 远程访问，请不要忘记开放对应端口。

  2. 运行可执行文件，开启 go-cqhttp 服务。

    若您先前使用过 InfiniteBot 系列插件或其它机器人插件，可将账号登录信息直接迁移，并在 go-cqhttp 配置中使用账号密码密码登录，可大大降低被风控风险。

    迁移方式

    • InfiniteBot 系列插件：将服务器主文件夹下或 plugins\InfiniteBot2 文件夹下的 InfiniteBotInfo.json 文件复制并重命名为 device.json，拷贝到 go-cqhttp 目录下
    • 其它机器人插件：将名为 device.json 与 session.token 的文件拷贝到 go-cqhttp 目录下

    账号成功登录后，您将在控制台看见以下输出

    [2022-08-09 19:52:05] [INFO]: 登录成功 欢迎使用: IllTamer
[2022-08-09 19:52:05] [INFO]: 开始加载好友列表...
[2022-08-09 19:52:05] [INFO]: 共加载 672 个好友.
[2022-08-09 19:52:05] [INFO]: 开始加载群列表...
[2022-08-09 19:52:13] [INFO]: 共加载 99 个群.
[2022-08-09 19:52:13] [INFO]: 资源初始化完成, 开始处理信息.
[2022-08-09 19:52:13] [INFO]: アトリは、高性能ですから!
[2022-08-09 19:52:13] [INFO]: CQ HTTP 服务器已启动: [::]:5700
[2022-08-09 19:52:13] [INFO]: 正在检查更新.
[2022-08-09 19:52:13] [INFO]: CQ WebSocket 服务器已启动: [::]:8080
[2022-08-09 19:52:14] [INFO]: 检查更新完成. 当前已运行最新版本.
[2022-08-09 19:52:14] [INFO]: 开始诊断网络情况

  3. 其它

Bukkit 插件安装

基于 go-cqhttp 提供的 API 服务，IB3 天然支持群组服/分布式服务。

您需要做的仅仅是在 BC 端上加载插件，与需要互通的其它子端配置相同地连接参数与 mysql 服务。 接着，您可以在不同的子端上加载不同的附属：如登陆服加载 defence-manager 开启白名单验证码服务，在生存服加载 chat-manager 运行消息互通服务...

更多信息请查看 [minecraft]

开发

InfiniteBot Expansion

更多信息请查看 [minecraft]

Maven

InfiniteBot-v3 为支持 go-cqhttp 实现了一系列包括事件监听、消息回调、end-point 快速操作等 API 。您可将 [api] 模块作为调用 go-cqhttp 的前置依赖库导入项目，进行开发。

<dependency>
    <groupId>com.illtamer.infinite.bot</groupId>
    <artifactId>api</artifactId>
    <version>3.0.0-SNAPSHOT</version>
</dependency>

毫无疑问，IB3 需要您提供您开启的 go-cqhttp 服务的详细参数以便于与机器人建立连接。请在程序中调用以下函数以便于初始化连接。

CQHttpWebSocketConfiguration.start(httpUri, wsUri, authorization, eventConsumer);

该方法最后一个参数为事件基类 Event 的 Consumer 对象，即事件的处理函数。 在 Spring 框架中，您可以调用 ApplicationEventPublisher#publish(Object) 将事件托管。

SpringBoot

InfiniteBot-v3 额外优化了在 SpringBoot 框架下的开发体验。您只需要进行以下操作即可使用 InfiniteBot

  1. 导入 ib3-spring-boot-starter
<dependency>
    <groupId>com.illtamer.infinite.bot</groupId>
    <artifactId>ib3-spring-boot-starter</artifactId>
    <version>3.0.0-SNAPSHOT</version>
</dependency>
  1. 在application.yml填写以下配置节点
bot:
  http-uri: ''
  ws-uri: ''
  authorization: ''

致谢

  • 感谢 polar、小豆子、阿丽塔、黑土、1758983508 等腐竹在测试、策划方面提供的帮助与支持

  • 感谢机器人插件的先驱者 @Albert

avatar
文章
阅读
粉丝