Skip to content

Bngeuit

Bngeuit 是一款使用 Java 21 编写的 QQ 机器人软件API,为 QQ 官方群聊和私聊机器人提供运行时环境和插件框架,本体永久免费。

你只需下载、配置、启动,然后通过开发插件来扩展机器人功能。

提示

因腾讯权限限制,机器人无法获取任何QQ群和QQ用户的账号,使用的是 按机器人AppID维度隔离的OpenID(包括群OpenID和成员OpenID)

核心特性

  • 开箱即用:下载 JAR,填写 BotAppID 和 Secret,一键启动。
  • 插件化架构:JAR 丢进 plugins/ 目录即可加载,每个插件拥有独立的 ClassLoader 和配置空间。
  • 事件驱动:17 种接收事件(群消息、私聊、成员变动、互动、生命周期就绪等)+ 14 种发送事件(可取消、带优先级),通过 @SubscribeEvent 注解即可监听。
  • 注解式命令@Command + @CommandBody 定义主子命令,自动扫描注册,支持 插件名:命令 命名空间。
  • 全 API 覆盖:消息发送(文本 / Markdown / 图文卡片 / 富媒体)、富媒体上传(公网 URL / 本地文件分片)、消息撤回、互动响应、群信息查询。
  • 脚本插件plugins/*.js 即插即用,无需编译、支持热加载——通过内置 bngeuit 桥接对象注册事件与命令(见 脚本插件)。
  • 双接入模式bot.mode 二选一——WebSocket 网关长连接(默认,自动重连)或 Webhook HTTP 回调(零出站连接,需公网 HTTPS 回调地址,见 Webhook 模式)。

系统要求

  • JDK 21+
  • QQ 机器人开发者账号(QQ 开放平台 注册)
  • BotAppID 和 BotAppSecret

创建机器人

通过 QQ 开放平台 创建机器人,获取 BotAppID 和 BotAppSecret。