Compatibility
Minecraft: Java Edition
Platforms
Creators
Details
🌐 VelocityLimboHandler | Fallback Server Handler for Velocity
Effortlessly manage player reconnections with a structured queue system!
About
VelocityLimboHandler is a simple yet powerful Velocity proxy plugin that manages player fallback handling when a server becomes unavailable. Instead of leaving players stranded in Limbo, it systematically reconnects them to their last known server or a designated lobby.
- Queue-based Reconnection – Ensures players are reconnected in an orderly manner.
- Customizable – Configure the limbo and fallback settings to fit your needs.
- Supports Any Limbo Server – Optimized for LOOHP's Limbo, but adaptable to others.
Installation
- Download the latest release.
- Place it in the
plugins
folder of your Velocity proxy. - Restart the proxy to generate the configuration files.
- Configure the proxy, Limbo server, and plugin as needed.
- Restart the proxy once again.
Configuration
After installation, configure the plugin via:
plugins/velocity-limbo-handler/config.yml
Required Settings:
limbo-name
(default:Limbo
) – Name of the Limbo server in Velocity.direct-connect-server
(default:default
) – The server where direct connections should be sent.
Optional Settings:
-
task-interval
(default:3
) – Time (seconds) between connection attempts. -
queue-notify-interval
(default:30
) – How often players are notified of their queue position. -
disabled-commands
(default:["server", "lobby", "hub"]
– Commands that won't work inside the limbo server. -
messages.yml
is now editable for all in-plugin feedback texts -
Maintenance integration is automatic if you're using a compatiable plugin. (Check Wiki)
-
Disable commands inside Limbo to prevent exploitation via
/server
Setting Up the Proxy & Limbo
VelocityLimboHandler does not provide a built-in fallback system, so you'll need to configure your Velocity proxy to send players to Limbo when their target server is unavailable.
Example Proxy Configuration (try orders):
[servers]
try = ["default", "limbo"]
Example Using Forced Hosts:
[forced-hosts]
"build.example.com" = ["build", "limbo"]
"pvp.example.com" = ["pvp", "limbo"]
License
This plugin is open-source under the GPLv3 License.
Need help or have suggestions? Feel free to open an issue on GitHub! 🚀