ZyrenAuth – Secure Minecraft Authentication Plugin

ZyrenAuth is a modern, robust, and privacy-focused authentication plugin for Minecraft 1.21.1+ servers, developed by _Pheonix. It delivers strong account protection and a seamless, intuitive login experience for Paper (Spigot-compatible) environments.

🔗 Official Modrinth Page (updates & downloads)
🔗 Official Website & Online Config Generator

✨ Key Features

Mandatory Reverse Word Captcha on Join
Every player must solve a reverse word captcha before login/registration. Fully configurable expiry/attempts and safe void teleport during the challenge.
Dedicated 2FA Setup GUI
/za 2fa setup opens an in-game GUI to display your 2FA secret key and QR code URI, making authenticator setup seamless.
Focused Authentication Teleportation
After solving captcha, players are teleported to a safe void (0.5, 0.0, 0.5) for /login or /register—no world interaction until auth is done.
Comprehensive Player State Management
Original location, inventory, gamemode, health, food, experience, and potion effects are saved at auth start and reliably restored after success.
Asynchronous Modrinth Update Checker
Plugin checks for the latest release version on startup and notifies server owners in the console if an update is available.
Dynamic On-Screen Prompts
Clear, persistent titles and subtitles for /register and /login guide users through the process.
Optional 2FA (Google Authenticator)
Players can enable/disable 2FA; required for their own logins once enabled.
Smart Player Authentication
- Online-Mode Servers: Automatically registers/logs in legitimate Minecraft accounts, with auto-username update.
- Offline-Mode/Alternative Auth: Registered players are auto-logged in; new players must register for account protection.
Secure Logins
BCrypt password hashing and robust username validation.
Flexible Storage
MySQL/MariaDB for scalable persistence. Robust encrypted file-based fallback.
Optional Email Features
Supports email confirmation and password reset (requires MySQL+SMTP).
Improved Command Interface
/za (alias: /zyrenauthadmin) for all admin, status, reload, migrate, delete, and 2FA subcommands.
Streamlined File Management
All plugin files are organized under plugins/config/zyrenauth/ for a clean server directory.

🚀 Supported Platforms

Paper (and all compatible forks) 1.21.1+
Place ZyrenAuth .jar in your plugins/ folder.

⚡ Quick Start

Download the latest version from Modrinth.
Put the .jar in your server’s plugins/ folder.
Start and stop the server to generate config.json.
Easily configure config.json using our Online Config Generator.
Restart the server and you're done!

⚙️ Key Configuration Options

Captcha: captchaEnabled, captchaExpiryMinutes, maxCaptchaAttempts
Password: minPasswordLength, requireDigit, requireLowercase, requireUppercase, requireSpecialChar
MySQL: mysqlEnabled, mysqlHost, mysqlDatabase, etc.
Email/SMTP: emailFeaturesEnabled, smtpHost, etc.
See all options at zyrenauth.wuaze.com.

📜 Commands

/register <password> <confirm> – Register a new account.
/login <password> – Log into your account.
/captcha <answer> – Solve the reverse word captcha.
/addemail <email> – Link an email.
/emailconfirm <token> – Confirm your email.
/resetpassword – Request a password reset.
/resetconfirm <token> <new_password> <confirm> – Confirm password reset.
/za help – Plugin help.
/za status – Plugin status (OP only).
/za reload – Reload config (OP only).
/za migrate <player> – Migration (OP only).
/za delete <player> [confirm] – Delete account (OP only).
/za 2fa setup|confirm <code>|disable <code>|status – Manage 2FA.

🤝 Support & License

Issues/Source: https://github.com/Hardik-Verma/ZyrenAuth
License: MIT
By _Pheonix – Website & app developer

Thank you for choosing ZyrenAuth!

ZyrenAuth

📖About ZyrenAuth