快速开始
简介
HuHoBotPenguin 是一个 Minecraft 基岩版（BDS）服务器的 QQ 开放平台机器人接入插件，运行在 LeviLamina（LLSE Node.js）环境下。
支持游戏内聊天与 QQ 群双向转发、20+ 群指令、MOTD 状态图、敏感词审核等功能。AI 版还内置 LLM AI 助理和 WebUI 管理面板。
环境要求
- Minecraft 基岩版服务端（BDS）
- LeviLamina 已安装
- LSE Node 引擎
- QQ 开放平台机器人账号（AppID + Secret）
安装步骤
1. 安装 LSE Node 引擎
在服务器控制台执行：
lip install github.com/LiteLDev/LegacyScriptEngine
2. 下载插件
从插件中心下载 HuHoBotPenguin 压缩包。
提供两个版本，按需选择：
| 版本 | 说明 |
|---|---|
| 标准版 | QQ ↔ BDS 双向转发、群指令、MOTD 状态图、Markdown 卡片 |
| AI 版（Llama） | 标准版全部功能 + LLM AI 助理 + function calling + WebUI 管理面板 |
不需要 AI 功能请用标准版；需要 AI 对话/管理面板请用 AI 版。
3. 部署插件
解压下载的 zip 文件到服务器的 plugins/ 目录下：
- 标准版：
plugins/HuHoBotPenguin-LLSE/ - AI 版：
plugins/HuHoBotPenguin-LLSE-Llama/
4. 配置机器人
首次启动服务器后，插件会自动在 plugins/HuHoBotPenguin-LLSE/ 目录下生成 config.json。
关闭服务器，编辑 config.json，填入你的 QQ 机器人信息：
{ "bot": { "app-id": "你的QQ机器人AppID", "secret": "你的QQ机器人Secret" } }
AppID 和 Secret 在 QQ 开放平台 创建机器人后获取。
5. 启动服务器
重新启动服务器，控制台出现以下提示即表示连接成功：
QQ 机器人已连接
基本使用
游戏内聊天转发
在游戏内发送以 # 开头的消息，会自动转发到 QQ 群：
#大家好，我是服务器玩家！
QQ 群指令
在 QQ 群 @ 机器人发送指令：
| 指令 | 功能 |
|---|---|
| 查在线 | 查看服务器在线玩家 |
| 查白名单 | 查看白名单列表 |
| motd | 查看服务器状态图 |
共 20+ 群指令，完整列表请查看后续文档。
控制台命令
在服务器控制台输入：
huhobot reload # 重载配置 huhobot info # 查看插件信息
常见问题
Q: 启动后没有连接成功？
检查以下几点：
config.json里的app-id和secret是否正确- 服务器是否能访问外网（需要连接 QQ 开放平台 WebSocket）
- LSE Node 引擎是否正确安装
Q: 游戏内消息没有转发到 QQ 群？
- 确认消息以
#开头 - 检查
config.json中的转发开关是否开启
Q: 如何使用 AI 功能？
AI 功能仅限 AI 版（Llama），需要在 config.json 中配置 LLM 接口（支持 OpenAI 兼容接口，如 Ollama、DeepSeek、Qwen、GPT 等）。