Vouch
Auth, Secure server-side authentication solution featuring Argon2id hashing, 2FA TOTP, and session persistence.
Screenshots
About this Mod
Vouch
Vouch is a secure, server-side authentication mod designed for modern Minecraft. It handles player registration, login, and two-factor authentication entirely on the server, meaning players do not need to install anything on their clients to join.
We currently support Minecraft 1.21.1 through 1.21.4 on both Fabric and NeoForge.
How it works
When a player joins, they are placed in a "pre-auth" state where they cannot move, interact, or see chat until they log in.
- New players use
/register <password> <password>to create an account. - Returning players use
/login <password>to access the server. - Session Persistence: If a player disconnects and reconnects quickly from the same IP, their session is remembered so they don't have to type their password again immediately.
Key Features
Security & Performance
We use Argon2id for password hashing, which is the current industry standard for security. Crucially, all database operations and hashing run asynchronously on separate threads. This ensures that Vouch has zero impact on your server's TPS, even during heavy login spikes.
Two-Factor Authentication (2FA)
Players can optionally secure their accounts with TOTP 2FA. When enabled via /2fa setup, the mod renders a QR code directly onto an in-game map item. Players can scan this with Google Authenticator, Authy, or Aegis to generate time-based codes.
Database Support
Vouch is flexible with data storage. It defaults to H2 (no setup required), but fully supports SQLite, MySQL, and PostgreSQL via HikariCP for larger servers that need connection pooling.
Customization
The mod is localized in English (en_us) and Spanish (es_mx), but all messages can be customized. You can also configure sound effects, titles, and boss bars to match your server's style.
Requirements
- Minecraft 1.21.1, 1.21.2, 1.21.3, or 1.21.4
- Java 21 or higher
- Fabric (requires Fabric API) or NeoForge
- Architectury API is required for both loaders
Documentation
For full configuration guides, permission nodes, and advanced setup, please visit our documentation:
Server-side only
This mod is strictly server-side. Do not install it on the client.
Available Versions
How to Install Vouch on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.6).
Install Mod
Open the mod browser in the dashboard and search for "Vouch". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.6, 1.21.5, 1.21.4 (+3 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Vouch server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.6). You can switch loaders with one click in the panel.
Is Vouch compatible with fabric and neoforge?
Vouch officially supports fabric, neoforge for Minecraft 1.21.6, 1.21.5, 1.21.4. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Vouch – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Vouch consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Vouch with just one click on your server.