Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Creators
Details
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.


