Appearance
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。
