Plugin Overview
AuthDog is a comprehensive, enterprise-level authentication plugin designed for Minecraft servers that demand the highest security standards. Built with modern security practices and advanced protection mechanisms, AuthDog provides a robust defense against unauthorized access, bot attacks, and security breaches.

Core Features
Authentication System:

• Secure user registration and login system
• Multiple password encryption methods (BCrypt, SHA256, PBKDF2)
• Configurable password strength requirements
• Session-based login with IP validation
• Auto-login on registration option

Advanced Security Modules:

• Anti-Bot Protection - Prevents automated bot attacks with connection rate limiting
• Brute Force Protection - Blocks accounts after failed login attempts with configurable lockout
• Captcha System - Interactive math-based captcha after failed attempts
• VPN/Proxy Detection - Blocks connections from VPN and proxy services
• IP Locking - Restricts accounts to specific IP addresses
• Two-Factor Authentication - TOTP support with Google Authenticator
• Single Session Enforcement - Prevents multiple simultaneous logins

Player Experience:

• Blindness effect until authentication (prevents cheating)
• 60-second login countdown with action bar display
• Movement and chat restrictions before login
• Smooth session management with automatic timeouts
• Professional GUI control panel for administrators

Database Support:

• FlatFile (H2) - Built-in, no setup required
• MySQL - Full MySQL database support
• PostgreSQL - Enterprise PostgreSQL support
• Connection pooling with HikariCP for optimal performance

Administrative Tools:

• Beautiful in-game GUI control panel
• Real-time security module toggling
• Player management commands
• Comprehensive logging system
• Configuration hot-reloading

Commands Reference
Player Commands
/register (aliases: /reg)

• Description: Register a new account
• Usage: /register <password> <repeat>

/login (aliases: /l)

• Description: Login to your account
• Usage: /login <password>

/changepassword (aliases: /changepw, /cp)

• Description: Change your password
• Usage: /changepassword <old> <new>

Admin Commands
/authdog gui

• Permission: authdog.admin.gui
• Description: Open control panel
• Usage: /authdog gui

/authdog info

• Permission: None
• Description: Show plugin information
• Usage: /authdog info

/authdog reload

• Permission: authdog.admin.reload
• Description: Reload configuration
• Usage: /authdog reload

/authdog changepassword

• Permission: authdog.admin.changepassword
• Description: Change player password
• Usage: /authdog changepassword <player> <password>

/authdog unregister

• Permission: authdog.admin.unregister
• Description: Unregister a player
• Usage: /authdog unregister <player>

/authdog forcelogin

• Permission: authdog.admin.forcelogin
• Description: Force login a player
• Usage: /authdog forcelogin <player>

️ Security Features Breakdown
Anti-Bot Protection

• Monitors connection patterns and rates
• Configurable maximum joins per minute
• Automatic suspicious pattern detection
• Temporary IP-based blocking

Brute Force Protection

• Tracks failed login attempts per player
• Progressive lockout system (configurable attempts/duration)
• Automatic attempt reset after time period
• Integration with captcha system

Interactive Captcha System

• Triggers after configurable failed attempts
• Math-based problems with multiple difficulty levels
• Beautiful GUI interface with click-to-answer
• Automatic regeneration on failure

VPN/Proxy Detection

• External API integration for IP reputation checking
• Configurable to block VPNs, proxies, or both
• Whitelist support for trusted IPs
• Caching system for performance

Two-Factor Authentication

• TOTP (Time-based One-Time Password) support
• Google Authenticator compatibility
• QR code generation for easy setup
• Backup codes for account recovery

⚙️ Configuration Highlights
Highly Customizable:

• 50+ configuration options
• Complete message customization with color codes
• GUI theme and layout customization
• Database connection pooling settings
• Security module fine-tuning

Performance Optimized:

• Asynchronous database operations
• Connection pooling with HikariCP
• Efficient caching systems
• Cleanup tasks for memory management

GUI Control Panel
The AuthDog Control Panel provides administrators with an intuitive interface to manage security settings:

• Real-time Toggle Controls - Enable/disable security modules instantly
• Visual Status Indicators - See which protections are active at a glance
• Professional Design - Matte black theme with neon blue accents
• Sound Effects - Audio feedback for all interactions
• Live Statistics - View registered users, online players, and more

PlaceholderAPI Support
Full PlaceholderAPI integration with placeholders:

• %authdog_logged_in% - Player login status
• %authdog_registered% - Registration status
• %authdog_has_2fa% - Two-factor authentication status
• %authdog_session_time% - Remaining session time
• %authdog_failed_attempts% - Failed login attempts
• %authdog_is_locked_out% - Lockout status
• And more...

Technical Specifications
Requirements:

• Minecraft 1.20+ (Paper/Spigot)
• Java 17+
• Optional: PlaceholderAPI for enhanced features

Database Support:

• H2 (FlatFile) - Default, no setup required
• MySQL 8.0+
• PostgreSQL 12+

Performance:

• Asynchronous operations prevent server lag
• Connection pooling for database efficiency
• Memory-efficient caching systems
• Automatic cleanup tasks

Permissions
authdog.admin - Full admin access (Default: OP) authdog.admin.gui - Access control panel (Default: OP) authdog.admin.reload - Reload configuration (Default: OP) authdog.admin.changepassword - Change player passwords (Default: OP) authdog.admin.unregister - Unregister players (Default: OP) authdog.admin.forcelogin - Force login players (Default: OP) authdog.bypass.login - Bypass login requirements (Default: False) authdog.bypass.commands - Bypass command restrictions (Default: False)

Why Choose AuthDog?
✅ Enterprise-Grade Security - Military-level protection mechanisms
✅ Zero Configuration - Works out of the box with sensible defaults
✅ Highly Customizable - Every aspect can be tailored to your needs
✅ Performance Focused - Optimized for high-traffic servers
✅ Professional Support - Comprehensive documentation and support
✅ Regular Updates - Continuous improvement and new features
✅ Open Source Friendly - Clean, well-documented code

AuthDog - Where Security Meets Simplicity ️

Protect your server with the authentication plugin trusted by thousands of administrators worldwide.