HuHoBotPenguin v1.0.0
🐧 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
📦 安装
- 安装 LSE Node 引擎:
lip install github.com/LiteLDev/LegacyScriptEngine - 将插件目录放入
plugins/HuHoBotPenguin-LLSE/ - 编辑
config.json填入bot.app-id/bot.secret(QQ 开放平台 WebSocket 接入)与目标群 OpenID - 重启服务器,控制台出现
QQ 机器人已连接即成功
首次启动会自动生成
config.json(含默认值)。BDS 1.21+ 使用allowlist命令体系,旧版 BDS 请将白名单相关命令模板改回whitelist。
⚠️ 注意事项
- 正式环境:本版本固定连接正式网关(
api.bot.qq.com),机器人需提审上线后才收得到群事件 - 机器人在群里需被群主"添加到群聊",且开启"机器人主动在群聊内发言"
📜 License
MIT © 2026 Mell