原创 工具 [FotiaLobby]-多服大厅、智能队列、停服迁移一体化插件 1.0.1

[MD] <div align="center"> # FotiaLobby **智能大厅 / 队列 / 路由 / 停服迁移插件**      ## 插件交流群：**767608887** ## 插件交流群：**767608887** ## 插件交流群：**767608887** </div> --- ## 插件简介 FotiaLobby 是一套面向多服架构的大厅与队列解决方案，适用于： - 大厅服 / 主城服 - 多玩法入口服 - 小游戏群组服 - 需要排队分流的服务器 - 需要停服前迁移玩家的服务器 - 使用 BungeeCord / Velocity 的多服架构 它不是单纯的传送插件，而是把： - 玩家入口 - 队列排队 - 智能路由 - 离线回退 - 停服迁移 - Hotbar 快捷栏交互 整合成一套完整方案。 --- ## 核心亮点 - **多端支持**：同时支持 Paper、BungeeCord、Velocity - **智能路由**：由代理端负责真实选服，不再本服乱传 - **离线回退**：目标组不可用时可按 `FallbackOrder` 自动回退 - **满员等待**：全满员继续排队，不会错误跳组 - **均衡分配**：先补齐低水位，再轮询分配 - **停服迁移**：`/stop` 前先疏散玩家，再执行真正关服 - **Hotbar 模板化**：物品模板独立配置，复用更方便 - **职责拆分清晰**：Paper 端管功能，代理端管路由 --- ## 为什么值得用 ### 1. 智能路由，不再傻传 玩家进入目标服务器组后，不会简单随机传送，而是由代理端根据当前服务器状态进行分配，尽量避免： - 传到离线子服 - 传到已满服务器 - 多台服务器人数长期失衡 ### 2. 满员等待，离线回退 FotiaLobby 会严格区分两种情况： - **全满员**：继续留在当前队列等待 - **全离线**：按回退顺序寻找下一可用组 这个逻辑更符合真实运营场景。 ### 3. 分配逻辑更合理 插件不是简单随机，也不是死板只看最少人数。 当前逻辑是： 1. 先补齐低水位服务器 2. 水位拉平后再轮询分配 例如人数是 `30 / 10 / 30`，会先补第二台，再进入轮询。 ### 4. 停服迁移很实用 管理员执行 `/stop` 或控制台执行 `stop` 时，插件可以先接管停服流程： 1. 开始倒计时 2. 提示在线玩家服务器即将关闭 3. 自动寻找其他可用服务器 4. 尝试迁移在线玩家 5. 最后再执行真正的关服命令 这对维护、重启、节点替换都非常实用。 --- ## 命令列表 | 命令 | 描述 | 所需权限 | |------|------|------| | `/fotialobby help` | 查看帮助信息 | `fotialobby.use` | | `/fotialobby join <服务器组>` | 加入指定服务器组队列 | `fotialobby.use` | | `/fotialobby leave` | 离开当前队列 | `fotialobby.use` | | `/fotialobby status` | 查看当前排队状态 | `fotialobby.use` | | `/fotialobby list` | 查看所有可用队列 | `fotialobby.use` | | `/fotialobby reload` | 重载插件配置 | `fotialobby.admin` | | `/login`、`/hub`、`/manhunt` 等 | 根据服务器组自动注册的快捷命令 | `fotialobby.use` + 组权限（如有） | **命令别名：** `/queue`、`/qf` --- ## 权限节点 | 权限节点 | 描述 | 默认值 | |------|------|------| | `fotialobby.*` | 所有插件权限 | `op` | | `fotialobby.use` | 基础使用权限 | `true` | | `fotialobby.admin` | 管理员权限 | `op` | | `fotialobby.reload` | 配置重载权限 | `op` | ### 服务器组自定义权限 每个服务器组还可以在 `server-groups.yml` 中单独配置 `Permission`。 例如： ```yml hub: Permission: "" vip_hub: Permission: "fotia.vip.hub" ``` 这意味着： - 普通组可以不设权限 - 特殊组可以绑定独立权限节点 --- ## 配置结构 FotiaLobby 的配置不是堆在一个文件里，而是按职责拆分： | 文件 | 作用 | |------|------| | `config.yml` | Paper 端基础配置 | | `server-groups.yml` | Paper 端功能配置 | | `hotbar-items.yml` | Hotbar 物品模板 | | `shutdown.yml` | 停服迁移配置 | | `server-groups.yml`（代理端） | 真实路由服务器列表 | | `server-hierarchy.yml` | 回退顺序配置 | 这种拆分方式后期更好维护，也更不容易改乱。 --- ## 适用场景 - 大厅服 / 主城服 - 多玩法入口服 - 小游戏群组服 - 需要排队分流的服务器 - 需要停服前迁移玩家的服务器 - 使用 BungeeCord / Velocity 的多服架构 --- ## 联系方式 <div align="center"> ## 插件交流群：**767608887** ## 插件交流群：**767608887** ## 插件交流群：**767608887** 欢迎进群交流、反馈建议、查看后续更新 </div> [/MD]