Home - AkselGlyholt/velocity-limbo-handler GitHub Wiki

Welcome to VelocityLimboHandler

VelocityLimboHandler is a lightweight plugin for the Velocity Minecraft proxy that handles player fallback and reconnection in a smooth, queue-based system.

Whenever a backend server goes offline, crashes, or enters maintenance mode, Velocity automatically moves players to a designated Limbo server. From there, the plugin intelligently queues them and sends them back to their original or fallback destination — without flooding the server or breaking the user experience.

Why Use It?

Prevents players from getting stuck when a backend server goes down
Queues reconnect attempts to avoid spam or overload
Supports maintenance mode (optional integration with KennyTV’s plugin)
Lets you block specific commands while players are in Limbo
Fully configurable reconnect and notification intervals

No more chaos when a game server restarts. Players wait safely in Limbo and are auto-reconnected when it's ready.

Features

Queue-based reconnect logic
Reconnects players to their last server or a fallback
Maintenance mode support
Command blocking while in Limbo
Customizable queue messages and intervals

Getting Started

Ready to set it up?