AuthMeReloaded
“Bukkit 模组 API 的最佳认证插件!”
描述
防止服务器上的用户名被盗!
可用于保护你的离线模式服务器,或增强在线模式服务器的安全性!
AuthMeReloaded 禁止未通过身份验证的玩家执行放置方块、移动、
输入命令或使用物品栏等操作。它还可以踢出名字异常长或短的异常玩家,或将来自被禁国家的玩家踢出服务器。
借助会话登录功能,你每次连接到服务器时都不必再执行认证命令! 所有命令和功能均可在我们的结构清晰的配置文件中启用或禁用。
你还可以创建自己的翻译文件,如果你愿意,可以与我们分享! :)
特性:
- 为 Spigot Legacy(1.16–1.19)、Spigot 1.21(1.20–1.21)、Paper 1.21+ 和 Folia 1.21+ 提供专用构建版本
- 原生代理插件支持 BungeeCord 和 Velocity
- 电子邮件恢复系统!
- 用户名伪装防护。
- 国家白名单/黑名单! (国家代码)
- 内置反机器人系统!
- 强制登录功能:管理员可通过控制台命令使用所有账号登录!
- 避免显示“已从其他位置登录”的消息!
- 支持双因素认证 (2FA)!
- 会话登录!
- 消息以每位玩家客户端的 Minecraft 语言呈现,并支持服务器语言回退
- 可编辑的翻译和消息!
- 支持 MySQL、MariaDB、PostgreSQL 和 SQLite 后端!
- 支持的密码加密算法:SHA256、ARGON2、BCRYPT、PBKDF2、PBKDF2BASE64 — 完整列表
- 支持从外部系统导入哈希值以实现零停机迁移(XFBCRYPT、MYBB、PHPBB、JOOMLA、WORDPRESS、WBB3/WBB4、IPB3 以及 更多)
- 自定义 MySQL 表/列名(适用于论坛数据库)
- 缓存数据库查询!
- 完全兼容 Citizens2、CombatTag、CombatTagPlus!
- 图形化登录/注册对话框,可选 Paper/Folia 加入前对话框
- 受限用户(将用户名与 IP 关联)
- 在正确认证之前保护玩家的物品栏(需要 PacketEvents)
- 正版豁免:Mojang 账号持有者可跳过密码认证(需要 PacketEvents)
- 保存玩家退出时的位置
- 认证前投出的末影珍珠将在登录时返还给玩家
- 登录和注册拥有独立的超时设置
- 在
/email add和/email change保存之前需要确认电子邮件地址 - 自动数据库备份
- 可用语言:翻译文件
- Auth+、LibreLogin、LimboAuth、nLogin、OpeNLogin、tiAuth 的账号导入器——以及内置的 SQLite ↔ MySQL/MariaDB/PostgreSQL 迁移功能。
配置
对话框界面
AuthMe 可以显示图形化登录/注册对话框,而不是基于聊天的提示。
settings.registration.dialog.postJoin.enable启用 加入后 对话框流程。settings.registration.dialog.preJoin.enable在 Paper/Folia 上启用 加入前 对话框流程。- 这两个选项是独立的:你可以启用其中一个、全部启用或都不启用。
- 加入前对话框目前需要支持现代对话框功能的服务器版本,例如 Paper/Folia 1.21.11+。
- 当启用正版豁免时,已验证的正版玩家会完全跳过加入前对话框。
正版豁免
AuthMe 可以让拥有合法 Mojang 账号的玩家完全跳过密码认证。 身份验证是通过在 Minecraft 登录阶段与 Mojang 会话服务器进行密码学握手来完成的——永远不会显示密码提示。
- 在
config.yml中通过settings.enablePremium: true启用。 - 玩家通过
/premium选择加入,通过/freemium选择退出(必须已登录)。管理员可以使用/authme premium <player>//authme freemium <player>添加或移除玩家。 - 直连(离线模式,无代理): 需要 PacketEvents 2.x。如果没有它,启动时将禁用正版豁免(故障关闭)。
- 位于在线模式代理之后(Velocity / BungeeCord): 代理会与 Mojang 进行认证并转发经过验证的 UUID —— 后端不需要 PacketEvents。在后端设置
Hooks.bungeecord: true。 - 位于离线模式代理之后: 在代理上安装
authme-velocity或authme-bungee;正版玩家由代理按玩家进行认证,并将经过验证的 UUID 转发到后端。 - 完整文档:docs/premium.md
命令
权限
- authme.player.* - 用于所有玩家命令
- authme.admin.* - 用于所有管理员命令
- 所有权限节点列表
使用方法
- 如何使用账户导入工具(Auth+、LibreLogin、LimboAuth、nLogin、OpeNLogin、tiAuth)
- 网站集成
- 在不同数据库类型之间转换(例如 SQLite 转 MySQL):
/authme converter sqliteToSql
链接与联系方式
-
支持:
-
开发资源:
<repositories> <repository> <id>codemc-repo</id> <url>https://repo.codemc.org/repository/maven-public/</url> </repository> </repositories> <dependencies> <dependency> <groupId>fr.xephi</groupId> <artifactId>authme-core</artifactId> <version>6.0.1</version> <scope>provided</scope> </dependency> </dependencies> -
统计信息:
要求
编译要求:
authme-core、authme-tools和authme-spigot-legacy需要 JDK 17+- 完整的多模块构建(
authme-bungee、authme-spigot-1.21、authme-paper-common、authme-paper、authme-folia、authme-velocity)需要 JDK 21+- Maven (3.8.8+)
- Git/GitHub(可选)
如何编译项目:
- 使用 Git/GitHub 克隆项目
- 执行命令
mvn clean package- 使用 JDK 17 时,Maven 仅构建兼容 Java 17 的模块
- 使用 JDK 21+ 时,Maven 构建完整的 Reactor
- 构建和工具命令参考:docs/build.md
运行要求:
- 请使用与你的服务器平台/版本匹配的 jar 包:
- Java 17+:
AuthMe-*-Spigot-Legacy.jar— Spigot 1.16.x – 1.19.x- Java 21+:
AuthMe-*-Spigot-1.21.jar— Spigot 1.20.x – 1.21.x- Java 21+:
AuthMe-*-Paper.jar— Paper 1.21+- Java 21+:
AuthMe-*-Folia.jar— Folia 1.21+- Java 21+:
AuthMe-*-Bungee.jar— BungeeCord / Waterfall 代理 (1.19 API)- Java 21+:
AuthMe-*-Velocity.jar— Velocity 3.4+ 代理- PacketEvents 2.x(可选插件;在直连模式下用于库存保护、Tab 补全拦截和高级玩家绕过)
致谢
贡献者:
旧版插件的贡献者:d4rkwarriors, fabe1337, Whoami2 和 pomo4ka
还要感谢:AS1LV3RN1NJA, Hoeze 和 eprimex
GeoIP 许可证:
本产品使用了由 MaxMind 创建的 GeoLite API 数据,详情见
AuthMeReloaded
"The best authentication plugin for the Bukkit modding API!"
Description
Prevent username stealing on your server!
Use it to secure your Offline mode server or to increase your Online mode server's protection!
AuthMeReloaded disallows players who aren't authenticated to do actions like placing blocks, moving,
typing commands or using the inventory. It can also kick players with uncommonly long or short player names or kick players from banned countries.
With the Session Login feature, you don't have to execute the authentication command every time you connect to the server! Each command and every feature can be enabled or disabled from our well-structured configuration file.
You can also create your own translation file and, if you want, you can share it with us! :)
Features:
- Dedicated builds for Spigot Legacy (1.16–1.19), Spigot 1.21 (1.20–1.21), Paper 1.21+, and Folia 1.21+
- Native proxy plugins for BungeeCord and Velocity
- E-Mail Recovery System!
- Username spoofing protection.
- Countries Whitelist/Blacklist! (country codes)
- Built-in AntiBot System!
- ForceLogin Feature: Admins can login with all account via console command!
- Avoid the "Logged in from another location" message!
- Two-factor (2FA) support!
- Session Login!
- Messages served in each player's own Minecraft client language, with server-language fallback
- Editable translations and messages!
- MySQL, MariaDB, PostgreSQL and SQLite Backend support!
- Supported password encryption algorithms: SHA256, ARGON2, BCRYPT, PBKDF2, PBKDF2BASE64 — full list
- Supports hashes from external systems for zero-downtime migration (XFBCRYPT, MYBB, PHPBB, JOOMLA, WORDPRESS, WBB3/WBB4, IPB3, and more)
- Custom MySQL tables/columns names (useful with forum databases)
- Cached database queries!
- Fully compatible with Citizens2, CombatTag, CombatTagPlus!
- Graphical login/register dialogs, with optional Paper/Folia pre-join dialogs
- Restricted users (associate a username with an IP)
- Protect player's inventory until correct authentication (requires PacketEvents)
- Premium bypass: Mojang-account holders skip password auth (requires PacketEvents)
- Saves the quit location of the player
- Ender pearls thrown before authentication are returned to the player on login
- Separate timeouts for login and registration
- Email address confirmation required before saving on
/email addand/email change - Automatic database backup
- Available languages: translations
- Account importers for Auth+, LibreLogin, LimboAuth, nLogin, OpeNLogin, tiAuth — and built-in SQLite ↔ MySQL/MariaDB/PostgreSQL migration.
Configuration
Dialog UI
AuthMe can display graphical login/register dialogs instead of chat-based prompts.
settings.registration.dialog.postJoin.enableenables the post-join dialog flow.settings.registration.dialog.preJoin.enableenables the pre-join dialog flow on Paper/Folia.- Both options are independent: you can enable either one, both, or neither.
- Pre-join dialogs currently require modern dialog-capable server versions such as Paper/Folia 1.21.11+.
- Verified premium players skip the pre-join dialog entirely when premium bypass is enabled.
Premium bypass
AuthMe can let players with a legitimate Mojang account skip password authentication entirely. Identity is verified via a cryptographic handshake with Mojang's session server during the Minecraft login phase — no password prompt is ever shown.
- Enable with
settings.enablePremium: trueinconfig.yml. - Players opt in with
/premiumand out with/freemium(must be logged in). Admins can enrol or remove players with/authme premium <player>//authme freemium <player>. - Direct-connection (offline-mode, no proxy): requires PacketEvents 2.x. Without it, premium bypass is disabled at startup (fail-closed).
- Behind an online-mode proxy (Velocity / BungeeCord): the proxy authenticates with Mojang and forwards the verified UUID — no PacketEvents needed on the backend. Set
Hooks.bungeecord: trueon the backend. - Behind an offline-mode proxy: install
authme-velocityorauthme-bungeeon the proxy; premium players are authenticated per-player by the proxy and the verified UUID is forwarded to the backend. - Full documentation: docs/premium.md
Commands
Permissions
- authme.player.* - for all user commands
- authme.admin.* - for all admin commands
- List of all permission nodes
How To
- How to use the account importers (Auth+, LibreLogin, LimboAuth, nLogin, OpeNLogin, tiAuth)
- Website integration
- Convert between database types (e.g. SQLite to MySQL):
/authme converter sqliteToSql
Links and Contacts
-
Support:
-
Dev resources:
<repositories> <repository> <id>codemc-repo</id> <url>https://repo.codemc.org/repository/maven-public/</url> </repository> </repositories> <dependencies> <dependency> <groupId>fr.xephi</groupId> <artifactId>authme-core</artifactId> <version>6.0.1</version> <scope>provided</scope> </dependency> </dependencies> -
Statistics:
Requirements
Compiling requirements:
- JDK 17+ for
authme-core,authme-tools, andauthme-spigot-legacy- JDK 21+ for the full multi-module build (
authme-bungee,authme-spigot-1.21,authme-paper-common,authme-paper,authme-folia,authme-velocity)- Maven (3.8.8+)
- Git/GitHub (Optional)
How to compile the project:
- Clone the project with Git/GitHub
- Execute command
mvn clean package- With JDK 17, Maven builds only the Java 17-compatible modules
- With JDK 21+, Maven builds the full reactor
- Build and tooling command reference: docs/build.md
Running requirements:
- Use the jar matching your server platform/version:
- Java 17+:
AuthMe-*-Spigot-Legacy.jar— Spigot 1.16.x – 1.19.x- Java 21+:
AuthMe-*-Spigot-1.21.jar— Spigot 1.20.x – 1.21.x- Java 21+:
AuthMe-*-Paper.jar— Paper 1.21+- Java 21+:
AuthMe-*-Folia.jar— Folia 1.21+- Java 21+:
AuthMe-*-Bungee.jar— BungeeCord / Waterfall proxy (1.19 API)- Java 21+:
AuthMe-*-Velocity.jar— Velocity 3.4+ proxy- PacketEvents 2.x (optional plugin; required for inventory protection, tab-complete blocking, and premium bypass in direct-connection mode)
Credits
Contributors:
Team members: developers, translators
Credits for the old version of the plugin: d4rkwarriors, fabe1337, Whoami2 and pomo4ka
Thanks also to: AS1LV3RN1NJA, Hoeze and eprimex
GeoIP License:
This product uses data from the GeoLite API created by MaxMind, available at
下载 AuthMeReloaded
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AuthMeReloaded
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AuthMeReloaded
下载 AuthMeReloaded
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AuthMeReloaded
下载 AuthMeReloaded
下载 AuthMeReloaded
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AuthMeReloaded
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AuthMeReloaded
下载 AuthMeReloaded
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
AuthMe 6.0.1
6.x 系列的一个维护版本。它修复了 Paper 和 Folia 构建中存在的几个会话处理漏洞,加固了代理和正版验证绕过路径,并新增了一种哈希算法、一个转换器和一个新的 API 方法。
如果您在启用预加入对话框的情况下运行 Paper 或 Folia jar 文件,请尽快更新。 请参阅下方的安全部分。
完整更新日志:
安全修复
Paper 和 Folia 上的预加入会话劫持
此问题影响离线模式服务器上的 Paper 1.21+ 和 Folia 1.21+ 构建,当使用预加入登录/注册对话框时。
预加入对话框的瞬态状态(正在输入的密码、注册数据、恢复邮箱、待处理的踢出消息、强制登录 Future)是存储在该玩家的 UUID 下的。在离线模式服务器上,使用相同名称的所有连接都会解析为同一个离线 UUID。这意味着在已注册玩家名称上打开的第二个连接会共享仍在进行身份验证的连接的状态,并且可以读取或清除该状态。
以下三项更改修复了此问题:
- 预加入状态现在基于连接会话键控,而不是基于玩家名称或配置文件 ID。为新连接打开会话时会丢弃该名称之前任何会话的状态,因此永远不会被继承,且状态会被一次性消耗,不会留下半读状态。(
39eed4e) - 连接现在在其建立期间(即在 play 状态之前)占用玩家名称。新的
PendingConnectionRegistry会在登录或注册超时加上短暂的宽限期内持有该名称。在同一名称上的第二个连接将收到“已在线”消息,而不是与第一个连接竞争。单次会话检查也在配置阶段再次运行,而不仅仅是在登录期间。占用将在 TTL 到期后过期,并在加入或断开连接时释放,因此名称永远不会被永久锁定。(098ef5e) - 其名称占用被接管的前加入连接现在将被拒绝,而不是允许继续。(
8b41f72)
未设置共享密钥时的代理自动登录
以前,如果在后端将 Hooks.proxySharedSecret 留空,HMAC 验证仍会使用空字符串作为密钥运行。这无法真正防止伪造的 perform.login 消息。现在,空密钥将拒绝所有 perform.login 消息并记录 Hooks.proxySharedSecret is not configured。(5722849)
如果您依赖代理自动登录,请在更新前将代理生成的密钥复制到每个后端。请参阅 代理配置。
禁用正版验证时接受了正版声明
代理登录验证器没有 enablePremium 门控。即使后端已关闭该功能,对于数据库行中仍带有 premiumUuid 的玩家,经代理验证的正版声明也会被接受。此外,当列表为空时,proxy.started 处理程序会跳过发送正版列表,导致代理保留过时的 premium_names.cache 并继续验证已注册的玩家。
这两个路径现在都由设置控制,并且空列表作为权威信息发送,以便代理在首次联系时替换并持久化其缓存,而不是等待重启。(0f148bf, 5bae6ee, #3127)
新功能
ARGON2ID 哈希算法
ARGON2ID 现在可作为推荐的 passwordHash 值使用。最近的哈希实现也已迁移到 BouncyCastle。请参阅 哈希算法参考。
NexAuth 转换器
您现在可以使用 /authme converter nexauth 从 NexAuth 迁移账户。转换器读取 plugins/NexAuth/config.conf 以确定存储后端。SQLite 直接读取,因此不需要共享数据库,同时也支持 MySQL 和 PostgreSQL。正版 UUID 和 TOTP 密钥将被保留,且 AuthMe 中已存在的玩家将被跳过。请参阅 转换器指南。
请注意,LibreLogin 转换器现在将 Argon2-ID 映射为 ARGON2ID 而不是 ARGON2。
代理插件上的 premium.keepOfflineUuidCompatibility
一个新的代理端标志控制正版玩家如何显示在后端服务器上。默认值为 false,正版玩家保留其 Mojang UUID v4。如果设置为 true,它们保留后端离线 UUID v3 以保持插件兼容性。Velocity 原生支持这两种模式。在 BungeeCord 上,仅当标志为 true 时才需要 PacketEvents。
AuthMeApi#forceLoginFromProxy(String)
一个新的 API 方法,允许代理插件在 Player 对象存在之前强制登录,从而绕过 Paper/Folia 的预加入对话框。先进先出的排序使其对 AsynchronousJoin 保持线程安全。完成操作是异步的,调用者负责验证代理信号。(#3118)
取消消息
对话框取消现在拥有自己的可翻译消息。塔塔尔语翻译也已更新。
错误修复
正版和代理
- 在离线 UUID 模式下,v3/proxy 路径下的高级账户注册将在加入时最终确定,使用与登录验证器相同的单次门控机制。不再出现双重最终确定或虚假的“高级账户验证失败”消息。
- 修复了代理端的高级账户缓存处理问题
- 发送给代理的高级账户名称已进行规范化处理
- 高级账户验证期间保持待定状态,且验证失败现在允许重新连接以强制执行
/login - 自动登录将延续至玩家接下来加入的任何服务器
- 强化了在服务器转换期间的
perform.login处理逻辑 - 待定踢出操作应用于会话或代理自动登录验证之后,而非之前
- 当代理自动登录处于活动状态时,玩家在输入
/freemium后不再卡住(#3105) - 为高级账户用户恢复了末影珍珠
- 高级账户配置文件创建不再使用已弃用的 API
对话框
- 当玩家已通过身份验证时,通过配置阶段的自动登录抑制预加入登录对话框(#3098)
- 当启用该选项时,取消登录或注册对话框的玩家会被正确踢出
- 预加入对话框在失败和点击取消按钮时能正确取消
maxRegPerIp现在在预加入对话框工作流程中进行检查- 如果第一个加入的玩家取消了对话框,则推迟高级账户握手
通用
- 退出时正确恢复行走和飞行速度,并在加入时修复损坏的速度值
- 仅在邮件实际发送后才注册邮箱验证码
- 执行
resetpos后,玩家不再被传送至 0,0,0
破坏性变更
已移除 PermissionsEx 和 zPermissions 支持。 这两个插件多年来均未维护。请在更新前迁移到 LuckPerms 或其他受支持的权限插件。
Hooks.proxySharedSecret 现在是代理自动登录的必填项。 空值不再回退为空 HMAC 密钥,而是会拒绝所有 perform.login 消息。
内部
- 对
output、permission、process、security、service、settings、task和util包进行了 JUnit 5 清理(#3106) - 依赖项更新
其他资源
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧