?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacks
Settings
Velocity Limbo Handler

Velocity Limbo Handler

A simple plugin for handling limbo reconnection/handling

1,847
7

Compatibility

Minecraft: Java Edition

1.21.x
1.20.x
1.19.x
1.18.x
1.17.x
1.16.x
1.15.x
1.14.x
1.13.x
1.12.x
1.11.x
1.10.x
1.9.x
1.8.x

Platforms

Links

Report issues View source Visit wiki

Creators

AkselGlyholt
AkselGlyholtMember

Details

Licensed GPL-3.0-or-later
Published 9 months ago
Updated 3 weeks ago

⚡ Velocity Limbo Handler

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

GitHub release GitHub downloads Servers License Modrinth

✨ 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.