VexBot 文档

VexBot 把 QQ 群、Minecraft 服务器和社区账号连接起来。你可以在管理面板配置消息联动、玩家档案、账号注册与登录、插件、官网和备份。

当前说明对应 Bot 0.6.30 / Bukkit 游戏插件 0.5.5 / 游戏端模组 0.1.2。支持可选的 魔方财务商品与付款机器人。控制台使用用户名和密码登录，首次通过独立流程创建服主账号。项目以 VexBot 名称分发，面板和官网采用黑白 V 机器人图标；新安装的默认面板端口为 5800。Forge、NeoForge、Fabric 按游戏版本使用各自的模组。首次部署请从 快速开始 阅读；已经接好服务器，可以直接查看下面的功能指南。

项目原有配置和接入标识保持兼容，详细关系见 项目名称与兼容说明。

源码另提供默认 5801 的新版 WebUI 控制台，需要单独启动。玩家管理和网站详细设置已连接真实后台，其余页面和预览选项仍使用示例数据；玩家使用的社区官网是独立项目，默认本机预览端口为 8089。

第一次部署

顺序	操作	完成后应看到什么
1	安装 Bot：Windows 或 Linux	浏览器能登录管理面板
2	安装 Paper / Spigot / Folia 插件、Forge / NeoForge 模组 或 Fabric 模组	面板中对应服务器收到心跳
3	连接 OneBot 11 或 QQ 官机，并填写关联群	概览显示 QQ 已连接
4	测试消息同步 和 群命令	群聊和游戏能够互通，查询返回当前服务器信息

Bot、QQ 实现端和游戏服务端可以运行在同一台机器，也可以分开部署。连接地址需要由发起连接的那台机器访问；127.0.0.1 始终指那台机器自身。快速开始 会说明三个组件分别配置什么。

按功能阅读

DOCUMENT COLLECTION↗

入门与部署

共 15 篇文档，选择一篇开始阅读。

Windows / Linux 安装、QQ 接入、内置面板与新版 WebUI。

DOCUMENT COLLECTION↗

玩家与账号

共 10 篇文档，选择一篇开始阅读。

QQ 绑定、玩家档案、群命令、游戏登录与原插件密码找回。

DOCUMENT COLLECTION↗

插件与自动化

共 6 篇文档，选择一篇开始阅读。

关键词回复、定时任务、JSON 规则与指定指令图片回复。

DOCUMENT COLLECTION↗

官网与 API

共 5 篇文档，选择一篇开始阅读。

网站绑定、独立部署、注册接口与浏览器 SDK。

DOCUMENT COLLECTION↗

团队与权限

共 2 篇文档，选择一篇开始阅读。

团队账号、插件能力与运行范围。

DOCUMENT COLLECTION↗

运维与备份

共 7 篇文档，选择一篇开始阅读。

监控、统计、备份恢复、MySQL 存储及服务商商品与支付。

哪些组件需要安装

组件	用途	是否必须
VexBot	连接 QQ 与游戏，保存账号和管理设置，提供面板及 API	必须
OneBot 11 实现端	登录 QQ，将 QQ 事件发送给 Bot	OneBot 模式需要；官机通过开放平台应用接入
VexBot 游戏插件或模组	上报游戏状态，转发聊天，执行授权操作	使用 Minecraft 联动时必须
社区官网	提供网页注册、服务器状态和本人信息	可选，可使用 VexBot 官网或自己的网页
第三方登录插件	接管 Minecraft 原生认证	可选，按 适配范围 选择

Bot 使用 Python 3.11+。Bukkit 通用插件最低 Java 8，实际 Java 版本仍按游戏核心要求选择；模组按对应版本下载。Folia 使用内置或自动登录引擎。具体核心、加载器和实服验证范围以 兼容说明 为准。

查配置还是查接口

服主按操作教程在面板保存设置；开发者先确认 API 的凭据类型和权限，再使用接口参考中的示例。网站 API 密钥、玩家短期令牌、服主管理令牌与游戏服务器令牌用途不同，不能相互替代。

部署包和版本说明位于 公开 Release，无需仓库访问授权。完整源码位于 AlancoSage/StarBridge，采用 AGPL-3.0-or-later；开发与贡献见 贡献指南。原有文档地址继续可用，长篇接口和兼容资料也继续保留。