ValleyAuth
ValleyAuth 是一款适用于现代 Paper 服务器的轻量级身份验证、身份标识和玩家数据管理插件。
它允许你在离线模式服务器中运行,同时自动识别合法的 Mojang 账户。高级玩家无需密码即可无缝加入,而未通过身份验证的 Java 版玩家则使用传统的注册/登录系统。
该插件是大多数服务器常用的 FastLogin + Authme 设置的更简单且更方便的替代方案。
主要功能
- 混合身份验证: 通过标准加密握手自动验证有效的 Mojang 账户。(即使服务器处于离线模式!)
- 无缝高级支持: 高级 Java 版玩家完全绕过
/register 和 /login。
- 抗用户名更改: 高级身份绑定到 Mojang UUID,确保在用户名更改时玩家数据安全。
- 确定性离线账户: 未认证的账户被分配一致且确定的 UUID,以保障稳定的玩家数据。
- 一流的跨平台支持: 内置兼容 GeyserMC 和 Floodgate 设置。
身份类型解析
Bedrock 玩家的名称前缀和标识符由 Geyser MC 和 Floodgate 控制,ValleyAuth 需要 Floodgate 来为每个用户识别这些标识符。
ValleyAuth 将连接的玩家路由到三种不同的身份类型:
| 身份类型 |
用户名前缀 |
UUID 来源 |
需要 /login |
| Premium |
(无) |
Mojang Session |
❌ 否 |
| Bedrock |
. |
Floodgate API |
❌ 否 |
| Offline |
- |
ValleyAuth (确定性) |
✅ 是 |
要求
- 服务器: Paper 1.21 或更高版本
- Java 版本: Java 21+
- 依赖项:
packetevents v2.13.0+ (用于强制身份验证流程)
ProtocolLib v5.4.0+ (可选回退方案)
Floodgate (可选,仅在需要 GeyserMC 跨平台游玩时必需)
命令
/register <password> <password> – 注册一个新的 Offline 账户。
/login <password> – 登录现有的 Offline 账户。
配置与机制
ValleyAuth 会根据你的 server.properties 设置自动适应:
online-mode=true – ValleyAuth 退出并允许原版身份验证接管。
online-mode=false – ValleyAuth 对非 Floodgate 连接强制执行 Mojang 验证。
GeyserMC / Floodgate 跨平台注意事项
如果你运行的是使用 GeyserMC 的跨平台服务器,必须安装 Floodgate。
由于 Bedrock 客户端无法执行 Java 加密握手,ValleyAuth 依靠 Floodgate 来识别 Bedrock 连接,并为它们授予稳定的 . 前缀身份,而不会将其锁定在验证循环中。
ValleyAuth
ValleyAuth is a lightweight authentication, identity, and player-data management plugin for modern Paper servers.
It lets you run an offline-mode server while automatically recognizing legitimate Mojang accounts. Premium players join seamlessly without passwords, while unauthenticated Java players use a traditional register/login system.
This plugin is a simple and more convenient alternative to the regular FastLogin + Authme setup most servers use.
Key Features
- Hybrid Authentication: Authenticates valid Mojang accounts automatically via standard encryption handshakes. (Even if server is in offline mode!)
- Seamless Premium Support: Premium Java players bypass
/register and /login completely.
- Name-Change Resilient: Premium identity is tied to Mojang UUIDs, keeping player data safe across username changes.
- Deterministic Offline Accounts: Unauthenticated accounts are assigned consistent, deterministic UUIDs for stable player data.
- First-Class Crossplay Support: Built-in compatibility for GeyserMC and Floodgate setups.
Identity Breakdown
Prefix and identifiers for bedrock players are controlled by Geyser MC and Floodgate, ValleyAuth requires Floodgate to recognize these identifiers for each user.
ValleyAuth routes connecting players into three distinct identity types:
| Identity Type |
Username Prefix |
UUID Source |
Requires /login |
| Premium |
(None) |
Mojang Session |
❌ No |
| Bedrock |
. |
Floodgate API |
❌ No |
| Offline |
- |
ValleyAuth (Deterministic) |
✅ Yes |
Requirements
- Server: Paper 1.21 or higher
- Java Version: Java 21+
- Dependencies:
packetevents v2.13.0+ (Required for forced authentication flow)
ProtocolLib v5.4.0+ (Optional fallback)
Floodgate (Optional, required only for GeyserMC crossplay)
Commands
/register <password> <password> – Register a new Offline account.
/login <password> – Log in to an existing Offline account.
Configuration & Mechanics
ValleyAuth automatically adapts based on your server.properties setup:
online-mode=true – ValleyAuth stands down and allows vanilla authentication to take over.
online-mode=false – ValleyAuth enforces forced Mojang verification for incoming non-Floodgate connections.
GeyserMC / Floodgate Crossplay Notes
If you run a crossplay server using GeyserMC, Floodgate is required.
Because Bedrock clients cannot perform the Java encryption handshake, ValleyAuth relies on Floodgate to identify Bedrock connections and grant them a stable . prefix identity without locking them in a verification loop.
评论 0
登录后参与评分
还没有评论,来抢沙发吧