⚡ 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
• LibreLogin Ready – seamless integration with authentication

Full setup & advanced features in the Wiki.

Compatibility

• ️ Proxy: Velocity (all recent versions)
• MC Versions: 1.8 → 1.21+
• License: GPL-3.0

Quick Install

1. Grab the latest .jar from Releases.
2. Drop it into your Velocity plugins folder.
3. Restart the proxy (config files will generate).
4. Adjust config.yml + messages.yml to your liking.
5. 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: 3 # Queue processing interval (seconds)
queue-notify-interval: 30 # How often to tell players their position
disabled-commands: ["server","hub"] # Commands blocked in limbo

Messages can be tweaked in messages.yml so your players see exactly what you want.

Proxy Setup Example
[servers]
default = "lobby"
limbo = "limbo"

[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 GPL-3.0 — free to use, modify, and share under the same license.