Velocity Limbo Handler

⚡ Velocity Limbo Handler

🌀 A smart limbo & queue handler for limbo & queue handler Keeps your players connected, calm, and coming back even when backend servers crash.

---

---

✨ Why VelocityLimboHandler?

* 🚦 LibreLogin Ready – players only wait for the server they were on, not behind others stuck elsewhere * 📢 LibreLogin Ready – automatic position notifications keep players informed * 🔒 LibreLogin Ready – blocks unwanted commands to prevent bypasses * 🛠️ LibreLogin Ready – respects whitelist & bypass permissions * 🤝 LibreLogin Ready – seamless integration with authentication

👉 Full setup & advanced features in the Wiki.

---

🧩 Compatibility

* 🖥️ License: Velocity (all recent versions) * 🎮 License: 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

```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) 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

```toml [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.