? PureAuth
适用于 Minecraft 服务器和网络的可配置身份验证系统。
通过密码或 PIN 码登录、双因素身份验证、账户恢复以及渐进式账户锁定来保护玩家账户。PureAuth 将账户保护、代理同步和管理工具集于一体,并提供可编辑的英文和波兰语消息。
专为 Paper/Purpur 离线模式服务器 构建,并包含针对 Velocity 和 BungeeCord 的专用模块。
✨ 功能一览
- ? 密码注册、登录和密码管理
- ? 通过可配置的库存 GUI 进行可配置的 PIN 码身份验证
- ? TOTP 双因素身份验证及备用恢复代码
- ?️ Admin Guard(管理员守卫),要求指定员工账户启用 2FA
- ? 通过安全问题进行账户恢复
- ⏳ 渐进式临时和永久账户锁定
- ? 身份验证前隐藏玩家并限制交互
- ? 可选的高级自动登录,需满足同 IP 要求
- ? 与玩家 IP 和账户安全状态关联的短重连会话
- ? 代理同步和 Redis 网络支持
- ⚖️ Fair Play Guard(公平游戏守卫),用于由管理员主导的玩家检查
- ? 可配置的 Discord Webhook 通知
- ?️ SQLite 和 MySQL/MariaDB 存储
- ? 带可配置保留期的计划备份
- ? 可选 PlaceholderAPI 集成
- ? 可编辑的英文和波兰语消息
? 灵活的身份验证
玩家可以使用密码注册和登录,或通过可配置的库存 GUI 启用 PIN 码登录。密码、PIN 码和恢复答案均以哈希形式存储。
可选的注册验证码和每个 IP 的账户限制有助于控制账户创建。重复的身份验证失败尝试会导致从临时锁定升级为更长时间的锁定,最终导致永久账户锁定。
管理员可以使用插件的管理命令解锁账户。
? 双因素身份验证 & Admin Guard
玩家可以使用兼容的身份验证器应用添加 基于 TOTP 的 2FA,例如:
- Google Authenticator
- Aegis
- 2FAS
在通过密码或 PIN 码验证后,启用 2FA 的账户需要输入身份验证器代码。备用代码在无法访问身份验证器时提供恢复选项。
Admin Guard 可以要求指定的员工账户在游戏访问之前配置 2FA。它防止这些账户禁用强制 2FA,并在通过备用代码恢复后要求重新设置。
? 登录前的保护
未认证的玩家对其他玩家隐藏,且无法自由地与服务器交互。
限制措施涵盖移动、聊天、命令、库存更改、物品掉落与拾取、攻击、实体交互、手部交换、物品消耗、传送门和骑乘。在需要的地方,身份验证命令和 PIN GUI 仍然可用。
在强制 Admin Guard 设置期间,保护措施保持活跃,并具有可配置的身份验证超时时间。
? 恢复 & 重连会话
玩家可以配置一个安全问题并使用它来恢复账户。成功的密码恢复会移除遗忘的 PIN 码,而配置的 2FA 仍然适用。
可选的重连会话可减少重复登录。会话会根据玩家的 IP 和账户安全状态进行检查,因此安全更改会使旧会话失效。
还提供高级自动登录功能,具有可配置的同 IP 要求。
? 服务器网络
PureAuth 包含针对 Paper/Purpur、Velocity 和 BungeeCord 的独立模块。
代理到后端的身份验证同步使用共享密钥来认证同步消息。Redis 模式 提供跨代理的用户名协调和共享重连会话。
网络可以选择如何处理 Redis 故障对新连接的影响,包括关闭策略(fail-closed)。
⚖️ Fair Play Guard
为管理员提供受控的玩家检查工作流:
- 设置专用的检查位置
- 传送并限制选定的玩家
- 保持检查聊天仅在玩家和检查员之间私密可见
- 显示可配置的操作说明和提醒
- 强制执行检查区域半径
- 在检查期间断开连接后应用持久性限制
- 清除检查并恢复玩家状态
⚙️ 配置与管理
通过单独的 英文和波兰语消息文件 自定义聊天消息、标题、操作栏、踢出消息和 PIN GUI 文本。
Discord Webhook 可以报告选定的账户和管理事件。敏感的身份验证命令会从标准服务器命令日志中抑制,而 PureAuth 的管理审计会对密码和 PIN 参数进行脱敏处理。
计划备份、可配置的数据库池和可选的 PlaceholderAPI 支持有助于将 PureAuth 集成到您的服务器设置中。
? PureAuth
A configurable authentication system for Minecraft servers and networks.
Protect player accounts with password or PIN login, two-factor authentication, account recovery and progressive account locks. PureAuth brings together account protection, proxy synchronization and administration tools, with editable English and Polish messages.
Built for Paper/Purpur offline-mode servers, with dedicated modules for Velocity and BungeeCord.
✨ Features at a glance
- ? Password registration, login and password management
- ? Configurable PIN authentication through an inventory GUI
- ? TOTP two-factor authentication and backup recovery codes
- ?️ Admin Guard requiring 2FA for designated staff accounts
- ? Account recovery through security questions
- ⏳ Progressive temporary and permanent account locks
- ? Player hiding and interaction restrictions before authentication
- ? Optional Premium Auto-Login with a same-IP requirement
- ? Short reconnect sessions tied to the player’s IP and account security state
- ? Proxy synchronization and Redis network support
- ⚖️ Fair Play Guard for administrator-led player inspections
- ? Configurable Discord webhook notifications
- ?️ SQLite and MySQL/MariaDB storage
- ? Scheduled backups with configurable retention
- ? Optional PlaceholderAPI integration
- ? Editable English and Polish messages
? Flexible authentication
Players can register and log in using passwords, or enable PIN login through a configurable inventory GUI. Passwords, PINs and recovery answers are stored as hashes.
Optional registration CAPTCHA and account limits per IP help control account creation. Repeated failed authentication attempts can escalate from a temporary lock to a longer lock and finally a permanent account lock.
Administrators can unlock accounts using the plugin’s management commands.
? Two-factor authentication & Admin Guard
Players can add TOTP-based 2FA using compatible authenticator apps such as:
- Google Authenticator
- Aegis
- 2FAS
After password or PIN verification, accounts with 2FA require an authenticator code. Backup codes provide a recovery option when access to the authenticator is lost.
Admin Guard can require designated staff accounts to configure 2FA before gaining access to the game. It prevents those accounts from disabling mandatory 2FA and requires a new setup after backup-code recovery.
? Protection before login
Unauthenticated players remain hidden from other players and cannot freely interact with the server.
Restrictions cover movement, chat, commands, inventory changes, item drops and pickups, attacks, entity interactions, hand swapping, item consumption, portals and mounting. Authentication commands and the PIN GUI remain available where required.
Protection remains active during mandatory Admin Guard setup, with a configurable authentication timeout.
? Recovery & reconnect sessions
Players can configure a security question and use it to recover their account. Successful password recovery removes a forgotten PIN, while configured 2FA still applies.
Optional reconnect sessions reduce repeated logins. Sessions are checked against the player’s IP and account security state, so security changes invalidate older sessions.
Premium Auto-Login is also available, with a configurable same-IP requirement.
? Server networks
PureAuth includes separate modules for Paper/Purpur, Velocity and BungeeCord.
Proxy-to-backend authentication synchronization uses a shared secret to authenticate synchronization messages. Redis mode provides cross-proxy username coordination and shared reconnect sessions.
Networks can choose how Redis failures affect new connections, including a fail-closed policy.
⚖️ Fair Play Guard
Give administrators a controlled workflow for player inspections:
- Set a dedicated inspection location
- Teleport and restrict the selected player
- Keep inspection chat private between the player and inspector
- Display configurable instructions and reminders
- Enforce an inspection-area radius
- Apply a persistent restriction after disconnecting during an inspection
- Clear the inspection and restore the player’s state
⚙️ Configuration & administration
Customize chat messages, titles, actionbars, kick messages and PIN GUI text through separate English and Polish message files.
Discord webhooks can report selected account and administrative events. Sensitive authentication commands are suppressed from standard server command logs, while PureAuth’s administrative audit redacts password and PIN arguments.
Scheduled backups, configurable database pools and optional PlaceholderAPI support help integrate PureAuth into your server setup.
下载 PureAuth
下载 PureAuth
下载 PureAuth
下载 PureAuth
下载 PureAuth
下载 PureAuth
下载 PureAuth
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PureAuth
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
PureAuth 6.3.1
认证与会话
- 重连会话需要匹配的 IP 和身份、未过期的有效期以及当前的账户安全设置。旧的会话记录无法授予自动访问权限。
- 密码、PIN 码、双因素认证(2FA)和恢复设置的更改会使之前的信任失效。管理员更改和密码恢复需要重新进行身份验证;所有者自行更改设置时可能会保留当前连接。
- 活跃账户会定期检查,以便后端发生的安全更改不会让旧访问权限无限期保持活跃。
- 连接截止时间涵盖密码登录、PIN 码、2FA 和强制性的 Admin Guard 设置。关闭 GUI 或进入其他阶段并不会移除该截止时间。
代理同步与 Redis
-
修复了经过身份验证的玩家从大厅切换到另一个后端后 PIN 码窗口仍保持打开的问题。有效的同步会关闭所需的登录窗口,而不会标记登录中断;延迟的窗口打开或更早的 PIN 码结果无法将其恢复。
-
简化了有效同步的完成过程,同时保留了签名、安全性新鲜度、账户锁定、公平游戏(Fair Play)和强制性 Admin Guard 检查。自愿设置和更改 PIN 码的窗口仍为独立操作。
-
后端登录同步现在需要在每个后端和代理上都需要签名确认和相同的共享密钥。
-
确认信息与玩家、当前连接、当前账户安全设置以及短暂的有效期相关联。旧的、重放的或未签名的消息无法授予访问权限。
-
改进了初始化和有效同步的处理方式,确保签名响应不会被并发的玩家加入准备过程所阻止。
-
改进了用户名预留维护:放弃的连接尝试不会无限期续期,被拒绝的重复请求无法释放真实玩家的预留。
-
当连接完成时会再次检查预留所有权。如果必需的 Redis 或数据库不可用,则拒绝接入,而不是绕过保护。
-
改进了 Velocity YAML 配置处理以及两个代理上的可编辑消息缓存。
恢复
- 恢复失败和惩罚历史在重连和重启后得以保留。各阶段与错误登录惩罚共享历史记录。
- 密码恢复会移除遗忘的 PIN 码,撤销之前的会话,并要求重新连接。现有的 2FA 仍然要求使用。
- 之前验证过的答案不能覆盖更新的安全更改。密码替换和 PIN 码移除是一个操作;写入失败不会宣布成功。
- 管理员解锁也会清除恢复答案的失败计数器。
TOTP、备份代码和 Admin Guard
- 修复了所有者正确移除 2FA 后立即出现的间歇性断开连接问题。外部安全重置和账户锁定仍然会撤销访问权限。
- 新的 TOTP 密钥提供 160 位熵;现有兼容密钥仍受支持。
- 增强了密钥和六位代码的验证,同时保留了标准的 30 秒 TOTP 应用窗口。
- 启用 2FA 时会一起存储密钥、启用状态和整个备份代码集。并发或过时的更新无法覆盖更新的安全设置。
- 即使在不同实例间同时请求,备份代码恢复也只能成功一次。它会禁用之前的 2FA 设置并使之前的整个代码集失效。
- Admin Guard 会在必需的双因素认证被正确确认并保存之前, withheld 完整的身份验证。
- 错误的代码和失败的写入无法解除保护。普通移除命令无法禁用强制性 2FA。
- 已通过身份验证的管理员进行的备份恢复会将账户再次限制,直到新的强制性 2FA 设置完成。
注册与持久化
- 每 IP 限制和账户创建在共享数据库中以原子方式进行检查。并发读取不能让同时进行的注册绕过限制。
- 玩家响应区分了 IP 限制、现有账户和存储故障。
- 强制执行 BCrypt 的 72 字节 UTF-8 输入限制,以防止长值静默截断。
- 失败的过时的安全写入不能宣布成功或授予身份验证。
性能与垃圾信息限制
-
修复了在有效同步后等待较早的 PIN 码尝试的问题:过时的尝试不再阻塞新命令。其他限制和对并行身份验证尝试的保护仍然有效。
-
限制了数据库、加密和网络工作队列的大小。饱和状态下不会将昂贵的工作转移到服务器的主线程上。
-
每个玩家一次只能执行一个身份验证操作;快速重复的命令不会导致并发尝试成倍增加。
-
添加了
performance.request_interval_ms,默认为 250 毫秒。线程数、队列大小和此间隔需要完全重启才能生效。 -
断开连接会取消该连接的排队工作。旧的回调不能擦除新连接的请求状态。
-
昂贵的管理操作和审计在主线程外运行。改进了过载处理和限速的重复警告。
-
待处理的 Discord Webhook 限制为 16 个,请求超时时间为 5 秒。超出通知将被丢弃;Webhook 不保证事件存储。
-
添加了缺失的关于注册、Premium 启用/禁用和模块成功启动的 Discord 通知。账户更改事件遵循成功的保存;被拒绝的尝试不会宣布成功。类别切换和交付限制仍然有效。
-
添加了可编辑的英文和波兰语
authentication_wait和authentication_busy消息。
可见性与预登录保护
- 修复了在启用库存限制时,Fair Play Guard 检查期间拖拽物品栏的问题。点击和拖拽操作均会根据配置和检查状态进行限制。
- 在幽灵模式(Ghost Mode)下,玩家背包内容得以保留,而不是被清空并从第二个物品副本中恢复。
- 修复了不同顺序加入游戏的玩家可见性问题,以及先前碰撞和失明状态的恢复问题。
- 扩展了预登录阶段的限制范围,涵盖攻击/投射物、拾取、实体交互、物品栏拖拽、手部切换、传送门、消耗和骑乘行为。
- 用于身份验证的 PIN 码图形界面保持可用,无需解锁其他世界交互即可使用。
命令补全
- 修复了
/pureauth及其别名/pa缺少 TAB 子命令建议的问题。 - 补全建议尊重权限设置,且不区分大小写地匹配已输入的命令行前缀。位置参数和 Fair Play 参数均可补全;当命令需要指定玩家时,会显示在线玩家名称。
- 密码/PIN 字段、未知命令以及无权限的情况不再 fallback 到玩家名称建议。仅限控制台的
stats命令仅向控制台用户展示。
配置、消息与日志
- 修复了在格式错误的管理命令中,额外参数导致重复显示的密码/PIN 泄露问题:从秘密参数位置开始的所有后续参数均会被隐藏处理。
- 修复了对空值/无效验证码字母表及无效长度的接受问题。启用验证码后,无效设置将在启动或重载时被拒绝;被拒绝的重载将保留之前的配置。
- 消息文件在初始化/重载期间加载;缺失的消息条目不会在处理玩家时反复读取文件。
- 重载操作也会刷新重复名称拒绝文本。无效的 YAML 配置将保留之前有效的消息集并报告错误,同时避免打印私有文件内容。
- 仅在重启时生效的设置不会被
/pureauth reload误切换。 - 抑制了包含完整命令(含密码、PIN 码和恢复代码)的标准 Paper 回显日志。保留了管理审计日志,并对敏感参数进行了隐藏处理。
- 安全初始化失败将阻止新玩家进入服务器。
备份与兼容性
- SQLite 生成一致的数据快照;MySQL/MariaDB 导出的数据在不同 SQL 模式下均能保留所有账户字段、Unicode 字符、引号、反斜杠和控制字符。
- 备份仅在写入完成后才被视为完成。备份失败不会替换旧副本,也不会触发轮换机制。
- 并发请求无法重叠执行备份操作。轮换机制至少保留一个 PureAuth 备份,并忽略无关文件;在 POSIX 系统上,新备份文件的访问权限仅限于所有者。
- Paper 模块支持 Minecraft 26.2.x 和 26.3 版本;这两个版本范围已在真实的 Paper 服务器上通过协议客户端进行了测试,包括经过 Velocity 和 BungeeCord 路由的场景。
升级指南
停止网络服务,备份数据,替换所有模块,并在代理服务器和后端服务器中配置相同的 network.sync.shared_secret,同时确保 network.sync.enabled: true。独立服务器可选择保持同步禁用状态。保留账户数据库并合并配置设置。完整的功能说明与安全指南请参见:PureAuth-6.3.1-Wiki-EN.md.
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧