# ZyrenAuth \u2013 Secure Minecraft Authentication Plugin<\/p>\n
**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.<\/p>\n
\ud83d\udd17 **Official Modrinth Page (updates & downloads)**
\n\ud83d\udd17 **Official Website & Online Config Generator**<\/p>\n
—<\/p>\n
## \u2728 Key Features<\/p>\n
– **Mandatory Reverse Word Captcha on Join**
\n Every player must solve a reverse word captcha before login\/registration. Fully configurable expiry\/attempts and safe void teleport during the challenge.<\/p>\n
– **Dedicated 2FA Setup GUI**
\n `\/za 2fa setup` opens an in-game GUI to display your 2FA secret key and QR code URI, making authenticator setup seamless.<\/p>\n
– **Focused Authentication Teleportation**
\n After solving captcha, players are teleported to a safe void (`0.5, 0.0, 0.5`) for `\/login` or `\/register`\u2014no world interaction until auth is done.<\/p>\n
– **Comprehensive Player State Management**
\n Original location, inventory, gamemode, health, food, experience, and potion effects are saved at auth start and reliably restored after success.<\/p>\n
– **Asynchronous Modrinth Update Checker**
\n Plugin checks for the latest release version on startup and notifies server owners in the console if an update is available.<\/p>\n
– **Dynamic On-Screen Prompts**
\n Clear, persistent titles and subtitles for `\/register` and `\/login` guide users through the process.<\/p>\n
– **Optional 2FA (Google Authenticator)**
\n Players can enable\/disable 2FA; required for their own logins once enabled.<\/p>\n
– **Smart Player Authentication**
\n – **Online-Mode Servers:** Automatically registers\/logs in legitimate Minecraft accounts, with auto-username update.
\n – **Offline-Mode\/Alternative Auth:** Registered players are auto-logged in; new players must register for account protection.<\/p>\n
– **Secure Logins**
\n BCrypt password hashing and robust username validation.<\/p>\n
– **Flexible Storage**
\n MySQL\/MariaDB for scalable persistence. Robust encrypted file-based fallback.<\/p>\n
– **Optional Email Features**
\n Supports email confirmation and password reset (requires MySQL+SMTP).<\/p>\n
– **Improved Command Interface**
\n `\/za` (alias: `\/zyrenauthadmin`) for all admin, status, reload, migrate, delete, and 2FA subcommands.<\/p>\n
– **Streamlined File Management**
\n All plugin files are organized under `plugins\/config\/zyrenauth\/` for a clean server directory.<\/p>\n
—<\/p>\n
## \ud83d\ude80 Supported Platforms<\/p>\n
– **Paper** (and all compatible forks) 1.21.1+
\n _Place ZyrenAuth `.jar` in your `plugins\/` folder._<\/p>\n
—<\/p>\n
## \u26a1 Quick Start<\/p>\n
1. **Download** the latest version from Modrinth.
\n2. Put the `.jar` in your server\u2019s `plugins\/` folder.
\n3. Start and stop the server to generate `config.json`.
\n4. **Easily configure** `config.json` using our Online Config Generator.
\n5. Restart the server and you’re done!<\/p>\n
—<\/p>\n
## \u2699\ufe0f Key Configuration Options<\/p>\n
– Captcha: `captchaEnabled`, `captchaExpiryMinutes`, `maxCaptchaAttempts`
\n– Password: `minPasswordLength`, `requireDigit`, `requireLowercase`, `requireUppercase`, `requireSpecialChar`
\n– MySQL: `mysqlEnabled`, `mysqlHost`, `mysqlDatabase`, etc.
\n– Email\/SMTP: `emailFeaturesEnabled`, `smtpHost`, etc.
\n– See all options at zyrenauth.wuaze.com.<\/p>\n
—<\/p>\n
## \ud83d\udcdc Commands<\/p>\n
– `\/register ---<\/p>\n ## \ud83e\udd1d Support & License<\/p>\n - **Issues\/Source:** https:\/\/github.com\/Hardik-Verma\/ZyrenAuth ---<\/p>\n Thank you for choosing ZyrenAuth!<\/p>\n","protected":false},"excerpt":{"rendered":" ZyrenAuth is a secure and modern authentication plugin\/mod for Minecraft 1.21.1+ servers.
\n– `\/login
\n– `\/captcha
\n– `\/addemail
\n– `\/emailconfirm
\n– `\/resetpassword` \u2013 Request a password reset.
\n– `\/resetconfirm
\n– `\/za help` \u2013 Plugin help.
\n– `\/za status` \u2013 Plugin status (OP only).
\n– `\/za reload` \u2013 Reload config (OP only).
\n– `\/za migrate
\n– `\/za delete
\n– `\/za 2fa setup|confirm |disable |status` \u2013 Manage 2FA.<\/p>\n
\n- **License:** MIT
\n- **By _Pheonix \u2013 Website & app developer**<\/p>\n
\nIt focuses on account security, player privacy, and a smooth login experience.
\nSupports both Paper and Fabric servers.<\/p>\n","protected":false},"featured_media":174471,"template":"","meta":{"_minecraft_slug":"zyrenauth","_minecraft_project_id":"64tii12D","_minecraft_author":"_Pheonix","_minecraft_license":"MIT","_minecraft_downloads":338,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"zyrenauth.zip","_minecraft_size_bytes":24724386,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-16T11:31:12.623501Z","_minecraft_date_created":"2025-12-14T00:28:58.038707Z","_minecraft_date_modified":"2026-02-06T16:40:08.612829Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/zyrenauth","_minecraft_icon_attachment_id":174471,"_minecraft_imported_at":"2026-06-09T23:24:32+00:00","_minecraft_import_hash":"6efa5ae1c30d0b42221a7e3740433cd0","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,123,92],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-174470","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-technology","mod_category-utility","mod_loader-paper","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"],"yoast_head":"\n