![\"VeloAuth\"](\"https:\/\/cdn.modrinth.com\/data\/cached_images\/a31eec688d48cffe2770bd961e5d134c71b8b662.png\")
\n<\/p>\n\n \n<\/p>\n
# VeloAuth<\/p>\n
\n
\n
\n<\/p>\n
**Complete Velocity authentication plugin** with intelligent nickname protection, premium auto-login, and secure offline player management.<\/p>\n
## What is VeloAuth?<\/p>\n
VeloAuth is a comprehensive authentication system for Velocity proxy that handles all player authorization before they reach your backend servers. It works with any limbo server to provide a smooth login experience while protecting nickname ownership through intelligent conflict resolution.<\/p>\n
## Key Features<\/p>\n
– \ud83d\udd12 **Intelligent Nickname Protection** – Premium nicknames are reserved unless already registered by cracked players
\n– \u26a1 **Premium Auto-Login** – Mojang account owners skip authentication automatically
\n– \ud83d\udd04 **Automatic Nickname Change Detection** – Detects when a premium player renames their Mojang account and updates the database record automatically
\n– \ud83d\udee1\ufe0f **Secure Offline Auth** – BCrypt password hashing with brute-force protection
\n– \ud83d\udcf1 **Optional Floodgate Support** – Bedrock players can bypass the auth server when Floodgate integration is enabled
\n– \ud83d\uddfa\ufe0f **Forced Hosts Support** – Players connect via custom domains (e.g., `pvp.server.com`) and are properly routed to their intended server *after* authentication
\n– \ud83d\udeab **Smart Command Hiding** – Authentication commands (`\/login`, `\/register`) are completely hidden from tab-completion once the player is logged in
\n– \ud83d\ude80 **High Performance** – Three-layer premium resolution cache: in-memory \u2192 database \u2192 external API, with 24-hour premium status retention
\n– \ud83d\udd04 **Conflict Resolution** – Smart handling of premium\/cracked nickname conflicts
\n– \ud83d\udcca **Admin Tools** – Complete conflict management with `\/vauth conflicts`
\n– \ud83d\uddc4\ufe0f **Multi-Database** – MySQL, PostgreSQL, H2, SQLite
\n– \ud83c\udf0d **17 Languages** – EN, PL, DE, FR, RU, TR, SI, FI, ZH_CN, ZH_HK, JA, HI, VI, KO, TH, ID, PT_BR
\n– \ud83d\udd04 **LimboAuth Compatible** – 100% database compatibility (no migration needed)
\n– \ud83d\udce2 **Discord Alerts** – Webhook notifications for security events
\n– \ud83e\uddf5 **Virtual Threads** – Built on Java 21 for maximum performance
\n– \ud83d\udcc8 **bStats Analytics** – Anonymous usage statistics via bStats<\/p>\n
## Requirements<\/p>\n
– **Java 21 or newer**
\n– **Velocity proxy** (API 3.4.0+)
\n– **Limbo server**: NanoLimbo, LOOHP\/Limbo, LimboService, PicoLimbo, hpfxd\/Limbo, or any other
\n– **Database**: MySQL, PostgreSQL, H2, or SQLite<\/p>\n
## Quick Setup<\/p>\n
### Installation<\/p>\n
1. Download VeloAuth from Modrinth
\n2. Place the file in your Velocity `plugins\/` folder
\n3. Start Velocity – the plugin will create a `config.yml` file
\n4. Stop Velocity and configure your database and auth server name in `plugins\/VeloAuth\/config.yml`
\n5. Restart Velocity<\/p>\n
**Note:** Floodgate support is disabled by default. Enable it only if you actually use Geyser\/Floodgate.<\/p>\n
### Velocity Config<\/p>\n
Configure your `velocity.toml` with your limbo\/auth server and backend servers:<\/p>\n
“`toml
\n[servers]
\nlimbo = “127.0.0.1:25566” # Auth\/limbo server (NanoLimbo, LOOHP\/Limbo, etc.)
\nlobby = “127.0.0.1:25565” # Typical backend server
\nsurvival = “127.0.0.1:25567” # Another backend server<\/p>\n
try = [“lobby”, “survival”] # Order matters. Do NOT put ‘limbo’ here.<\/p>\n
[forced-hosts]
\n# VeloAuth fully respects Velocity’s forced hosts!
\n# Players connecting via this IP will be sent to limbo to login,
\n# and then seamlessly transferred to ‘survival’ instead of ‘lobby’.
\n“survival.example.com” = [“survival”]
\n“`<\/p>\n
**Important:** The `try` configuration controls where authenticated players are redirected by default. VeloAuth automatically skips the `limbo` server and selects the first available backend server, **unless** the player used a `forced-host` domain, in which case they are natively routed to their intended destination!<\/p>\n
### Discord Webhooks<\/p>\n
VeloAuth supports Discord notifications for security events (failed login bursts, brute-force attempts, premium resolution failures). Configure the webhook URL in `config.yml` under `alerts.discord`.<\/p>\n
### Database Config<\/p>\n
Supported: H2 (out-of-box), MySQL, PostgreSQL, SQLite<\/p>\n
## Player Commands<\/p>\n
| Command | Description | Restrictions | ## Admin Commands<\/p>\n | Command | Permission | Description | ## How It Works<\/p>\n ### Authentication Flow ### Premium Resolution (3 layers) ### Nickname Change Detection ### Nickname Protection System ## LimboAuth Migration<\/p>\n VeloAuth is **100% compatible** with LimboAuth databases:<\/p>\n 1. Stop LimboAuth on your backend servers ## Contributing<\/p>\n Contributions are welcome! Please open an issue or PR.<\/p>\n ## Support<\/p>\n Need help? Found a bug? Open an issue on GitHub or join our Discord server.<\/p>\n ## License<\/p>\n This project is licensed under the **MIT License**<\/p>\n","protected":false},"excerpt":{"rendered":" Secure Velocity auth plugin with auto-login for premium players and registration\/login for offline players.<\/p>\n","protected":false},"featured_media":165505,"template":"","meta":{"_minecraft_slug":"veloauth","_minecraft_project_id":"awl91tjn","_minecraft_author":"rafalohaki","_minecraft_license":"MIT","_minecraft_downloads":3090,"_minecraft_follows":10,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"veloauth.zip","_minecraft_size_bytes":335740920,"_minecraft_version_count":13,"_minecraft_updated_at":"2026-05-16T04:58:58.909393Z","_minecraft_date_created":"2025-11-18T01:18:51.397311Z","_minecraft_date_modified":"2026-05-13T19:25:46.784329Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/veloauth","_minecraft_icon_attachment_id":165505,"_minecraft_imported_at":"2026-06-09T17:48:23+00:00","_minecraft_import_hash":"cc25c7fd950f05da4db365e83be576b7","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,123,92,985],"mod_loader":[986],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864,83,167,163],"class_list":["post-165504","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-technology","mod_category-utility","mod_category-velocity","mod_loader-velocity","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n|———|————-|————–|
\n| `\/register
\n| `\/login
\n| `\/changepassword
\n|———|————|————-|
\n| `\/unregister
\n| `\/vauth reload` | `veloauth.admin` | Reload configuration |
\n| `\/vauth cache-reset [player]` | `veloauth.admin` | Clear authorization cache |
\n| `\/vauth stats` | `veloauth.admin` | Show plugin statistics |
\n| `\/vauth conflicts` | `veloauth.admin` | List nickname conflicts |<\/p>\n
\n1. **Player connects** to Velocity
\n2. **VeloAuth checks** in-memory authorization cache (instant, no I\/O)
\n3. If **not in memory**, checks **database premium cache** (persistent across restarts)
\n4. If **not in DB cache**, resolves via **Mojang\/Ashcon API** in parallel using virtual threads
\n5. If **not premium**, player is sent to the **auth server** (unless Floodgate Bedrock bypass applies)
\n6. Player types **\/login** or **\/register**
\n7. **VeloAuth verifies** credentials with BCrypt
\n8. Player is **redirected to backend server** via `try` configuration<\/p>\n
\n“`
\nConnect \u2192 [In-memory cache] \u2192 [Database cache] \u2192 [Mojang\/Ashcon API]
\n ~0ms ~1ms ~200-500ms
\n“`
\nAll API calls run in parallel on virtual threads. Results are cached in the database and survive proxy restarts.<\/p>\n
\nWhen a premium player logs in with a different username than what is stored (Mojang account rename), VeloAuth automatically detects the mismatch and updates the database record, keeping the UUID-to-username mapping accurate without any admin intervention.<\/p>\n
\n– **Premium nicknames are reserved** unless already registered by cracked players
\n– **Conflict resolution** when premium players use cracked-registered nicknames
\n– **Admin tools** for managing nickname conflicts
\n– **Automatic blocking** of cracked players trying premium nicknames<\/p>\n
\n2. Install VeloAuth on Velocity
\n3. Configure VeloAuth to use the same database as LimboAuth
\n4. Start Velocity – all existing accounts will work automatically<\/p>\n