⚡ VelocityLimboHandler
? 一个用于 Velocity 的智能 limbo & 队列处理器
即使后端服务器崩溃,也能确保玩家保持连接、情绪稳定并愿意再次回来。
✨ 为什么选择 VelocityLimboHandler?
- ? 按服务器智能排队 – 玩家只需等待他们所在的服务器,而不会卡在别处受阻的服务器后面
- ? 队列更新 – 自动发送位置通知,让玩家了解当前状况
- ? 受保护的 Limbo – 阻止不需要的命令以防止绕过机制
- ?️ 维护支持 – 尊重白名单和绕过权限
- ? 身份验证就绪 – 与 LibreLogin 或 nLogin 等身份验证插件无缝集成
? 完整设置及高级功能请参阅 Wiki。
专为配合 LOOHP's Limbo 服务器使用而设计,但其他任何服务器也同样适用。
? 兼容性
- ?️ 代理: Velocity(所有近期版本)
- ? MC 版本: 所有版本
- ? 许可证: MIT
? 快速安装
- 从 Releases 获取最新的
.jar文件。 - 将其放入 Velocity 的
plugins文件夹中。 - 重启代理(配置文件将自动生成)。
- 根据需要调整
config.yml和messages.yml。 - 再次重启——完成! ?
⚙️ 配置亮点
# config.yml
limbo-name: "limbo" # 你的 limbo 服务器名称
direct-connect-server: "lobby" # 直接连接将发送至何处
task-interval: 3000 # 队列处理间隔(毫秒)
reconnect-batch-size: 8 # 每次处理运行检查的后端队列最大数量
queue-notify-interval: 30 # 告知玩家其位置的频率
queue-notify-batch-size: 64 # 每个调度器刻度发送的最大到期通知数量
disabled-commands: ["server","hub"] # 在 limbo 中被阻止的命令
批量限制有助于跨调度器刻度平滑工作。对于非常大的网络,可以增加它们以加快追赶速度;或者降低它们以限制受限代理上的短暂 CPU 峰值。
? 可以在 messages.yml 中自定义消息,以便让你的玩家看到你想要的内容。
? 代理设置示例
[servers]
lobby = "127.0.0.1:25566"
limbo = "127.0.0.1:25569"
# 保持正常登录在 Lobby。VLH 会拦截当前后端本身的丢失。
try = ["lobby", "limbo"]
[advanced]
# VLH 需要在非优雅断开后端连接后恢复玩家。
failover-on-unexpected-server-disconnect = true
[forced-hosts]
"pvp.example.com" = ["pvp", "limbo"]
"build.example.com" = ["build", "limbo"]
?️ 权限与集成
- 玩家会自动进入队列,无需额外设置。
- 根据配置阻止命令。
- 支持 LibreLogin,确保登录/身份验证流程不被破坏。
- 尊重维护插件(包含绕过逻辑)。
? 贡献
欢迎提交 Pull Request!只需遵循现有的代码风格即可。
详细信息请查看 CONTRIBUTING.md。
? 许可证
采用 MIT 许可,可免费使用、修改和分发,包括在闭源项目中。详情请参见 LICENSE。
⚡ VelocityLimboHandler
? A smart limbo & queue handler for Velocity
Keeps your players connected, calm, and coming back even when backend servers crash.
✨ Why VelocityLimboHandler?
- ? Per-Server Smart Queue – players only wait for the server they were on, not behind others stuck elsewhere
- ? Queue Updates – automatic position notifications keep players informed
- ? Protected Limbo – blocks unwanted commands to prevent bypasses
- ?️ Maintenance Support – respects whitelist & bypass permissions
- ? Authentication Ready – seamless integration with authentication plugins such as LibreLogin or nLogin
? Full setup & advanced features in the Wiki.
Made to work with LOOHP's Limbo server, but any other server is also fine.
? Compatibility
- ?️ Proxy: Velocity (all recent versions)
- ? MC Versions: All versions
- ? License: MIT
? Quick Install
- Grab the latest
.jarfrom Releases. - Drop it into your Velocity
pluginsfolder. - Restart the proxy (config files will generate).
- Adjust
config.yml+messages.ymlto your liking. - Restart once more — done! ?
⚙️ Config Highlights
# config.yml
limbo-name: "limbo" # The name of your limbo server
direct-connect-server: "lobby" # Where to send direct connections
task-interval: 3000 # Queue processing interval (milliseconds)
reconnect-batch-size: 8 # Maximum backend queues checked per processing run
queue-notify-interval: 30 # How often to tell players their position
queue-notify-batch-size: 64 # Maximum due notifications sent per dispatcher tick
disabled-commands: ["server","hub"] # Commands blocked in limbo
The batch limits smooth work across scheduler ticks. Increase them for faster catch-up on very large networks, or lower them to cap short CPU bursts on constrained proxies.
? Messages can be tweaked in messages.yml so your players see exactly what you want.
? Proxy Setup Example
[servers]
lobby = "127.0.0.1:25566"
limbo = "127.0.0.1:25569"
# Keep normal logins on Lobby. VLH intercepts a loss of the current backend itself.
try = ["lobby", "limbo"]
[advanced]
# Required for VLH to recover players after an ungraceful backend disconnect.
failover-on-unexpected-server-disconnect = true
[forced-hosts]
"pvp.example.com" = ["pvp", "limbo"]
"build.example.com" = ["build", "limbo"]
?️ Permissions & Integrations
- Players get queued automatically, no setup required.
- Commands blocked per config.
- LibreLogin support ensures login/auth flow isn’t broken.
- Maintenance plugins are respected (bypass logic included).
? Contributing
Pull requests are welcome! Just follow the style already in place.
Check CONTRIBUTING.md for details.
? License
Licensed under MIT, free to use, modify, and distribute, including in closed-source projects. See LICENSE for details.
下载 Velocity Limbo Handler
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Velocity Limbo Handler
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Velocity Limbo Handler
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Velocity Limbo Handler
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Velocity Limbo Handler
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Velocity Limbo Handler
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Velocity Limbo Handler
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Velocity Limbo Handler
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Velocity Limbo Handler
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Velocity Limbo Handler
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
VLH 2.0.0 新增了一个公开的开发者 API,使其他 Velocity 插件能够与 limbo(暂留状态)和重连队列协同工作。对于服务器管理员而言,这是从 1.8.x 版本的无缝升级。
新功能
- 开发者 API v1:Velocity 插件可以将玩家移入 limbo、使用暂停功能暂停玩家或整个服务器、更改玩家的目的地、读取队列状态,并响应 limbo 事件。请参阅 开发者 API v1 指南。
/vlh status中的暂停状态显示:状态命令现在会显示当前被暂停的玩家和服务器数量。- 版本检查器:启动时,VLH 会在后台检查是否有新版本发布,如果存在则记录下载链接。如果检查失败,启动过程将正常继续。
- 调试选项:设置
debug: true可在排查配置或插件冲突时记录虚拟主机解析、队列分配和延迟测试结果。
改进
- 大型网络下的性能优化:队列查找已建立索引,队列位置已缓存。仅处理有等待玩家的队列。后端延迟测试进行了合并、短暂缓存,并对离线服务器进行退避处理。
- 调优选项:
reconnect-batch-size(默认值8)和queue-notify-batch-size(默认值64)将重连和通知任务分散到多个游戏刻中执行,使大型网络能够在追赶速度与调度器负载之间取得平衡。 - 更安全的重载与启动:
/vlh reload一次性应用新配置,并拒绝无效的服务器名称,而不是部分应用。如果配置无法加载,VLH 将在启动时停止运行。
修复
- 后端断开连接后,玩家能正确恢复。
- 后端延迟测试后会重新检查维护状态。
- 断开原因匹配不再依赖服务器的区域设置。
- 代理关闭时,计划任务会被干净地取消。
升级指南
- 替换插件 JAR 文件。现有的
config.yml会自动更新以包含新选项,无需其他更改。 - 仍需 Java 21。
- VLH 现采用 MIT 许可证(此前为 GPL-3.0)。
面向开发者
通过 JitPack 将 API 添加为 compileOnly/provided 依赖项,并将 velocity-limbo-handler 声明为必需的 Velocity 依赖项。请勿将其阴影打包(shade)。
compileOnly("com.github.AkselGlyholt.velocity-limbo-handler:velocity-limbo-handler-api:v2.0.0")
内部的 getPlayerManager() 和 getReconnectBlocker() 访问方法已弃用。请改用 VelocityLimboApi.get(proxy)。
变更日志
- Debug option by @AkselGlyholt in
- Optimize queue processing and runtime resource usage by @AkselGlyholt in
- Version checker by @AkselGlyholt in
- feat(api): add stable developer API v1 by @AkselGlyholt in
完整更新日志:
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧