功能特性
约 1175 字大约 4 分钟
UniBot 提供丰富的功能，覆盖群服互通、图片渲染、WebUI 管理等多个方面。
群服互通
UniBot 的核心能力，是让 Minecraft 与聊天平台 实时互通：
- 游戏内实时看到 QQ 群消息
- QQ 群内看到游戏内聊天，支持文字、图片等消息类型
- 玩家 加入 / 离开 / 死亡 全事件播报
- 服务器 开启 / 关闭 自动通知
- 多服消息互转，构建分布式 MC 网络
消息同步方向
| 方向 | 配置项 | 说明 |
|---|---|---|
| 群 → 服务器 | sync_all_qq_message | 群内消息自动转发到游戏 |
| 服务器 → 群 | sync_all_game_message | 游戏内消息自动转发到群 |
| 服务器 → 服务器 | sync_message_between_servers | 多服消息互转 |
消息同步方向
事件播报
已接入的播报事件：
- 玩家加入 / 离开
- 玩家死亡
- 玩家成就
- 服务器开启 / 关闭
玩家死亡与成就事件需在 MCDR 端安装 MoreGameEvents 插件。
敏感词过滤
通过 sync_sensitive_words 配置，命中敏感词的消息不会转发到群，而是提醒违禁。
图片渲染
图片渲染让机器人的指令输出以 图片 形式发送，支持列表、运势、状态等指令，能力由渲染引擎、模板、资源三类扩展协作提供。
图片渲染功能较为独立，完整的启用步骤、配置与外观调整见 图片渲染。
WebUI 管理面板
UniBot 内置了基于 Vue 3 + Vite 构建的 Web 管理面板，通过 REST API 与后端交互。提供仪表盘实时监控、服务器 / 玩家管理、可视化配置、扩展管理、日志查看等能力，使用 WebUI 后基本无需手动修改配置文件。
- 仪表盘：实时运行状态 + 「快速开始」引导卡片
- 可视化配置：
Config.toml/.env/Messages.toml分组编辑，Schema 校验 - 服务器 / 玩家 / 适配器 / 插件 / 扩展：一站式管理
- 日志查看：WebSocket 实时滚动 + 级别筛选
- 登录认证：JWT + HttpOnly Cookie，管理员账户体系
注
各页面功能详解、启用方式、初始化管理员与常见问题，见 WebUI 管理面板。
扩展系统
UniBot 基于 NoneBot2 构建，可无缝接入 NB 插件商店，社区现成插件开箱即用；内置的扩展机制则让机器人能力可以像积木一样自由组合：
- 五类扩展：指令、服务、渲染引擎、模板、资源，按需安装、按需启停。
- 开箱即用：内置指令与模板均已预置，无需额外配置。
- 稳定可靠：单个扩展异常不会拖垮整个机器人，失效扩展会被自动隔离并标注原因。
- 依赖感知：扩展间的依赖关系自动解析，缺失或版本不兼容时会明确提示。
- 可视化管理：WebUI 中即可完成扩展的启停、配置与渲染引擎 / 模板切换。
- AI 零代码开发：不会写代码也能做扩展 —— WebUI 扩展页右上角「创意工坊」一键启动 AiStudio，用自然语言描述需求即可自动生成、校验并安装扩展。
更详细的说明见 扩展系统。
白名单管理
完善的平台账号与游戏 ID 绑定系统：
- 支持多服白名单同步。
- 绑定数量可配置（
qq_bound_max_number）。 - 通过
/bound指令即可管理。
对比同类方案
| 特性 | UniBot | 传统方案 |
|---|---|---|
| 多平台支持 | QQ / Telegram / Discord / Kook… | 通常仅 QQ |
| 多服互联 | 原生支持，消息互转 | 需自行改装 |
| WebSocket 通信 | 实时长连接 | 多为 HTTP 轮询 |
| 扩展系统 | 指令 / 服务 / 渲染 / 模板 / 资源，即插即用 | 单体耦合 |
| NoneBot2 生态 | 无缝接入 NB 插件商店 | 闭源自研 |
| WebUI | Vue 3 管理面板 | 无 |
| 图片渲染 | HTML/CSS 模板引擎 | 无 |
| 白名单管理 | 完善的绑定系统 | 无或基础 |
对比同类方案