AuthDog Plugin - How to Use Guide
Getting Started
For Server Administrators
1. Installation

1. Download AuthDog.jar and place it in your plugins folder
2. Start your server - configuration files will be created automatically
3. The plugin works immediately with default settings (no setup required!)

2. First Login as Admin

1. Join your server as an OP player
2. You'll automatically bypass authentication (OP privilege)
3. Type /authdog gui to open the control panel
4. Explore the security settings and customize as needed

3. Basic Admin Tasks

• View plugin info: /authdog info
• Open control panel: /authdog gui
• Reload config: /authdog reload
• Help a player: /authdog forcelogin PlayerName
• Reset player password: /authdog changepassword PlayerName newpass123

For Players
1. First Time Joining
When you join a server with AuthDog:

1. You'll have blindness effect (this is normal!)
2. You cannot move, chat, or use commands (security feature)
3. You'll see a 60-second countdown in your action bar
4. You must register or login within 60 seconds or you'll be kicked

2. Creating Your Account (New Players)
/register <password> <confirm-password>
Example: /register mypassword123 mypassword123

What happens:

• Your account is created instantly
• You're automatically logged in (if enabled)
• Blindness effect is removed
• You can now play normally

3. Logging In (Returning Players)
/login <password>
Example: /login mypassword123

What happens:

• Your password is verified
• You're logged into the server
• All restrictions are lifted
• You can play normally

4. Changing Your Password
/changepassword <old-password> <new-password>
Example: /changepassword oldpass123 newpass456

Player Experience Walkthrough
Scenario 1: New Player First Join
[Player joins server]
→ Screen goes black (blindness effect)
→ Action bar shows: "Login Required! 60s remaining"
→ Chat message: "You are not registered! Use /register <password> <repeat>"
→ Player types: /register hello123 hello123
→ Chat message: "Account created successfully! You have been automatically logged in."
→ Blindness effect removed, player can play normally
Scenario 2: Returning Player
[Player joins server]
→ Screen goes black (blindness effect)
→ Action bar shows: "Login Required! 60s remaining"
→ Chat message: "You must login first! Use /login <password>"
→ Player types: /login hello123
→ Chat message: "Successfully logged in! Welcome back, PlayerName!"
→ Blindness effect removed, player can play normally
Scenario 3: Player Forgets to Login
[Player joins server]
→ Screen goes black (blindness effect)
→ Action bar shows: "Login Required! 60s remaining"
→ Countdown continues: 59s, 58s, 57s...
→ Player doesn't type anything
→ At 0s: Player is kicked with message "Login timeout! You took too long to login."
️ Security Features in Action
Anti-Bot Protection
What players see:

• If too many connections from same IP: "Anti-bot protection activated. Please wait before trying again."

Brute Force Protection
What happens:

• Wrong password 1st time: "Incorrect password!"
• Wrong password 2nd time: "Incorrect password!"
• Wrong password 5th time: "Too many failed login attempts! You have been temporarily locked out."

Captcha System
When it triggers:

• After 3 failed login attempts (configurable)
• Player sees: "Complete the captcha to continue."
• A GUI opens with a math problem: "Solve this problem: 7 + 3 = ?"
• Player clicks the correct answer
• On success: "Captcha completed successfully!"

️ Admin Control Panel Usage
Opening the GUI
Type /authdog gui to open the control panel

What You'll See

• Black background with blue glowing borders
• Security module toggles (click to enable/disable)
• Status indicators (green = enabled, red = disabled)
• Navigation buttons (info, reload, close)

Using the Controls

1. Click any security module to toggle it on/off
2. Hear sound effects for feedback
3. See immediate status changes in the GUI
4. Click "Reload" to refresh configuration
5. Click "Close" to exit the panel

Common Player Commands
Essential Commands

• /register password123 password123 - Create account
• /login password123 - Login to account
• /changepassword old123 new456 - Change password

Command Aliases (Shortcuts)

• /reg instead of /register
• /l instead of /login
• /cp instead of /changepassword

⚠️ Important Notes for Players
Password Requirements

• Minimum length: 6 characters (configurable)
• Maximum length: 32 characters (configurable)
• Avoid common passwords: "password", "123456", "minecraft" are blocked
• Case sensitive: "Password123" ≠ "password123"

Session System

• Stay logged in: Your login persists until server restart or timeout
• IP-based sessions: Changing IP may require re-login
• Session timeout: Default 1 hour (configurable)

What's Blocked Before Login

• Movement: You cannot walk around
• Chat: You cannot send messages
• Commands: Only /login, /register, /l, /reg work
• Interactions: You cannot break blocks, open chests, etc.

Quick Admin Solutions
Player Can't Login

1. Check if they're registered: /authdog info
2. Reset their password: /authdog changepassword PlayerName newpass123
3. Force login them: /authdog forcelogin PlayerName

Player Locked Out

1. Open GUI: /authdog gui
2. Temporarily disable brute force protection
3. Tell player to try logging in
4. Re-enable brute force protection

Plugin Not Working

1. Check console for errors
2. Verify Java 17+ is installed
3. Try reloading: /authdog reload
4. Check file permissions in plugins folder