Skip to content

Authentication Mode

Aksel Glyholt edited this page Jan 5, 2026 · 5 revisions

Velocity Limbo Handler now includes an authentication-aware queue system. This system ensures that players are only placed into the reconnect queue after they have successfully authenticated, preventing authentication delays from holding up other players.

The system is designed to be plugin-agnostic and easily expandable. As of now the plugin currently supports LibreLogin, LibreLoginNext and nLogin


📌 How It Works

When a supported authentication plugin is installed:

  1. The plugin is detected at runtime using reflection (no hard dependencies).
  2. Authentication events are hooked into automatically — no manual config needed.
  3. Players who haven’t finished logging in are blocked from the reconnect queue.
  4. Once authenticated, they are restored to their correct per-server queue position.

If no supported authentication plugin is installed, Velocity Limbo Handler behaves exactly as before.


✨ Setup

Currently we support LibreLogin, LibreLoginNext and nLogin

You will need to check out the config documentation of whichever plugin you choose. Some things to keep in mind are:

  • Make sure that auto-reconnect to main server is disabled
  • Make sure that the plugin automatically redirects players to the limbo server

⚡ Benefits

  • Prevents unauthenticated players from clogging the reconnect queue.
  • Seamless re-queuing after authentication — no admin action needed.
  • No impact on performance when no supported plugin is present.

Clone this wiki locally