HuHoBotPenguin

基于 PenguinClient 的增强分支，在原版基础上新增绑定系统、AI Agent、WebUI 管理面板等功能。

核心优势

特性	传统方案	HuHoBotPenguin
账号安全	需要实体QQ号，存在封号风险	无QQ第三方客户端依赖，零风控
部署复杂度	需搭建完整机器人框架	即装即用，一键绑定
服务器兼容性	部分面板服不支持	全平台兼容，有网即用
协议更新影响	需要频繁适配新协议	协议无关设计，相对稳定
主动消息	普通机器人不支持	支持全量主动消息
Markdown 界面	普通机器人不支持	支持 Markdown 消息

新增功能（相比上游）

QQ 绑定系统

通过 /绑定 命令将 QQ 账号与 Minecraft 玩家绑定，支持：

• 自动白名单同步（绑定时添加，解绑时移除）
• 游戏内验证码确认（可选开启）
• 双向昵称显示（MC 显示名称 / QQ 显示名称）
• 游戏内 /at 命令发送 QQ @提醒

详细文档：绑定系统

AI Agent 管理助手

通过 /agent 命令启动 AI 会话，可执行：

• 服务器管理：查插件列表、查命令帮助、执行命令、读日志
• QQ群管理：审批入群、禁言、自动审批策略
• SKILL 系统：按需加载 Minecraft 命令语法文档
• 两种执行模式：自动执行 / 人工审批

详细文档：AI Agent

WebUI 管理面板

启动时生成密码，浏览器访问即可管理（默认端口 5678，可在 config.yml 中修改 webui-port）：

• 16 个配置分区（Bot、服务器、消息格式、Agent、自定义命令、绑定、命令黑名单等）
• 状态面板：平台、版本、连接状态、在线玩家、绑定群列表
• 表单编辑：文本、开关、标签列表、自定义命令编辑器
• WebUI 端口可配置

其他增强

• 动态 /帮助：自动列出所有内置命令、自定义命令和扩展命令，按 command key 去重
• 扩展系统：第三方插件可通过 registerAddon + registerBotCommand 注册扩展命令，自动出现在 /帮助 和 /addons 中
• 自定义命令占位符：{name}（绑定MC名）、{nickname}（QQ昵称）
• 命令黑名单：禁止通过 /执行 或 Agent 运行指定服务器命令（如 op、deop）
• MOTD 模板：motd.md 自定义查在线结果
• blockMotd / unblockMotd：按群屏蔽 MOTD 查询
• 附件解析：语音、图片、视频、文件自动转义
• @提及高亮：转发到游戏时在线玩家名蓝色高亮 + 提示音

快速开始

如何安装？请看 快速开始

命令列表

在群内输入 @HuHoBot /帮助 可快速查看命令列表。

完整命令列表：命令列表

QQ 交流群

群号：1103399514 点我加入

开源协议

GNU Affero General Public License v3.0 - 自由使用、修改和分发，但需遵守以下条款：

• 开源义务：任何衍生作品必须保持开源
• 相同许可：修改后的版本必须使用相同许可证
• 版权声明：必须保留原始版权声明
• 网络服务：通过网络提供服务时，必须向用户提供源代码

完整协议文本请查看 LICENSE 文件

第三方资源

背包查看功能使用 Faithful 32x 贴图包，遵循 Faithful License v3。

已知限制

限制	说明
背包查看 - 离线玩家	仅支持查看在线玩家背包，离线玩家无法查看
背包查看 - 贴图覆盖	Faithful 32x 未覆盖所有方块/物品，部分显示为 unknown.png（铁砧、箱子、漏斗、床、旗帜、潜影盒、头颅等）
背包查看 - 动画贴图	动画贴图（如命令方块）仅渲染第一帧
背包查看 - 皮肤渲染	玩家皮肤为 2D 正面视图，不支持 3D 旋转
非 Spigot 平台	Nukkit、Velocity、BungeeCord、Allay 适配待完成