🛡️ Ultimate Auth — 企业级认证、反机器人与会话安全套件
Ultimate Auth 是一款经过实战检验、零延迟的认证与账户防御引擎,专为 Minecraft 1.16.5 至 26.3 版本下的现代 Paper, Purpur, Spigot, Bukkit 和 Folia 服务器网络打造。
Ultimate Auth 旨在取代那些过时且阻塞主线程的登录插件。它将 非阻塞 HikariCP 数据库连接池、BCrypt 自适应哈希算法、Floodgate/Geyser Bedrock 自动认证、坐标出生点保护 以及 Chat-Guard 凭证泄露防护 整合在一个独立的 JAR 文件中。
⚡ 为什么服务器管理员转向 Ultimate Auth
| 功能特性 | Ultimate Auth v3.5.0 | 传统认证插件 |
|---|---|---|
| Minecraft 版本支持 | 1.16.5 – 26.3(全部 35 个版本) | 通常锁定在单个 NMS 版本 |
| 服务器加载器 | Bukkit, Spigot, Paper, Purpur & Folia | 在 Folia 区域线程上会崩溃 |
| 数据库引擎 | SQLite(零配置)、MySQL & MariaDB(HikariCP) | 无连接池同步 SQLite/MySQL |
| Bedrock / Floodgate 支持 | 零依赖自动登录 + 前缀回退机制 | 需要付费插件或额外桥接 |
坐标隐私 (Spawn-Auth) |
传送至认证出生点并恢复精确坐标 | 登录前暴露生存坐标 |
| Chat-Guard 密码盾牌 | 阻止聊天中的 login pass / 7login pass 拼写错误 |
将意外输入的密码广播到聊天频道 |
| Discord 安全 Webhooks | 实时封禁、管理员登录及密码警报 | 无此功能 |
| 内置 IP 与账户封禁套件 | 包含 /tempban, /permanentban, /unban |
需要单独的惩罚插件 |
🔥 核心功能与架构
1. 🔐 自适应 BCrypt 加密与智能 IP 会话
- 行业标准哈希:密码通过专用的工作线程池异步进行哈希处理,使用可配置的 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 防护
- 连接突发限制器:在全局连接峰值(
global-max-per-second: 80)和每个 IP 的加入洪水到达世界线程之前,在AsyncPlayerPreLoginEvent阶段对其进行节流控制。 - 渐进式暴力破解锁定:在可配置的失败登录尝试次数后(
max-attempts: 5,lockout-minutes: 15)自动锁定账户和 IP,并发送即时 Discord Webhook 嵌入通知。 - Chat-Guard 密码泄露防护:在消息被广播到公共聊天之前,拦截意外的聊天消息,如
login secret123、l secret123、.login secret123或7login secret123(漏按 Shift 键)。 - 坐标出生点保护 (
/auth setspawn):通过将未认证的玩家保留在您安全的认证出生点,并在他们认证的瞬间恢复其确切的生存位置,防止坐标嗅探漏洞利用。
4. 🎨 现代 MiniMessage UI(BossBar、标题与动作栏)
- 动态倒计时 BossBar:随着登录计时器倒数,颜色平滑地从 绿色 → 黄色 → 红色 过渡。
- 持久化标题与音效提示:清晰的 MiniMessage 渐变效果、失明隐私遮罩、移动/物品栏/命令锁定,以及在认证成功时的庆祝升级音效。
💻 命令与权限
玩家命令
| 命令 | 别名 | 描述 | 权限 |
|---|---|---|---|
/register <password> <password> |
/reg |
在服务器上注册新账户 | ultimateauth.auth.use (默认: true) |
/login <password> |
/l |
登录您的已注册账户 | ultimateauth.auth.use (默认: true) |
/changepassword <old> <new> |
— | 在登录状态下更新您的账户密码 | ultimateauth.auth.use (默认: true) |
/logout |
— | 结束当前会话并锁定您的账户 | ultimateauth.auth.use (默认: true) |
管理员命令
| 命令 | 描述 | 权限 |
|---|---|---|
/auth status |
查看实时存储池、会话、锁定状态及 Folia/Paper 遥测数据 | ultimateauth.auth.admin (默认:op) |
/auth info <player> |
检查 UUID、最后已知 IP、上次登录时间戳及锁定状态 | ultimateauth.auth.admin |
/auth forcelogin <player> |
立即验证在线玩家的会话 | ultimateauth.auth.admin |
/auth unlock <player> |
清除活跃的暴力破解锁定和失败尝试计数器 | ultimateauth.auth.admin |
/auth reset <player> |
使会话失效并强制立即重新认证 | ultimateauth.auth.admin |
/auth changepassword <player> <new> |
从控制台或游戏内强制更新玩家密码 | ultimateauth.auth.admin |
/auth unregister <player> |
永久删除玩家的认证记录 | ultimateauth.auth.admin |
/auth setspawn |
启用出生点保护并设置安全的预登录 Auth Spawn | 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: ""
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 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
下载 ULTIMATE AUTH
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ULTIMATE AUTH
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ULTIMATE AUTH
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ULTIMATE AUTH
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ULTIMATE AUTH
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ULTIMATE AUTH
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ULTIMATE AUTH
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ULTIMATE AUTH
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ULTIMATE AUTH
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ULTIMATE AUTH
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
🚀 Ultimate Auth v3.5.0 — 通用版 1.16.5–26.3 & 原生 Folia 引擎,坐标出生点认证隐私与聊天防护盾
✨ 全新旗舰特性
- 坐标隐私与登录前出生点保护 (
auth.spawn-protection+/auth setspawn):- 在玩家执行
/login之前,通过将未认证的玩家暂时停留在指定的 Auth 出生点(或世界出生点),并在认证成功后自动将其传送回加入前的确切坐标(若其在登录前断开连接,则安全恢复其离线时的坐标),从而防止生存基地被恶意探测坐标。
- 在玩家执行
- 聊天防护误输密码盾牌 (
auth.chat-guard.block-accidental-password):- 当玩家在没有输入斜杠的情况下误敲了登录/注册命令(例如
login mypass、l mypass、.login mypass、7login mypass)时,自动拦截并取消该公开聊天消息,防止凭证泄露到公共聊天频道中。
- 当玩家在没有输入斜杠的情况下误敲了登录/注册命令(例如
- 管理员安全遥测数据 (
/auth status):- 实时诊断概览,显示当前运行的引擎/调度器模式(
Folia Regionized或Bukkit/Paper)、HikariCP 存储后端(SQLite/MySQL/MariaDB)、已注册的账户总数、已认证与待认证的玩家数量、缓存的 IP 会话以及活跃的暴力破解封锁状态。
- 实时诊断概览,显示当前运行的引擎/调度器模式(
- 快捷命令别名 (
/l&/reg):- 新增
/l和/reg命令别名,并对客户端命令补全进行白名单配置,以实现快速的玩家身份验证。
- 新增
🛠️ 通用兼容性与关键错误修复
- 原生 Folia 区域化调度器支持 (
folia-supported: true):- 基于
GlobalRegionScheduler和每个玩家的EntityScheduler构建了PlatformScheduler,消除了 Folia 服务器上的UnsupportedOperationException崩溃问题。
- 基于
- 通用版 1.16.5 – 26.3 兼容性(涵盖 35 个发行版本):
- 将字节码目标降低至 Java 17(
class file 61.0),设置api-version: '1.16',并为Player#isTransferred()(1.20.5+)添加了反射检测机制,修复了在1.16.5至1.20.4服务器上因NoSuchMethodError导致的崩溃。
- 将字节码目标降低至 Java 17(
- 修复缺失的 BossBar 与封禁消息键值(
messages.yml自动迁移):- 在服务启动和重载时自动迁移
messages.yml中的键值,修复了<red>Missing string: auth.bossbar</red>以及缺失的 IP 封禁确认字符串的问题。
- 在服务启动和重载时自动迁移
- 零延迟 Tab 补全与不区分大小写的 SQL 索引:
- 将
/auth、/tempban和/premanentban的 Tab 补全中同步执行的Bukkit.getOfflinePlayers()磁盘扫描替换为 O(1) 复杂度的内存用户名缓存,并将AuthDatabase#findByUsername更新为查询已建立索引的username_lower列。
- 将
- 自包含阴影运行时环境:
- 正确打包并重定位 Kyori Adventure、HikariCP、jBCrypt 和 SQLite JDBC 至生产制品内部,确保 Spigot、CraftBukkit、Paper、Purpur 和 Folia 服务器能够以零缺失依赖的状态正常启动。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧