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 <player> - 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 <player> <message> - 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!