CoreHub 返回大厅传送插件

CoreHub 中枢大厅传送插件

> 一款轻量、易用的 Velocity 代理端插件，让玩家通过 /hub 或 /lobby 一键传送到指定的大厅（hub）服务器，支持自定义消息、权限控制与热重载，配置零负担。
基本信息

| 项目 | 信息 |
| --- | --- |
| 插件名称 | CoreHub |
| 开发者 | 页面未明确署名（Modrinth 项目页） |
| 最新版本 | 1.01 |
| 许可协议 | ARR（保留所有权利，免费使用） |
| 兼容版本 | 1.18.x、1.19.x、1.20.x、1.21.x、26.1.x |
| 运行平台 | Velocity（代理端） |
| 运行环境 | Velocity 代理服务端 |
| 项目地址 | https://modrinth.com/plugin/corehub |
| 官方文档 | 见插件内 config.yml 注释 |
简介

CoreHub 是一款面向 Velocity 代理网络的轻量传送插件。它允许玩家用简单的命令（/hub 或 /lobby）瞬间连接到网络中指定的大厅（hub / lobby）服务器，专为"所有玩家共用一个中央大厅"的网络架构设计，体验流畅、配置极简。

插件提供完整的消息自定义、权限控制（corehub.use 控制使用、corehub.reload 控制重载）以及免重启热重载能力，管理员可在不重启代理的情况下更新提示文案或切换大厅服务器。整个插件对 Velocity 代理的开销极小，即插即用。
核心特性
一键回厅
玩家执行 /hub 或 /lobby 即可立即传送到大厅服务器，适合登录落地、死亡回厅、菜单返回等场景。
双命令别名
/hub 与 /lobby 指向同一功能，玩家习惯哪个用哪个，无需额外配置。
消息全自定义
传送成功、权限不足、已在大厅、配置重载等提示均可在 config.yml 中自定义，方便适配服务器风格与语言，支持 & 颜色代码。
权限系统
corehub.use：允许使用 /hub、/lobby 传送到大厅，无权限者收到"no-permission"提示
corehub.reload：允许重载配置；控制台始终可执行重载命令，不受权限限制
配置热重载
支持在游戏内或控制台执行 /corehubreload 重新加载配置，修改消息或切换大厅服务器均无需重启代理。
轻量高性能
逻辑极简，对 Velocity 代理的性能开销几乎可以忽略。
环境要求

| 项目 | 要求 |
| --- | --- |
| 服务端 | Velocity 代理端（需搭配至少一个后端大厅服务器） |
| 兼容客户端版本 | 1.18.x – 26.1.x（跟随 Velocity 代理） |
| 前置依赖 | 无 |
安装方法
从 Modrinth 下载 CoreHub 的 jar 文件
将 jar 放入 Velocity 代理的 plugins/ 目录
启动（或重启）Velocity 代理，生成默认 config.yml
编辑 plugins/CoreHub/config.yml，将 hub-server 改为你网络中大厅服务器的注册名
执行 /corehubreload 使配置生效

> 升级提醒：CoreHub 仅运行于 Velocity 代理端，不安装在各后端 Spigot/Paper 服务器上；请确保 hub-server 填写的是 Velocity 配置中 register 的实际服务器名，否则传送会失败。
命令与权限
命令

| 命令 | 说明 | 用法示例 |
| --- | --- | --- |
| /hub | 将玩家传送到大厅服务器 | /hub |
| /lobby | /hub 的别名 | /lobby |
| /corehubreload | 重载插件配置，控制台或有权限的玩家可执行 | /corehubreload |
权限

| 权限 | 说明 | 默认 |
| --- | --- | --- |
| corehub.use | 允许使用 /hub、/lobby 传送到大厅；无权限者收到"no-permission"提示 | 建议 OP/全体按需分配 |
| corehub.reload | 允许使用 /corehubreload 重载配置；控制台始终可执行 | ⚠️ 仅管理员 |

| 字段 | 说明 |
| --- | --- |
| hub-server | 玩家将被传送到的目标大厅服务器名（须与 Velocity 注册的服务器名一致）|
| messages.no-permission | 无 corehub.use 权限时显示的提示 |
| messages.sent-to-hub | 传送成功时的提示 |
| messages.already-in-hub | 玩家已在大厅服务器时显示的提示 |
| messages.config-reloaded | 配置重载成功后的提示 |
使用场景
中央大厅网络：玩家登录后统一落地到 hub，再从 hub 选择进入各游戏服
死亡/退出返回：配合后端服的死亡处理，用 /hub 作为统一回厅入口
菜单/命令快捷返回：在任意子服执行 /hub 或 /lobby 回到主大厅