Compatibility
Minecraft: Java Edition
26.3
26.2
26.1.x
1.21.x
1.20.x
1.19.x
1.18.x
1.17.x
1.16.5
Platforms
Links
Tags
Creators
Details
Licensed ARR
Published 11 months ago
Updated 5 days ago
🛡️ Ultimate Auth — Enterprise Authentication, Anti-Bot & Session Security Suite
Ultimate Auth is a battle-tested, zero-lag authentication and account defense engine engineered for modern Paper, Purpur, Spigot, Bukkit, and Folia networks across Minecraft 1.16.5 through 26.3.
Designed to replace outdated, main-thread-blocking login plugins, Ultimate Auth combines non-blocking HikariCP database pooling, BCrypt adaptive hashing, Floodgate/Geyser Bedrock auto-authentication, coordinate spawn-protection, and Chat-Guard credential leak prevention in one self-contained JAR.
⚡ Why Server Owners Switch to Ultimate Auth
| Capability | Ultimate Auth v3.5.0 | Legacy Auth Plugins |
|---|---|---|
| Minecraft Version Support | 1.16.5 – 26.3 (All 35 Releases) | Often locked to single NMS versions |
| Server Loaders | Bukkit, Spigot, Paper, Purpur & Folia | Breaks on Folia region threads |
| Database Engines | SQLite (Zero-Config), MySQL & MariaDB (HikariCP) | Unpooled synchronous SQLite/MySQL |
| Bedrock / Floodgate Support | Zero-Dependency Auto-Login + Prefix Fallback | Requires paid addons or extra bridges |
Coordinate Privacy (Spawn-Auth) |
Teleports to Auth Spawn & Restores Exact Coords | Exposes survival coordinates before login |
| Chat-Guard Password Shield | Blocks login pass / 7login pass Typos in Chat |
Broadcasts accidental passwords to chat |
| Discord Security Webhooks | Real-Time Lockout, Admin Login & Password Alerts | None |
| Built-In IP & Account Ban Suite | /tempban, /permanentban, /unban Included |
Requires separate punishment plugin |
🔥 Core Features & Architecture
1. 🔐 Adaptive BCrypt Cryptography & Smart IP Sessions
- Industry-Standard Hashing: Passwords are hashed asynchronously on a dedicated worker pool using configurable BCrypt cost factors (
cost: 12default). - Frictionless Session Resumption: Returning players on the same IP address within the configurable window (
30mdefault) automatically resume their session without re-typing their password. - 1.20.5+ Transfer Packet Aware: Automatically recognizes transfer packets (
Player#isTransferred) across proxy/server transfers while maintaining full backward compatibility with1.16.5–1.20.4.
2. 🎮 Seamless Bedrock & Geyser/Floodgate Auto-Authentication
- No Clunky Controller Typing: Automatically detects Bedrock Edition players via Floodgate API (zero hard compile dependency) or configurable Bedrock username prefixes (
.or*) and authenticates their Xbox Live session immediately on join.
3. 🛡️ Multi-Layered Anti-Bot, Brute-Force & Chat-Guard Defense
- Connection Burst Limiter: Throttles global connection spikes (
global-max-per-second: 80) and per-IP join floods at theAsyncPlayerPreLoginEventstage before bots ever touch the world thread. - Progressive Brute-Force Lockout: Automatically locks accounts and IPs after configurable failed login attempts (
max-attempts: 5,lockout-minutes: 15) and dispatches instant Discord Webhook embeds. - Chat-Guard Password Leak Prevention: Intercepts accidental chat messages like
login secret123,l secret123,.login secret123, or7login secret123(missed Shift key) before they are broadcast to public chat. - Coordinate Spawn-Protection (
/auth setspawn): Prevents coordinate-sniffing exploits by holding unauthenticated players at your safe Auth Spawn and restoring their exact survival location the moment they authenticate.
4. 🎨 Modern MiniMessage UI (BossBar, Titles & ActionBars)
- Dynamic Countdown BossBar: Transitions smoothly from Green → Yellow → Red as the login timer counts down.
- Persistent Titles & Sound Cues: Crisp MiniMessage gradients, blindness privacy veil, movement/inventory/command lock, and celebratory level-up sound effects on authentication.
💻 Commands & Permissions
Player Commands
| Command | Aliases | Description | Permission |
|---|---|---|---|
/register <password> <password> |
/reg |
Register a new account on the server | ultimateauth.auth.use (default: true) |
/login <password> |
/l |
Authenticate into your registered account | ultimateauth.auth.use (default: true) |
/changepassword <old> <new> |
— | Update your account password while logged in | ultimateauth.auth.use (default: true) |
/logout |
— | End your current session and lock your account | ultimateauth.auth.use (default: true) |
Administrator Commands
| Command | Description | Permission |
|---|---|---|
/auth status |
View live storage pool, session, lockout & Folia/Paper telemetry | ultimateauth.auth.admin (default: op) |
/auth info <player> |
Inspect UUID, last known IP, last login timestamp & lockout state | ultimateauth.auth.admin |
/auth forcelogin <player> |
Immediately authenticate an online player's session | ultimateauth.auth.admin |
/auth unlock <player> |
Clear active brute-force lockouts and failed attempt counters | ultimateauth.auth.admin |
/auth reset <player> |
Invalidate session and require immediate re-authentication | ultimateauth.auth.admin |
/auth changepassword <player> <new> |
Force-update a player's password from console or in-game | ultimateauth.auth.admin |
/auth unregister <player> |
Permanently delete a player's authentication record | ultimateauth.auth.admin |
/auth setspawn |
Enable Spawn-Protection and set the safe pre-login Auth Spawn | ultimateauth.auth.admin |
/auth reload |
Hot-reload config.yml, messages.yml, and database pools |
ultimateauth.auth.admin |
/permanentban <reason> <player> |
Permanently ban a player and their last known IP | ultimateauth.ban.admin (default: op) |
/tempban <reason> <player> <days> [months] [years] |
Temporarily ban a player and their IP | ultimateauth.ban.admin |
/unban <player> |
Lift an active permanent or temporary ban | ultimateauth.ban.admin |
⚙️ Quick-Start Configuration (config.yml)
security:
connection:
enabled: true
global-max-per-second: 80
ip-max-attempts: 8
ip-window: 10s
brute-force:
max-attempts: 5
lockout-minutes: 15
webhook:
enabled: false
url: ""
auth:
enabled: true
login-timeout: 120
chat-reminder-interval: 10s
bcrypt-cost: 12
chat-guard:
block-accidental-password: true
spawn-protection:
enabled: false
restore-location: true
bedrock:
auto-auth: true
prefix: "."
session-enabled: true
session-duration: 30m
database:
type: sqlite # sqlite, mysql, mariadb
pool-size: 10


