Velocity Limbo Handler icon

Velocity Limbo Handler -----

A simple plugin for handling limbo reconnection/handling




Patch Notes — v1.6.2
What’s New
  • Bugfix: Improved CloudNet support.
    This update resolves issues that caused inconsistent behavior when using CloudNet with the plugin.
Links
Full changelog: v1.6.1 → v1.6.2
----------, Oct 5, 2025

Bug Fixes

  • Fixed an issue where players could still be kicked for auth timeout even after authenticating with LibreLogin. This happened due to event ordering between Velocity and LibreLogin. Blocking now happens earlier in the login pipeline, ensuring proper unblock order.
Improvements

  • Logs are clearer: integration with LibreLogin is only logged if the plugin is truly active.
Notes

  • This release should resolve the “authenticated but still kicked” bug some servers experienced with LibreLogin.
----------, Sep 10, 2025

Velocity Limbo Handler 1.6.0 – LibreLogin Integration
This update adds native support for LibreLogin authentication and smarter queue handling for players who haven’t logged in yet.

✨ New Features
LibreLogin Auto-Detection
  • Automatically detects the librelogin plugin at runtime — no configuration needed.
  • Uses reflection to hook into getLibreLogin().getEventProvider() and listen for the authenticated event.
  • Instantly unblocks players from Limbo as soon as they authenticate.
Auth-Aware Queue System
  • Players awaiting authentication are not placed into the reconnect queue.
  • On successful authentication, players are seamlessly restored to their correct per-server queue position.
  • Configurable timeout for authentication waiting (-1 to disable).
⚡ Improvements
  • Queue processing now skips blocked players, so pending logins never delay others.
  • Player re-queuing after authentication happens automatically — no manual action required.
Bug Fixes
  • Fixed rare edge cases where reconnects during authentication could misplace players in the queue.
Notes
  • If LibreLogin is not installed, the plugin behaves exactly as before.
  • Tested on Velocity 3.4.0-SNAPSHOT with the latest LibreLogin build.
----------, Aug 12, 2025

New Features
  • Bypass Maintenance Mode: Players with permission can now skip the queue even when maintenance mode is active.
  • Per-Server Queues: Added support for separate queues per target server.
Improvements
  • Maintenance Whitelist Respect: Players on the Maintenance plugin’s whitelist are no longer blocked by the queue.
  • Logging: The logger now uses the Plugin name, instead of the Class
Cleanup & Fixes
  • Fixed a bug where players weren't properly removed from the queue.
  • General code cleanup and refactoring for better maintainability.
----------, Jul 30, 2025

What's Changed
You can now customize message inside the messages.yml file. Looking inside the file should be pretty self-explanatory, but further documentation will be added in the future.

Full Changelog: v1.3.0...v1.4.0
----------, Jul 27, 2025

What's Changed
Will now handle when the Backend server is in maintenance mode, and prevent chat/console spam by not attempting to send players through, until maintenance is back off again

Full Changelog: https://github.com/AkselGlyholt/velocity-limbo-handler/compare/v1.2.0...v1.3.0
----------, Jul 26, 2025

What's Changed
Full Changelog: v1.1.1...v1.2.0

New config section to edit disabled commands in limbo server

# A list of disabled commands, which will not work inside the Limbo server. Recommended commands are ones that the player can use to transfer server, like /server or /hub
disabled-commands: ["server", "lobby", "hub"]
----------, Jul 22, 2025

  • Fix queue message for disabled mode by @AkselGlyholt in #7
  • Fixed player reconnected to direct-connect server, and not intended server when using forced-hosts by @AkselGlyholt in #8
----------, Jul 20, 2025

Overview
This update enhances the player experience by significantly improving how connection errors are handled. Players who are banned or not whitelisted on destination servers now remain in limbo with appropriate notifications rather than being disconnected.

New Features
  • Players now receive clear, color-coded notifications when they cannot connect to a server due to bans or whitelist restrictions
  • Added persistent tracking of player connection issues (banned/not whitelisted)
  • Improved queue system to properly skip players with connection issues
Bug Fixes
  • Fixed issue where banned players were kicked from the proxy entirely
  • Fixed queue system becoming blocked when a player with connection issues was at the front of the queue
  • Fixed error message detection to properly identify ban and whitelist messages
Technical Improvements
  • Enhanced error detection by checking both exception messages and server response components
  • Improved connection failure handling with proper categorization of error types
  • Made connection issue notifications independent of queue status
Configuration
  • Added "queue-enabled" to toggle if the queue should be enabled, or just use random selection from players (Only recommended for small servers to keep it fair)
----------, Apr 11, 2025

Fixed custom servers not being loaded from config
----------, Feb 25, 2025

Resource Information
Author:
----------
Total Downloads: 540
First Release: Feb 12, 2025
Last Update: Oct 5, 2025
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings