What is VeloAuth?

VeloAuth is a comprehensive authentication system for Velocity proxy that handles all player authorization before they reach your backend servers. It works seamlessly with PicoLimbo to provide a smooth login experience while protecting nickname ownership through intelligent conflict resolution.

Key Features

• Intelligent Nickname Protection - Premium nicknames are reserved unless already registered by cracked players
• Premium Auto-Login - Mojang account owners skip authentication automatically
• Secure Offline Auth - BCrypt password hashing with brute-force protection
• High Performance - Authorization cache with 24-hour premium status caching
• Conflict Resolution - Smart handling of premium/cracked nickname conflicts
• Admin Tools - Complete conflict management with /vauth conflicts
• Multi-Database - MySQL, PostgreSQL, H2, SQLite
• 7 Languages - EN, PL, DE, FR, RU, TR, SI
• LimboAuth Compatible - Seamless migration from existing setups

Requirements

• Java 21 or newer
• Velocity proxy (API 3.4.0+)
• PicoLimbo or other limbo/lobby server
• Database: MySQL, PostgreSQL, H2, or SQLite

Quick Setup

Installation

1. Download VeloAuth from Modrinth / Releases
2. Place the file in your Velocity plugins/ folder
3. Start Velocity - the plugin will create a config.yml file
4. Stop Velocity and configure your database and limbo name in plugins/VeloAuth/config.yml
5. Restart Velocity

Velocity Config
Configure your velocity.toml with PicoLimbo and backend servers:

Important: The try configuration controls where authenticated players are redirected. VeloAuth automatically skips the PicoLimbo server and selects the first available backend server.

Database Config
Supported: H2 (out-of-box), MySQL, PostgreSQL, SQLite

Player Commands

Admin Commands

How It Works

Authentication Flow

1. Player connects to Velocity
2. VeloAuth checks authorization cache
3. If not cached, player is sent to PicoLimbo
4. Nickname protection activates during registration
5. Player types /login or /register
6. VeloAuth verifies credentials with BCrypt
7. Player is redirected to backend server via try configuration

Nickname Protection System

• Premium nicknames are reserved unless already registered by cracked players
• Conflict resolution when premium players use cracked-registered nicknames
• Admin tools for managing nickname conflicts
• Automatic blocking of cracked players trying premium nicknames

LimboAuth Migration

VeloAuth is 100% compatible with LimboAuth databases:

1. Stop LimboAuth on your backend servers
2. Install VeloAuth on Velocity
3. Configure VeloAuth to use the same database as LimboAuth
4. Start Velocity - all existing accounts will work automatically

Support

Need help? Found a bug? Open an issue on GitHub or join our Discord server.