Skip to content

HuHoBotPenguin v1.0.0

Choose a tag to compare

@Beeeee-really Beeeee-really released this 15 Aug 02:43
· 9 commits to main since this release

🐧 HuHoBotPenguin v1.0.0

QQ 开放平台官方机器人 ↔ Minecraft 基岩版 BDS 服务器聊天/命令桥接插件(LeviLamina / LLSE Node.js 后端),由 HuHoBot/PenguinClient(Java 版)移植而来。

✨ 功能特性

  • 游戏 ↔ QQ 双向转发:游戏内 #消息 → QQ 群;群内 @机器人 命令/消息 → 游戏
  • 20 个群指令:查在线、查白名单、白名单增删、管理员管理、认证、发信息、全量转发等,可逐个开关
  • 📋 Markdown 卡片查在线 / 查白名单 以 Markdown 卡片展示(msg_type=2,官方已向所有机器人开放,无需申请模板)
  • 敏感词审核:正则 + 本地词库 + 可选 OpenAI 兼容 AI 二审,接口不可用时自动回退本地屏蔽
  • 自定义命令:占位符替换({params} / {group} / {user} / {0}…)+ 权限分级
  • 多群独立:每群独立的管理员名单、认证状态与全量转发开关
  • 进服/退服通知:🟢/🔴 事件推送,模板可配
  • 控制台命令huhobot reload(热重载配置,无需重启服务器)/ huhobot info
  • LuckyClover 联动:导出 ll.imports("HuHoBotPenguin", "send") 接口
  • 零 npm 依赖:自实现最小 RFC6455 WebSocket 客户端 + TLS,REST 走内置 https

📦 安装

  1. 安装 LSE Node 引擎:lip install github.com/LiteLDev/LegacyScriptEngine
  2. 将插件目录放入 plugins/HuHoBotPenguin-LLSE/
  3. 编辑 config.json 填入 bot.app-id / bot.secret(QQ 开放平台 WebSocket 接入)与目标群 OpenID
  4. 重启服务器,控制台出现 QQ 机器人已连接 即成功

首次启动会自动生成 config.json(含默认值)。BDS 1.21+ 使用 allowlist 命令体系,旧版 BDS 请将白名单相关命令模板改回 whitelist

⚠️ 注意事项

  • 正式环境:本版本固定连接正式网关(api.bot.qq.com),机器人需提审上线后才收得到群事件
  • 机器人在群里需被群主"添加到群聊",且开启"机器人主动在群聊内发言"

📜 License

MIT © 2026 Mell