Velocity Limbo Handler

# ⚡ VelocityLimboHandler 🌀 A smart **limbo & queue handler** for (https://velocitypowered.com) Keeps your players connected, calm, and coming back even when backend servers crash. --- !(https://img.shields.io/github/v/release/akselglyholt/velocity-limbo-handler?style=for-the-badge) !(https://img.shields.io/github/downloads/akselglyholt/velocity-limbo-handler/total?style=for-the-badge\&color=blue) !(https://img.shields.io/github/license/akselglyholt/velocity-limbo-handler?style=for-the-badge\&color=green) !(https://img.shields.io/modrinth/dt/velocity-limbo-handler?style=for-the-badge\&logo=modrinth\&label=Modrinth%20Downloads) --- ## ✨ 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 (https://github.com/AkselGlyholt/velocity-limbo-handler/wiki). Made to work with (https://github.com/LOOHP/Limbo) server, but any other server is also fine. --- ## 🧩 Compatibility * 🖥️ **Proxy:** Velocity (all recent versions) * 🎮 **MC Versions:** All versions * 📜 **License:** GPL-3.0 --- ## 🚀 Quick Install 1. Grab the latest `.jar` from (https://github.com/akselglyholt/velocity-limbo-handler/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 ```yaml # 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: # 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 ```toml default = "lobby" limbo = "limbo" "pvp.example.com" = "build.example.com" = ``` --- ## 🛡️ 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.