peyajAuth
A high-performance, secure, and modern authentication solution for Spigot & Paper (1.21+).
peyajAuth is a lightweight, robust, and secure hybrid authentication plugin built for modern Minecraft servers. It provides automatic premium login validation, secure password authentication, brute-force protections, and native Geyser/Floodgate Bedrock support.
Dependencies & Requirements
- Java Version: Java 21 or higher.
- Server Platform: Spigot, Paper, Purpur, or Folia (Minecraft 1.16 - 1.21.x supported).
- Soft Dependencies:
- ProtocolLib: Required only if you want to enable the Premium Auto-Login feature. Without ProtocolLib, standard registration, passwords, and general authentication still work fully.
- Floodgate: Required only if you want automatic login bypasses for Bedrock Edition players.
- PlaceholderAPI: Optional, for exposing player auth placeholders to other plugins.
Features
- Premium Auto-Login: Automatically checks if a player owns a genuine Mojang account and logs them in instantly—no password required.
- Bedrock/Floodgate Bypass: Auto-login support for Bedrock players connecting through Geyser & Floodgate (verified via Xbox Live).
- Captcha Gateway: Stop bot joins on your server with customizable Chat or GUI chest-click captchas.
- Brute-Force Protection: Temporarily lock accounts or ban IPs automatically after repeated failed login attempts.
- IP Registration Limits: Restrict the number of accounts that can be registered under a single IP to prevent alt-spam.
- Custom Sounds: Queue distinct sound chimes on join reminders, captcha checks, correct entry, and lockouts.
- SQL Database Support: SQLite enabled out of the box, with high-performance MySQL and MariaDB connection pools using HikariCP.
Installation & Setup
- Download the latest compiled release from the official page.
- Drop the jar file into your server's
plugins/directory. - Restart your server to generate the default configuration files.
- Tune settings and messages inside
/plugins/peyajAuth/files:config.yml- Configure settings, password rules, and sound toggles.messages.yml- Translate messages and customize prefix gradients.database.yml- Connect to MySQL or MariaDB database pools.
Commands & Permissions
| Command | Aliases | Description | Permission | Default |
|---|---|---|---|---|
/register <password> <confirm> |
/reg |
Register a new account password | peyajauth.register |
Everyone |
/login <password> |
/l |
Authenticate your active session | peyajauth.login |
Everyone |
/logout |
Log out of your account | peyajauth.logout |
Everyone | |
/changepassword <old> <new> |
Change your current account password | peyajauth.changepassword |
Everyone | |
/captcha <code> |
Solve chat captcha verification | none | Everyone | |
/auth reload |
Reload all configuration files | peyajauth.reload |
OP | |
/auth force <player> |
Force log a player in/out | peyajauth.force |
OP | |
/auth unregister <player> |
Unregister a player's account | peyajauth.unregister |
OP | |
/auth premium <player> |
Set player auth mode to premium | peyajauth.force |
OP | |
/auth cracked <player> |
Set player auth mode to cracked | peyajauth.force |
OP | |
/auth info <player> |
View registered player details | peyajauth.info |
OP | |
/auth gui |
Open the interactive Admin chest GUI | peyajauth.admin |
OP |
Developer API
Integrate peyajAuth into your own plugins easily:
import me.peyaj.peyajauth.api.PeyajAuthAPI;
// Check if a player is authenticated
boolean loggedIn = PeyajAuthAPI.getInstance().isAuthenticated(player);
// Check if a player is premium
boolean isPremium = PeyajAuthAPI.getInstance().isPremium(player.getUniqueId());
License & Terms
Copyright © 2026. All rights reserved. Decompilation, reverse engineering, unauthorized redistribution, and editing of this compiled software are strictly prohibited.