🛡️ Ultimate Auth — 企业级认证、反机器人与会话安全套件
Ultimate Auth 是一款经过实战检验、零延迟的认证与账户防御引擎,专为现代 Folia、Purpur、Paper、Spigot 和 Bukkit 服务器打造,支持 Minecraft 1.16.5 至 26.3(全部 35 个版本)。
Ultimate Auth 旨在取代过时的、会阻塞主线程的登录插件。它将 非阻塞 HikariCP 数据库连接池(SQLite、MySQL 及 MariaDB)、BCrypt 自适应哈希、Floodgate/Geyser Bedrock 自动认证、Alt-IP 账户取证、坐标出生点保护、Chat-Guard 凭证泄露防护 以及 原生 PlaceholderAPI 集成 整合在一个独立的 JAR 文件中。
⚡ 为什么服务器管理员转向 Ultimate Auth
| 功能 |
Ultimate Auth v3.6.0 |
传统认证插件 |
| Minecraft 版本支持 |
1.16.5 – 26.3(所有 35 个版本,无 NMS 破坏) |
在 1.21.4+ / 26.3(Sound 枚举变更)上崩溃 |
| 服务器加载器 |
Bukkit、Spigot、Paper、Purpur 及 Folia |
在 Folia 区域线程上崩溃 |
| 数据库引擎 |
SQLite(零配置)、MySQL & MariaDB(HikariCP) |
未使用连接池的同步 SQLite/MySQL |
| Bedrock / Floodgate 支持 |
零依赖自动登录 + 前缀回退 |
需要付费插件或额外桥接 |
| Alt-IP 取证与账户清理 |
内置 /auth alts <player|ip> 及 /auth purge <days> |
需要外部 IP 追踪插件 |
| PlaceholderAPI 集成 |
内置 %ultimateauth_*% 及 %uauth_*%(11 个占位符) |
需要单独下载扩展 |
坐标隐私(Spawn-Auth) |
传送至认证出生点并恢复精确坐标 |
登录前暴露生存坐标 |
| Chat-Guard 密码防护 |
阻止聊天中的 login pass / 7login pass 拼写错误 |
将意外输入的密码广播到公共聊天 |
| Discord 安全 Webhook |
实时封禁、管理员登录及密码警报 |
无 |
| 内置 IP 与账户封禁套件 |
包含 /tempban、/permanentban、/unban |
需要单独的处罚插件 |
🆕 v3.6.0 新增内容
- 通用
1.16.5 – 26.3 音频兼容性:消除了对 org.bukkit.Sound 枚举字节码绑定的依赖,转而使用字符串键控的声音标识符(entity.player.levelup、entity.firework_rocket.launch、entity.firework_rocket.blast、block.note_block.bass),确保在 Minecraft 1.21.4+ 和 26.3 上不会出现任何 IncompatibleClassChangeError 崩溃。
- 原生 PlaceholderAPI 扩展(
%ultimateauth_*% 及 %uauth_*%):提供即时记分板、TAB 列表和 HUD 占位符,用于显示认证状态、Bedrock 检测、活跃会话、待处理登录、暴力破解锁定、存储后端及运行时引擎(Folia、Purpur、Paper、Spigot、Bukkit)。
- Alt-IP 取证(
/auth alts <player|ip>):以毫秒级速度追踪与玩家最后已知 IP 或注册 IP 关联的所有已注册账户,并在 /auth info <player> 内自动列出小号。
- 不活跃账户清理(
/auth purge <days>):异步删除早于 <days> 天的休眠账户(设有最少 7 天的安全保护期)。
- 命令方块绕过权限修复:正确尊重
plugin.yml 中记录的 ultimateauth.commandblock.bypass 权限。
🔥 核心功能与架构
1. 🔐 自适应 BCrypt 加密与智能 IP 会话
- 行业标准哈希:密码在专用的工作线程池上异步进行哈希处理,使用可配置的 BCrypt 成本因子(默认
bcrypt-cost: 12)。
- 无缝会话恢复:在同一 IP 地址且在可配置窗口内(默认
30m)返回的玩家无需重新输入密码即可自动恢复其会话。
- 感知
1.20.5+ 传输数据包:自动识别代理/服务器传输过程中的传输数据包(Player#isTransferred),同时保持与 1.16.5–1.20.4 的完全向后兼容。
2. 🎮 无缝 Bedrock 与 Geyser/Floodgate 自动认证
- 无需繁琐的手动输入控制器:通过 Floodgate API(反射式零硬依赖钩子)或可配置的 Bedrock 用户名前缀(
. 或 *)自动检测 Bedrock Edition 玩家,并在加入时立即验证其 Xbox Live 会话。
3. 🛡️ 多层防机器人、暴力破解与 Chat-Guard 防御
- 连接突发限制器:在
AsyncPlayerPreLoginEvent 阶段 throttles 全局连接激增(global-max-per-second: 80)和单 IP 加入洪水,防止机器人接触世界线程。
- 渐进式暴力破解锁定:在达到可配置的最大失败登录尝试次数后(
max-attempts: 5,lockout-minutes: 15)自动锁定账户和 IP,并发送即时 Discord Webhook 嵌入消息。
- Chat-Guard 密码泄露防护:拦截诸如
login secret123、l secret123、.login secret123 或 7login secret123(Shift 键漏按)等意外聊天消息,防止它们被广播到公共聊天中。
- 坐标出生点保护(
/auth setspawn):通过将未认证玩家扣留在你安全的认证出生点,并在他们认证的瞬间恢复其确切的生存位置(在 Paper/Folia 上使用 teleportAsync),防止坐标嗅探漏洞。
4. 📊 原生 PlaceholderAPI 扩展(%ultimateauth_*% 及 %uauth_*%)
当安装 PlaceholderAPI 时,Ultimate Auth 会自动注册 %ultimateauth_<identifier>% 和简写 %uauth_<identifier>%:
| 占位符 |
简写 |
输出 |
%ultimateauth_logged_in% |
%uauth_logged_in% |
true 或 false |
%ultimateauth_authenticated% |
%uauth_authenticated% |
yes 或 no |
%ultimateauth_status% |
%uauth_status% |
Authenticated、Pending Login 或 Offline |
%ultimateauth_bedrock% |
%uauth_bedrock% |
如果是 Bedrock/Floodgate 玩家则为 true,否则为 false |
%ultimateauth_session_active% |
%uauth_session_active% |
如果玩家拥有有效的 IP 会话则为 true |
%ultimateauth_online_authenticated% |
%uauth_online_authenticated% |
当前已认证且在线的玩家数量 |
%ultimateauth_pending_count% |
%uauth_pending_count% |
正在等待登录/注册的在线玩家数量 |
%ultimateauth_active_sessions% |
%uauth_active_sessions% |
缓存的 IP 会话总数 |
%ultimateauth_active_lockouts% |
%uauth_active_lockouts% |
当前处于活动状态的暴力破解锁定总数 |
%ultimateauth_storage% |
%uauth_storage% |
活跃的数据库引擎(SQLITE、MYSQL、MARIADB) |
%ultimateauth_engine% |
%uauth_engine% |
活跃的服务端调度器(Folia、Purpur、Paper、Spigot、Bukkit) |
💻 命令与权限
玩家命令
| 命令 |
别名 |
描述 |
权限 |
/register <password> <password> |
/reg |
在服务器上注册新账户 |
ultimateauth.auth.use (默认:开启) |
/login <password> |
/l |
登录已注册的账户 |
ultimateauth.auth.use (默认:开启) |
/changepassword <old> <new> |
— |
在登录状态下更新账户密码 |
ultimateauth.auth.use (默认:开启) |
/logout |
— |
结束当前会话并锁定账户 |
ultimateauth.auth.use (默认:开启) |
管理员与安全命令
| 命令 |
描述 |
权限 |
/auth status |
查看实时存储池、会话、锁定状态及 Folia/Paper 遥测数据 |
ultimateauth.auth.admin (默认: op) |
/auth info <玩家> |
检查 UUID、最后登录 IP、上次登录时间、锁定状态及关联的备用账号 |
ultimateauth.auth.admin |
/auth alts <玩家|IP> |
追踪所有与某玩家的 IP 或目标 IP 关联的已注册账户 |
ultimateauth.auth.admin |
/auth purge <天数> |
异步清除处于休眠状态且超过 <天数>(>= 7)未活跃的账户 |
ultimateauth.auth.admin |
/auth forcelogin <玩家> |
立即验证在线玩家的身份会话 |
ultimateauth.auth.admin |
/auth unlock <玩家> |
清除活跃的暴力破解锁定和失败尝试计数 |
ultimateauth.auth.admin |
/auth reset <玩家> |
使会话失效并要求立即重新认证 |
ultimateauth.auth.admin |
/auth changepassword <player> <new> |
从控制台或游戏内强制更新玩家密码 |
ultimateauth.auth.admin |
/auth unregister <player> |
永久删除玩家的认证记录 |
ultimateauth.auth.admin |
/auth setspawn |
启用出生点保护并设置安全预登录认证出生点 |
ultimateauth.auth.admin |
| /auth reload | 热重载 config.yml、messages.yml 和数据库连接池 | ultimateauth.auth.admin |
| /permanentban <reason> <player> | 永久封禁一名玩家及其最后已知 IP 地址 | ultimateauth.ban.admin (默认:op) |
| /tempban <reason> <player> <days> [months] [years] | 临时封禁一名玩家及其 IP 地址 | ultimateauth.ban.admin |
| /unban <player> | 解除活跃的永久或临时封禁 | ultimateauth.ban.admin |
⚙️ 快速入门配置 (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: ""
```yaml
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
🛡️ 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 Folia, Purpur, Paper, Spigot, and Bukkit servers across Minecraft 1.16.5 through 26.3 (all 35 releases).
Designed to replace outdated, main-thread-blocking login plugins, Ultimate Auth combines non-blocking HikariCP database pooling (SQLite, MySQL & MariaDB), BCrypt adaptive hashing, Floodgate/Geyser Bedrock auto-authentication, Alt-IP account forensics, coordinate spawn-protection, Chat-Guard credential leak prevention, and native PlaceholderAPI integration in one self-contained JAR.
⚡ Why Server Owners Switch to Ultimate Auth
| Capability |
Ultimate Auth v3.6.0 |
Legacy Auth Plugins |
| Minecraft Version Support |
1.16.5 – 26.3 (All 35 Releases, Zero NMS Breakage) |
Breaks on 1.21.4+ / 26.3 (Sound enum changes) |
| Server Loaders |
Bukkit, Spigot, Paper, Purpur & Folia |
Crashes 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 |
| Alt-IP Forensics & Account Purge |
Built-in /auth alts <player|ip> & /auth purge <days> |
Requires external IP-tracking plugins |
| PlaceholderAPI Integration |
Built-in %ultimateauth_*% & %uauth_*% (11 Placeholders) |
Requires separate expansion downloads |
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 public 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 |
🆕 What's New in v3.6.0
- Universal
1.16.5 – 26.3 Audio Compatibility: Eliminated org.bukkit.Sound enum bytecode bindings in favor of string-keyed sound identifiers (entity.player.levelup, entity.firework_rocket.launch, entity.firework_rocket.blast, block.note_block.bass), ensuring zero IncompatibleClassChangeError crashes on Minecraft 1.21.4+ and 26.3.
- Native PlaceholderAPI Expansion (
%ultimateauth_*% & %uauth_*%): Instant scoreboard, TAB, and HUD placeholders for authentication status, Bedrock detection, active sessions, pending logins, brute-force lockouts, storage backend, and runtime engine (Folia, Purpur, Paper, Spigot, Bukkit).
- Alt-IP Forensics (
/auth alts <player|ip>): Trace every registered account linked to a player's last known IP or registration IP in milliseconds, plus automatic alt listings inside /auth info <player>.
- Inactive Account Purge (
/auth purge <days>): Prune dormant accounts older than <days> (minimum 7 days safety guard) asynchronously.
- Command-Block Bypass Permission Fix: Properly honors
ultimateauth.commandblock.bypass as documented in plugin.yml.
🔥 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 (
bcrypt-cost: 12 default).
- Frictionless Session Resumption: Returning players on the same IP address within the configurable window (
30m default) 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 with 1.16.5–1.20.4.
2. 🎮 Seamless Bedrock & Geyser/Floodgate Auto-Authentication
- No Clunky Controller Typing: Automatically detects Bedrock Edition players via Floodgate API (reflective zero hard-dependency hook) 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 the AsyncPlayerPreLoginEvent stage 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, or 7login 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 (teleportAsync on Paper/Folia) the moment they authenticate.
4. 📊 Native PlaceholderAPI Expansion (%ultimateauth_*% & %uauth_*%)
When PlaceholderAPI is installed, Ultimate Auth automatically registers both %ultimateauth_<identifier>% and shorthand %uauth_<identifier>%:
| Placeholder |
Shorthand |
Output |
%ultimateauth_logged_in% |
%uauth_logged_in% |
true or false |
%ultimateauth_authenticated% |
%uauth_authenticated% |
yes or no |
%ultimateauth_status% |
%uauth_status% |
Authenticated, Pending Login, or Offline |
%ultimateauth_bedrock% |
%uauth_bedrock% |
true if Bedrock/Floodgate player, else false |
%ultimateauth_session_active% |
%uauth_session_active% |
true if player has a valid IP session |
%ultimateauth_online_authenticated% |
%uauth_online_authenticated% |
Count of currently authenticated online players |
%ultimateauth_pending_count% |
%uauth_pending_count% |
Count of online players awaiting login/register |
%ultimateauth_active_sessions% |
%uauth_active_sessions% |
Total cached IP sessions |
%ultimateauth_active_lockouts% |
%uauth_active_lockouts% |
Total active brute-force lockouts |
%ultimateauth_storage% |
%uauth_storage% |
Active database engine (SQLITE, MYSQL, MARIADB) |
%ultimateauth_engine% |
%uauth_engine% |
Active server scheduler (Folia, Purpur, Paper, Spigot, Bukkit) |
💻 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 & Security 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 IP, last login, lockout state & linked alt accounts |
ultimateauth.auth.admin |
/auth alts <player|ip> |
Trace all registered accounts sharing a player's IP or target IP |
ultimateauth.auth.admin |
/auth purge <days> |
Asynchronously purge dormant accounts inactive for <days> (>= 7) |
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
评论 0
登录后参与评分
还没有评论,来抢沙发吧