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

Velocity Limbo Handler

A simple plugin for handling limbo reconnection/handling

1,098
5

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

Host your next server with Modrinth Servers

Links

Report issues View source Visit wiki

Creators

AkselGlyholt
AkselGlyholtMember

Details

Licensed GPL-3.0-or-later
Published 7 months ago
Updated last week

🌐 VelocityLimboHandler | Fallback Server Handler for Velocity

Effortlessly manage player reconnections with a structured queue system!

Active Development License: GPLv3 Download

About

VelocityLimboHandler is a simple yet powerful Velocity proxy plugin that manages player fallback handling when a server becomes unavailable. Instead of leaving players stranded in Limbo, it systematically reconnects them to their last known server or a designated lobby.

  • Queue-based Reconnection – Ensures players are reconnected in an orderly manner.
  • Customizable – Configure the limbo and fallback settings to fit your needs.
  • Supports Any Limbo Server – Optimized for LOOHP's Limbo, but adaptable to others.

Installation

  1. Download the latest release.
  2. Place it in the plugins folder of your Velocity proxy.
  3. Restart the proxy to generate the configuration files.
  4. Configure the proxy, Limbo server, and plugin as needed.
  5. Restart the proxy once again.

Configuration

After installation, configure the plugin via: plugins/velocity-limbo-handler/config.yml

Required Settings:

  • limbo-name (default: Limbo) – Name of the Limbo server in Velocity.
  • direct-connect-server (default: default) – The server where direct connections should be sent.

Optional Settings:

  • task-interval (default: 3) – Time (seconds) between connection attempts.

  • queue-notify-interval (default: 30) – How often players are notified of their queue position.

  • disabled-commands (default: ["server", "lobby", "hub"] – Commands that won't work inside the limbo server.

  • messages.yml is now editable for all in-plugin feedback texts

  • Maintenance integration is automatic if you're using a compatiable plugin. (Check Wiki)

  • Disable commands inside Limbo to prevent exploitation via /server

Setting Up the Proxy & Limbo

VelocityLimboHandler does not provide a built-in fallback system, so you'll need to configure your Velocity proxy to send players to Limbo when their target server is unavailable.

Example Proxy Configuration (try orders):

[servers]
  try = ["default", "limbo"]

Example Using Forced Hosts:

[forced-hosts]
  "build.example.com" = ["build", "limbo"]
  "pvp.example.com" = ["pvp", "limbo"]

License

This plugin is open-source under the GPLv3 License.

Need help or have suggestions? Feel free to open an issue on GitHub! 🚀