# HubTools - Velocity跨服务器传送管理插件
  
**HubTools** 是一款专为Minecraft Velocity代理设计的跨服务器传送管理插件。当玩家从非指定服务器退出时，下次登录时将被自动传送到目标服务器上预定义的坐标。
> **注意**: 此插件由AI开发，旨在简化跨服务器传送并增强玩家体验。
---
## 特性
- **智能传送**:
- 记录玩家退出服务器的位置
- 如果退出发生在目标服务器之外，则强制传送至预设坐标
- **多条件检查**:
- 验证服务器名称与配置文件
- 支持动态坐标（X/Y/Z），并可自定义目标世界
- **自动数据清理**:
- 传送后自动删除玩家记录，以节省存储空间
- **实时同步**:
- 使用插件消息通道与下游服务器进行实时通信
- **可配置灵活性**:
- 可自定义目标服务器、世界名称和坐标
- 与 Velocity 3.4.0+ 和 Paper 1.16.5+ 兼容
---
## 安装
### 1. 下载
从 [GitHub](https://github.com/NSrank/HubTools) 或其他分发渠道下载最新的 `HubTools.jar`。
### 2. 安装到 Velocity
将 `HubTools.jar` 放置到您的 Velocity 代理的 `plugins/` 目录中。
### 3. 安装到 Paper (可选)
将 `HubTools-Paper.jar` 放置到 **所有下游服务器** 的 `plugins/` 目录中（用于接收传送坐标）。
### 4. 启动服务器
首次启动时，会自动生成配置文件 `plugins/HubTools/config.yml`。
---
## 配置文件 (`config.yml`)
```yaml
server: lobby # 目标下游服务器名称
world: world # 目标世界名称
x: 0.5 # 传送坐标（支持小数）
y: 64.0
z: 0.5
```
## 参数
- `server`: Velocity中注册的下游服务器名称，默认为 `"lobby"`。
- `world`: 目标世界名称，默认为 `"world"`。
- `x`: 传送的X坐标，默认为 `0.5`。
- `y`: 传送的Y坐标，默认为 `64.0`。
- `z`: 传送的Z坐标，默认为 `0.5`。
---
### 支持 & 反馈
对于问题或建议，请通过以下方式联系我们:
- **GitHub Issues**: [提交问题](https://github.com/NSrank/HubTools/issues)
---
### 许可 & 版权
- 开发声明：此插件由AI为Minecraft Velocity社区开发，旨在提供高效的跨服务器传送管理工具。
- 许可：此插件在GNU通用公共许可证v3.0下获得许可。您可以遵守许可条款自由に使用、修改和分发。
- 免责声明：开发者不对因使用此插件引起的问题负责。
---
## 致谢
特别感谢:
- [Velocity API](https://papermc.io/software/velocity)
- [Configurate](https://github.com/SpongePowered/configurate?spm=a2ty_o01.29997173.0.0.26755171KBaIXA)
- [Adventure API](https://github.com/KyoriPowered/adventure?spm=a2ty_o01.29997173.0.0.7c5733f51H3mj8)
---