v1.8.3

New features

• Command blocking message configuration — The message shown when commands are blocked in limbo can now be customized via config. Also includes an updated event listener for command blocking.
• Extended placeholders — Additional placeholders are now available for use in messages/config.
• Toggleable connection warnings — Connection warning messages can now be enabled or disabled in config.

Improvements

• Disconnect reason handling — Refactored to use component inspection instead of string matching, making reason detection more robust and reliable across different server implementations.

Added

• /vlh reload and /vlh status admin commands. reload hot-reloads the plugin configuration without a server restart; status provides a runtime overview of the handler's current state.

Changed

• Refactored internal queue state management for improved reliability and clarity.
• Introduced tiered priority to the reconnect queue, allowing higher-priority players or conditions to be processed ahead of the standard queue. This replaces the previous flat queue model.

26w07a Snapshot

This is a development snapshot. Expect instability. Do not deploy blindly into production. Is more or less stable, but don't trust it 100%

---

Added

/vlh Admin Commands

• Implemented /vlh reload
• Implemented /vlh status

These commands allow:

• Reloading configuration without full proxy restart
• Inspecting current limbo handler state

---

FastStats Integration

• Integrated FastStats metrics support faststats.dev

---

Full Changelog: https://github.com/AkselGlyholt/velocity-limbo-handler/compare/v1.8.1...v1.8.2-26w07a

📦 Release v1.8.1

What's Changed

• State Management: Refactored PlayerManager to use UUID-based structures. This fixes stale Player object references and improves memory safety across reconnects.
• Logic Fixes:
  • Fixed a bug in QueueNotifierTask where a single maintenance-queued player would abort the entire task.
  • Corrected ReconnectionTask maintenance bypass logic to properly handle permissions and whitelists.
  • Prevented player "starvation" by ensuring failed reconnection attempts no longer block the rest of the group.
• Optimizations: Added cached reflective lookups in Utility for maintenance API checks, reducing overhead during heavy reconnect loops.

📊 Performance Improvements (May vary depending on setup)

• CPU Optimization: Reduced core processing overhead by approximately 35% thanks to more efficient queue handling and cached reflection.
• Memory Efficiency: Drastically improved heap management. By migrating to UUIDs and pruning stale references, the memory footprint is reduced by ~50% under load compared to v1.8.0.

Full Changelog: https://github.com/AkselGlyholt/velocity-limbo-handler/compare/v1.8.0...v1.8.1

v1.8.0

This release focuses on authentication improvements, internal structure, and developer experience. It also lays groundwork for safer iteration going forward.

What’s Changed

• Deprecated auth-timeout The legacy auth-timeout option is now deprecated. It remains available for compatibility but should be considered end-of-life. Plan migrations accordingly. PR: #48

• Added NLogin authentication support Introduces first-class support for NLogin, expanding authentication options and improving interoperability. PR: #54 Contributor: @ArturoAtomplay

• Improved developer experience with JSDoc Core components are now documented with JSDoc, making the codebase easier to navigate and safer to extend. PR: #57

• Added unit tests for core components Core logic is now covered by unit tests, increasing confidence in refactors and reducing regression risk. PR: #59

• Refactor: modularized codebase and extracted core logic The internal structure has been cleaned up. Core logic is now more modular, easier to reason about, and simpler to test. This is not cosmetic, it materially improves maintainability. PR: #58

New Contributors

• @ArturoAtomplay made their first contribution with the NLogin authentication implementation. PR: #54

Full Changelog

https://github.com/AkselGlyholt/velocity-limbo-handler/compare/v1.7.0...v1.8.0

I've been busy lately, hence the gap in time since the last pre-release. I promise a full and stable release is coming soon!

What's Changed

• deprecated auth-timeout by @AkselGlyholt in https://github.com/AkselGlyholt/velocity-limbo-handler/pull/48
• Add NLogin authentication support by @ArturoAtomplay in https://github.com/AkselGlyholt/velocity-limbo-handler/pull/54
• Fix formatting issues in build.yml by @AkselGlyholt in https://github.com/AkselGlyholt/velocity-limbo-handler/pull/56
• Added JSDoc to improve dev experience by @AkselGlyholt in https://github.com/AkselGlyholt/velocity-limbo-handler/pull/57
• Add Unit Tests for Core Components by @AkselGlyholt in https://github.com/AkselGlyholt/velocity-limbo-handler/pull/59
• Refactor: Modularize codebase and extract core logic by @AkselGlyholt in https://github.com/AkselGlyholt/velocity-limbo-handler/pull/58

New Contributors

• @ArturoAtomplay made their first contribution in https://github.com/AkselGlyholt/velocity-limbo-handler/pull/54

Full Changelog: https://github.com/AkselGlyholt/velocity-limbo-handler/compare/v1.7.0...v1.8.0-beta+2

Pre-release! May not be stable

What's Changed

• deprecated auth-timeout in https://github.com/AkselGlyholt/velocity-limbo-handler/pull/48
• Added nLogin authentication support by in https://github.com/AkselGlyholt/velocity-limbo-handler/pull/54

New Contributors

• @ArturoAtomplay made their first contribution in https://github.com/AkselGlyholt/velocity-limbo-handler/pull/54

Full Changelog: https://github.com/AkselGlyholt/velocity-limbo-handler/compare/v1.7.0...v1.8.0-snapshot

🚀 VelocityLimboHandler v1.7.0

⚠️ Important: Configuration Migration

If you are updating from v1.6.2 or lower, your task-interval unit has changed.

• Old behavior: Seconds (e.g., 3)
• New behavior: Milliseconds (e.g., 3000)
• Action Required: Please update your config.yml to reflect this change, otherwise, the plugin will attempt to reconnect players far too fast!

---

🛠️ Performance & Stability

This update brings major internal improvements to ensure the proxy remains responsive even under heavy load.

• Non-Blocking Reconnections: All server pings and connection requests are now handled asynchronously. This prevents "Proxy Hangs" if a backend server is slow or timing out.
• Full Server Protection: Added a "Pre-flight" check. The plugin now pings the target server and checks player capacity before attempting a connection. This eliminates the "Server is full" console spam and reduces network overhead.
• Memory Management: Fixed several memory leaks where disconnected players were remaining in internal tracking maps.

✨ New Features & Fixes

• New Integration: Added support for LibreLoginNext in the AuthManager.
• Queue Logic: Fixed a bug where players could sometimes "skip" the queue under specific timing conditions.
• Smart Rerouting: Improved the connection listener to detect "Intentional" reconnections, preventing players from getting stuck in a loop between Limbo and the Lobby.

📦 Pull Requests

• Added LibreLoginNext support (#41)
• Unit migration: task-interval to milliseconds (#42)
• Core: Async implementation and leak fixes (#43)
• Fix: Logic to handle full backend servers (#44)
• Bugfix: Resolved queue skipping issues (#45)

Full Changelog: https://github.com/AkselGlyholt/velocity-limbo-handler/compare/v1.6.2...v1.6.3

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. Thanks to @AkselGlyholt for the fix!

Links

Full changelog: v1.6.1 → v1.6.2

📦 Release Notes – VelocityLimboHandler v1.6.1

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.

Full Changelog: https://github.com/AkselGlyholt/velocity-limbo-handler/compare/v1.6.0...v1.6.1

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

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.

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. (On GitHub)

• Feature/message config by @AkselGlyholt in https://github.com/AkselGlyholt/velocity-limbo-handler/pull/13
• Added bStats

Full Changelog: https://github.com/AkselGlyholt/velocity-limbo-handler/compare/v1.3.0...v1.4.0

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

• Feature/maintenance integration by @AkselGlyholt in https://github.com/AkselGlyholt/velocity-limbo-handler/pull/11
• Fixed connection error bug, when no forced-hosts are set

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

What's Changed

• Added command blocker by @AkselGlyholt in https://github.com/AkselGlyholt/velocity-limbo-handler/pull/9

Full Changelog: https://github.com/AkselGlyholt/velocity-limbo-handler/compare/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"]

What's Changed

• 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

VelocityLimboHandler v1.1.0 - Connection Error Handling Improvements

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)

---

This release focuses on creating a more stable experience for players during server maintenance and restarts while preventing unnecessary disconnections.

Full Changelog: https://github.com/AkselGlyholt/velocity-limbo-handler/compare/v1.0.1...v1.1.0

Whats changed?

Fixed servers config not loading custom server names properly.