Bngeuit

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

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

提示

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

核心特性

• 开箱即用：下载 JAR，填写 BotAppID 和 Secret，一键启动。
• 插件化架构：JAR 丢进 plugins/ 目录即可加载，每个插件拥有独立的 ClassLoader 和配置空间。
• 事件驱动：18 种接收事件（群消息、私聊、成员变动、互动、生命周期就绪等）+ 28 种发送事件（操作前触发、可取消、带优先级）+ 28 种后置事件（操作成功后触发，携带响应体），通过 @SubscribeEvent 注解即可监听。
• 注解式命令：@Command + @CommandBody 定义主子命令，自动扫描注册，支持 插件名:命令 命名空间。
• Tab 补全：@TabComplete 注解支持命令参数自动补全，提升控制台交互体验。
• 内置消息命令：/c2c send/media 和 /group send/media 支持发送文本、Markdown、媒体文件，支持 ()xxx 读取配置。
• 全 API 覆盖：消息发送（文本 / Markdown / 图文卡片 / 富媒体）、富媒体上传（公网 URL / 本地文件分片）、消息撤回、互动响应、群信息查询、群成员与黑名单管理。
• 素材管理：图片预上传为平台素材，用 qqbot-media:// 链接在 Markdown 里反复引用，不依赖公网图床（见 素材管理）。
• 脚本插件：plugins/*.js 即插即用，无需编译、支持热加载——通过内置 bngeuit 桥接对象注册事件与命令（见 脚本插件）。
• 双接入模式：bot.mode 二选一——WebSocket 网关长连接（默认，自动重连）或 Webhook HTTP 回调（零出站连接，需公网 HTTPS 回调地址，见 Webhook 模式）。
• 全局统一日志：框架与插件共用 bngeuit Logger，支持 /log level 命令热修改日志级别。

系统要求

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

创建机器人

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