# ⚡ VelocityLimboHandler
🌀 一个**智能的缓刑和队列处理程序** [Velocity](https://velocitypowered.com)
即使后端服务器崩溃，也能让您的玩家保持连接、冷静并持续回来。
---
---
## ✨ 为什么选择 VelocityLimboHandler?
* 🚦 **Per-Server 智能队列** – 玩家只需等待他们所在的服务器，而不是排在其他地方卡住的玩家后面
* 📢 **队列更新** – 自动位置通知让玩家随时了解情况
* 🔒 **受保护的缓刑** – 阻止不需要的命令以防止绕过
* 🛠️ **维护支持** – 尊重白名单和绕过权限
* 🤝 **LibreLogin 兼容** – 与身份验证的无缝集成
👉 完整的设置和高级功能请查看 [Wiki](https://github.com/AkselGlyholt/velocity-limbo-handler/wiki)。
---
## 🧩 兼容性
* 🖥️ **代理:** Velocity (所有最新版本)
* 🎮 **MC 版本:** 1.8 → 1.21+
* 📜 **许可证:** GPL-3.0
---
## 🚀 快速安装
1. 从 [Releases](https://github.com/akselglyholt/velocity-limbo-handler/releases) 获取最新的 `.jar` 文件。
2. 将其放入 Velocity `plugins` 文件夹中。
3. 重启代理（将生成配置文件）。
4. 根据您的喜好调整 `config.yml` + `messages.yml`。
5. 再次重启 — 完成！ 🎉
---
## ⚙️ 配置文件摘要
```yaml
# config.yml
limbo-name: "limbo" # 您的缓刑服务器的名称
direct-connect-server: "lobby" # 将直接连接发送到哪里
task-interval: 3 # 队列处理间隔（秒）
queue-notify-interval: 30 # 告诉玩家他们位置的频率
disabled-commands: ["server","hub"] # 缓刑中阻止的命令
```
👉 可以在 `messages.yml` 中调整消息，让您的玩家看到您想要看到的精确内容。
---
## 🖧 代理设置示例
```toml
[servers]
default = "lobby"
limbo = "limbo"
[forced-hosts]
"pvp.example.com" = ["pvp", "limbo"]
"build.example.com" = ["build", "limbo"]
```
---
## 🛡️ 权限和集成
* 玩家自动进入队列，无需任何设置。
* 根据配置文件阻止命令。
* LibreLogin 支持确保登录/身份验证流程不会中断。
* 维护插件受到尊重 (包含绕过逻辑)。
---
## 🤝 贡献
欢迎拉取请求！只需遵循已有的风格即可。
请查看 `CONTRIBUTING.md` 了解详情。
---
## 📖 许可证
该项目采用 **GPL-3.0** 许可证 — 可以在相同的许可证下自由使用、修改和共享。