# \u26a1 ElectronGuard \u2014 The Next-Gen Auth System
\n**Stop relying on outdated chat logins. Give your players a premium, hyper-secure, and immersive entry experience.**<\/p>\n
ElectronGuard isn’t just another auth plugin\u2014it’s a complete overhaul of how players join your Minecraft server. Built exclusively for modern servers (1.21.1 \u2013 1.21.11), it completely replaces the clunky `\/login` flow with a **stunning full-screen UI**, a **sleek web panel**, and **military-grade Argon2id security**.<\/p>\n
The best part? **Zero resource packs required, and zero database setup needed.** Drop it in, and watch your server instantly feel more professional and become completely bulletproof against bots.<\/p>\n
—<\/p>\n
## \ud83d\udeab The Bot-Proof Fortress: 100% Immunity
\nStandard auth plugins just cancel chat events, leaving your server vulnerable to packet-injection bots and Force-OP exploits. **ElectronGuard is different:**
\n* **Zero Interaction:** Using ProtocolLib, we block actions directly at the packet level. A bot can join, but it cannot inject a single command or chat message.
\n* **Web-Gate Security:** Because authentication happens via the Web Panel or custom visual UI, automated “Password Cracking” chat scripts are rendered **100% useless**. They simply cannot interact with the login flow!
\n* **Total Isolation:** Unauthenticated players are held in a “Limbo” void where server logic doesn’t even reach them until they successfully log in.
\n* **Bedrock Bot Shield:** Mobile\/PE players face an additional **Unicode CAPTCHA** before they can even attempt a password \u2014 a math challenge rendered in obfuscated Unicode characters that looks normal to humans but is completely unreadable by bots and scripts.<\/p>\n
—<\/p>\n
## \ud83d\udd25 Why Server Owners Love ElectronGuard<\/p>\n
### \ud83c\udfa8 Stunning In-Game UI (No Resource Pack!)
\nDitch the chat box. ElectronGuard takes over the screen with a smooth, animated Title\/Subtitle UI displaying your server’s branding, username, and password fields.
\n* Navigate fields seamlessly with **SNEAK**.
\n* Submit instantly with **LEFT CLICK**.
\n* Live session ID & countdown timer right in the action bar.<\/p>\n
### \ud83c\udf10 Built-In Web Panel
\nGive your players choices! Alongside the in-game UI, players receive a clickable chat link opening a beautiful, real-time browser login panel.
\n* Self-hosted on your server (no third-party data tracking).
\n* Instantly communicates with the plugin API.
\n* Offline fallback page included.<\/p>\n
### \ud83d\udcf1 Full Bedrock \/ PE Support (Geyser + Floodgate)
\nRunning a network that serves both Java and Bedrock players? ElectronGuard has you covered. Mobile players connecting via **GeyserMC** and **Floodgate** are automatically detected and get a dedicated chat-based authentication flow \u2014 because they can’t click browser links.<\/p>\n
**The Bedrock flow works like this:** > **No Geyser\/Floodgate installed?** No problem. The plugin loads and runs perfectly fine \u2014 Bedrock support simply stays dormant with zero performance impact.<\/p>\n ### \ud83d\udee1\ufe0f The “Limbo” Void (Absolute Security) ### \ud83d\udd10 Unbreakable Backend Architecture ### \ud83d\udcbe Plug & Play Database Setup —<\/p>\n ## \ud83d\ude80 The ElectronGuard Advantage<\/p>\n Still using standard auth plugins? Here is why it’s time to upgrade:<\/p>\n | Feature | \u26a1 ElectronGuard | \u274c Typical Auth Plugins | —<\/p>\n ## \ud83d\udee0\ufe0f Effortless Installation<\/p>\n 1. Drop `ElectronGuard.jar` into your `\/plugins` folder.
\n1. \ud83d\udd0d **Auto-Detection** \u2014 ElectronGuard silently checks Floodgate and GeyserMC APIs the moment the player connects. No config needed.
\n2. \ud83e\udde9 **Unicode CAPTCHA** \u2014 Before touching a password, the player must solve a simple math question rendered in obfuscated Unicode (e.g. `\ud835\udfd3 \u2795 \ud835\udfd6 = ?`). It looks normal to a human but is completely unreadable by bots parsing raw strings.
\n * Wrong answer \u2192 **instant kick**. No retries. Bot loops die immediately.
\n3. \ud83d\udd11 **Chat Commands** \u2014 After passing the CAPTCHA, players use `\/login
\n4. \ud83d\udeab **Java players are blocked** from using `\/login` and `\/register` \u2014 they are always redirected to the browser panel, keeping the two flows completely separate.<\/p>\n
\nThe second an unauthenticated player joins, they are instantly teleported to a private, frozen “Limbo” dimension.
\n* **Zero Leaks:** Blindness + Night Vision ensures your real world is completely hidden.
\n* **Zero Griefing:** No movement, no mob spawns, no chat, no item drops.
\n* Upon login, their exact location, health, flight state, and game mode are flawlessly restored.<\/p>\n
\n* **Argon2id Hashing:** We don’t mess around with outdated MD5 or SHA256. We use industry-leading Argon2id (tunable to your hardware limits) with full salt.
\n* **Brute-Force Protection:** Auto-kick and temporary IP lockouts for failed attempts.
\n* **Auto-Login Sessions:** Configurable IP memory so regular players don’t have to type their password every single time.<\/p>\n
\n* **SQLite Ready:** Works instantly out of the box. `database.db` auto-generates with WAL mode enabled for lightning-fast, safe concurrent access.
\n* **MySQL\/MariaDB Ready:** Scaling up? Switch to a remote database with a single config edit. Connection pooling is built right in.<\/p>\n
\n|—|—|—|
\n| **Full-Screen UI** | \u2705 Built-in & Animated | \u274c Clunky chat or buggy chest GUIs |
\n| **Resource Pack Required?** | \u2705 NO! 100% Vanilla | \u274c Often required for custom GUIs |
\n| **Web Browser Login** | \u2705 Integrated Web Panel | \u274c Rarely exists |
\n| **Anti-Cracking Bots** | \u2705 Immune (Web-based & packet blocked) | \u274c Bots can spam chat easily |
\n| **Password Hashing** | \u2705 Argon2id (Enterprise Grade) | \u26a0\ufe0f MD5, SHA256, or BCrypt |
\n| **Input Blocking** | \u2705 Packet-level (ProtocolLib) | \u274c Easily bypassed Event Cancellations |
\n| **Bedrock \/ PE Support** | \u2705 Auto-detected via Geyser\/Floodgate | \u274c Broken or missing entirely |
\n| **Bedrock CAPTCHA Shield** | \u2705 Unicode bot-proof CAPTCHA | \u274c None |
\n| **Admin Setup Alerts** | \u2705 Auto-reminds online OPs | \u274c Leaves devs guessing |<\/p>\n
\n2. Ensure you have **ProtocolLib** installed (Required).
\n3. *(Optional)* Install **GeyserMC** + **Floodgate** to enable Bedrock player support.
\n4. Start your server. `config.yml` will automatically generate.
\n5. **Important:** Allocate the web panel port in your host (e.g., Pterodactyl\/Crafty). *Don’t worry, the plugin will automatically remind online OPs if you forget!*
\n6. Run `\/eg reload` or restart your server.
\n7. **Done!** Your server is now secured \u2014 for both Java and Bedrock players.<\/p>\n