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

Permissions

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:

1. Download JettasLogin-1.2.0.jar
2. Place in your server's plugins folder
3. Start the server to generate configuration files
4. Configure settings in plugins/JettasLogin/configs/config.yml
5. Restart the server

BungeeCord Network Setup:

1. Install MySQL database (shared between servers)
2. Configure auth server with server-mode: "auth"
3. Configure main server with server-mode: "verification"
4. Set up firewall rules (see BUNGEECORD_SETUP.md)
5. Configure BungeeCord proxy settings
6. 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.