AtlasAuthPro – Documentation
Modern, Secure Authentication Plugin

Overview
AtlasAuthPro is a modern and secure authentication plugin designed for Minecraft Spigot and Paper servers.
It protects servers from unauthorized access while providing a smooth login experience for players and powerful in-game tools for administrators.

Requirements

• Minecraft 1.21+
  
  
• Java 17 or higher
  
  
• Spigot or Paper server

Installation

1. Download AtlasAuthPro.jar
   
   
2. Place the file into your server’s /plugins folder
   
   
3. Start the server
   
   
4. Stop the server after first launch
   
   
5. Configure config.yml
   
   
6. Start the server again

✨ Features

• Secure login & registration system (BCrypt)
  
  
• ⚡ Fast and lightweight (async operations)
  
  
• In-game admin GUI
  
  
• Player restrictions before login
  
  
• SQLite & MySQL support
  
  
• Built-in nLogin migration system
  
  
• ️ Fully configurable

Player Commands
Command Description
/register <password> Register a new account
/login <password> Login
/logout Logout
/changepassword Change password
️ Admin Commands
Command Description
/authadmin Open Admin GUI
/admin detect Detect nLogin database
/admin migrate dryrun Preview migration
/admin migrate start Start migration
/admin migrate cancel Cancel migration
/admin reload Reload configuration
Permissions
Permission Description
atlasauth.player Default player permission
atlasauth.admin Full admin access
atlasauth.migrate Migration commands
nLogin Migration
AtlasAuthPro includes a safe and powerful migration system that allows servers to move from nLogin without forcing players to re-register.

Migration Highlights

• Auto-detects nLogin installation
  
  
• Supports SQLite and MySQL
  
  
• Transfers BCrypt password hashes directly
  
  
• Players keep existing passwords
  
  
• Dry-run preview mode
  
  
• Duplicate protection

Recommended Migration Steps

1. Backup both databases
   
   
2. Start server with AtlasAuthPro installed
   
   
3. Run /admin detect
   
   
4. Run /admin migrate dryrun
   
   
5. Run /admin migrate start
   
   
6. Verify logins
   
   
7. Disable or remove nLogin

⚙️ Configuration
Configuration file:


plugins/AtlasAuthPro/config.yml

Example:


database:
type: SQLite

security:
min-password-length: 6
bcrypt-work-factor: 12
max-login-attempts: 3

features:
gui-admin-panel: true

Safety & Performance

• Async database operations
  
  
• No main-thread blocking
  
  
• Batch-based migration
  
  
• Built-in protection against duplicate users

Troubleshooting
Plugin not loading

• Ensure Java 17+
  
  
• Check server version compatibility

nLogin not detected

• Make sure nLogin ran at least once
  
  
• Verify database files exist

Players can’t login

• Confirm migration completed
  
  
• Check console logs

Support
For help, updates, and bug reports:

• Join the Discord https://discord.gg/hH2x4VURdF
  
  
• Check console logs for errors

Modern, secure authentication made simple. ️