VLH 2.0.0 adds a public Developer API, so other Velocity plugins can work with limbo and the reconnect queue. For server owners it's a drop-in upgrade from 1.8.x. ### New features - **Developer API v1**: Velocity plugins can move players into limbo, pause players or whole servers with holds, change a player's destination, read queue state, and react to limbo events. See the [Developer API v1 guide](https://github.com/AkselGlyholt/velocity-limbo-handler/wiki/Developer-API-v1). - **Holds in `/vlh status`**: The status command now shows how many players and servers are currently held. - **Version checker**: On startup, VLH checks for a newer release in the background and logs a download link if one is available. Startup continues normally if the check fails. - **Debug option**: Set `debug: true` to log virtual-host resolution, queue assignment, and ping results when troubleshooting a setup or plugin conflict. ### Improvements - **Performance on large networks**: Queue lookups are indexed and queue positions are cached. Only queues with players waiting are processed. Backend pings are coalesced, cached briefly, and back off for servers that are offline. - **Tuning options**: `reconnect-batch-size` (default `8`) and `queue-notify-batch-size` (default `64`) spread reconnect and notification work across ticks, so large networks can balance catch-up speed against scheduler load. - **Safer reloads and startup**: `/vlh reload` applies the new configuration all at once and rejects invalid server names instead of half-applying them. VLH stops at startup if the configuration can't be loaded. ### Fixes - Players are recovered correctly after their backend disconnects. - Maintenance status is rechecked after backend pings. - Disconnect reason matching no longer depends on the server's locale. - Scheduled work is cancelled cleanly on proxy shutdown. ### Upgrading - Replace the plugin JAR. Your existing `config.yml` is updated automatically with the new options, and no other changes are needed. - Java 21 is still required. - VLH is now licensed under **MIT** (previously GPL-3.0). ### For developers Add the API as a `compileOnly`/`provided` dependency from JitPack, and declare `velocity-limbo-handler` as a required Velocity dependency. Don't shade it. compileOnly("com.github.AkselGlyholt.velocity-limbo-handler:velocity-limbo-handler-api:v2.0.0") The internal `getPlayerManager()` and `getReconnectBlocker()` accessors are deprecated. Use `VelocityLimboApi.get(proxy)` instead. ## What's Changed * Debug option by @AkselGlyholt in https://github.com/AkselGlyholt/velocity-limbo-handler/pull/78 * Optimize queue processing and runtime resource usage by @AkselGlyholt in https://github.com/AkselGlyholt/velocity-limbo-handler/pull/81 * Version checker by @AkselGlyholt in https://github.com/AkselGlyholt/velocity-limbo-handler/pull/83 * feat(api): add stable developer API v1 by @AkselGlyholt in https://github.com/AkselGlyholt/velocity-limbo-handler/pull/82 **Full Changelog**: https://github.com/AkselGlyholt/velocity-limbo-handler/compare/v1.8.3...v2.0.0

## 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](https://www.faststats.dev) --- **Full Changelog:** [https://github.com/AkselGlyholt/velocity-limbo-handler/compare/v1.8.1...v1.8.2-26w07a](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](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](https://github.com/AkselGlyholt/velocity-limbo-handler/compare/v1.6.1...v1.6.2)