JettasLogin

# **JETTAS LOGIN** Advanced Authentication System for Minecraft Servers ##### **Version 1.2.0** | Compatible with Minecraft 1.17.x - 1.21.x ## **Overview** JettasLogin is a comprehensive authentication plugin designed for Minecraft servers running Spigot/Paper. It provides secure player authentication with individual void worlds, CAPTCHA verification, BungeeCord support, and MySQL synchronization for multi-server networks. ## **Key Features** **Authentication System** * Secure password encryption using SHA-256 with salt * CAPTCHA verification with map display for registration * Individual void worlds for each player during authentication * 30-second registration timer with visual countdown * 60-second login timer with boss bar display * 3 maximum login attempts with automatic kick * Password recovery system with verification codes * Cooldown system: 3 consecutive timeouts = 1-minute ban **Chat System** * Global chat channel - visible to all authenticated players * Local chat channel - visible only to players in same world * Private messaging system with /msg command * Chat isolation during authentication * Customizable channel prefixes and colors * Permission-based chat access control **Visual & Audio Effects** * CAPTCHA displayed on in-hand map with distortion and noise * Boss bar countdown with color changes (Yellow → Red at ≤10s) * Continuous black particle effects during authentication * Sound effects: countdown beeps, success/error sounds * Action bar messages for movement restrictions * Glass block below player to prevent void falling **Security Features** * CAPTCHA verification prevents automated registration * Token-based authentication for BungeeCord networks * MySQL database synchronization between servers * IP address validation * Token expiry system (30 minutes default) * Automatic cleanup of expired sessions * Protection against direct server connection bypass * Chat isolation during authentication **Multi-Language Support** * English (Default) * Portuguese (Brazil) * Spanish * Italian * Russian * Chinese **BungeeCord Integration** * Seamless server transfer after authentication * MySQL-based token verification * Support for auth server + main server architecture * Automatic player teleportation between servers * Fallback to local world if BungeeCord disabled ## **Technical Specifications** **Requirements:** * Minecraft Version: 1.17.x - 1.21.x * Server Software: Spigot or Paper * Java Version: 17 or higher * MySQL: 5.7+ or 8.0+ (optional, JSON fallback available) **Dependencies:** * Gson 2.10.1 (included) * MySQL Connector 8.3.0 (included) * HikariCP 5.1.0 (included) ## **Commands** ``` /resetpassword - Reset a player's password (Admin) /jettaslogin reload - Reload plugin configuration (Admin) /jettaslogin version - Display plugin version /jettaslogin help - Show command help /global [message] - Switch to global chat or send global message /local [message] - Switch to local chat or send local message /msg - Send private message to player ``` ## **Permissions** ``` jettaslogin.admin - Full administrative access jettaslogin.resetpassword - Reset player passwords jettaslogin.reload - Reload configuration jettaslogin.bypass.cooldown - Bypass login cooldown jettaslogin.flight - Allow flight in auth world jettaslogin.chat.global - Use global chat jettaslogin.chat.local - Use local chat jettaslogin.chat.msg - Send private messages jettaslogin.chat.global.receive - Receive global messages jettaslogin.chat.local.receive - Receive local messages ``` ## **Configuration Modes** **Auth Server Mode:** Server handles player registration and login with CAPTCHA verification, creates authentication tokens in MySQL, then transfers players to the main server via BungeeCord. **Verification Mode:** Server verifies authentication tokens from MySQL when players join. Kicks unauthorized players automatically. ## **Installation** **Single Server Setup:** * Download JettasLogin-1.2.0.jar * Place in your server's plugins folder * Start the server to generate configuration files * Configure settings in plugins/JettasLogin/configs/config.yml * Restart the server **BungeeCord Network Setup:** * Install MySQL database (shared between servers) * Configure auth server with server-mode: "auth" * Configure main server with server-mode: "verification" * Set up firewall rules (see BUNGEECORD_SETUP.md) * Configure BungeeCord proxy settings * Start all servers ## **Support & Documentation** Full documentation including BungeeCord setup guide, security best practices, and troubleshooting can be found in the plugin's GitHub repository. ### **Secure Your Server Today!**