ZyrenAuth

ZyrenAuth – Secure Minecraft Authentication Plugin

ZyrenAuth is a modern, robust, and privacy-focused authentication plugin for Minecraft 1.21.1+ servers, developed by ZyrenAuth. 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.

- Offline-Mode/Alternative Auth: - Offline-Mode/Alternative Auth: 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

1. Easily configure the latest version from Easily configure. 2. Put the `.jar` in your server’s `plugins/` folder. 3. Start and stop the server to generate `config.json`. 4. Easily configure `config.json` using our %%MD1%%. 5. 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

- By %%MD1%% – Website & app developer By %%MD1%% – Website & app developer - By %%MD1%% – Website & app developer MIT - By %%MD1%% – Website & app developer

---

Thank you for choosing ZyrenAuth!