> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hauch.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# hLobby Overview

> Modern lobby management for Velocity proxies.

# hLobby

**hLobby** is a highly configurable, proxy-side lobby system for [Velocity](https://papermc.io/software/velocity) 3.4.0+. It provides smart routing, teleport countdowns, kick redirection, multi-language messages, and a small public API.

> **[Install hLobby](https://docs.hauch.dev/en/hLobby/installation.md)**
>
> Download, install, and verify hLobby on your Velocity proxy.

> **[Configuration](https://docs.hauch.dev/en/hLobby/configuration.md)**
>
> Learn every option in config.yml with examples.

> **[Commands & Permissions](https://docs.hauch.dev/en/hLobby/commands.md)**
>
> Full command and permission reference.

> **[Developer API](https://docs.hauch.dev/en/hLobby/api.md)**
>
> Integrate hLobby into your own plugins.

## Features

> **Smart routing**
>
> Random, least/most players, first available, priority, and round-robin strategies.

> **Teleport countdown**
>
> Configurable delay with cancel-on-move, cancel-on-chat, and bypass permission.

> **Cooldowns**
>
> Per-player `/lobby` cooldown to stop spam.

> **Join & kick redirect**
>
> Send players to a lobby on connect or after a kick.

> **Blocked servers**
>
> Disable `/lobby` on specific downstream servers.

> **Fallback server**
>
> Join a backup server when no lobby is available.

> **Join messages**
>
> Title, action bar, and chat greeting on lobby join.

> **Command customization**
>
> Rename, alias, or disable every command from config.

> **Multi-language**
>
> English and Spanish included; easy to add more.

> **FastStats metrics**
>
> Anonymous usage statistics with opt-out in config.

> **Update checker**
>
> Notifies operators when a new release is available.

> **Public API**
>
> Small, stable API for third-party plugins.

## Requirements

> **Velocity 3.4.0+**
>
> A Velocity proxy.

> **Java 21+**
>
> Required runtime.

> **Lobby servers**
>
> Backend servers registered in velocity.toml.

## Quick links

> **[GitHub repository](https://github.com/hauchdev/hLobby)**
>
> View source code.

> **[Latest release](https://github.com/hauchdev/hLobby/releases/latest)**
>
> Download the latest JAR.

> **[Report an issue](https://github.com/hauchdev/hLobby/issues)**
>
> Open a GitHub issue.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.