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

Velocity Limbo Handler

A simple plugin for handling limbo reconnection/handling

6,326
22
6,326
22

Compatibility

Minecraft: Java Edition

26.1.x
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

Tags

Creators

Details

Licensed GPL-3.0-or-later
Published last year

โšก 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: 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

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