PremiumBridge Velocity
PremiumBridge Velocity 是 Velocity 网络的配套安全代理插件。
它允许你的 Minecraft 后端保持离线模式,使离线玩家仍能加入服务器;同时,经过验证的在线会话会在代理端进行检查,并通过签名断言和现代玩家信息转发机制传递给后端的 PremiumBridge。
需要安装 PremiumBridge
? 独特之处
| 特性 |
优势 |
| ? 代理端验证 |
在启动后端认证流程之前,先检查在线会话。 |
| ?️ 签名验证结果 |
后端仅在验证了短期有效的签名断言后,才接受自动在线登录。 |
| ? 现代信息转发 |
原生向 Paper 转发在线 UUID、皮肤属性和个人资料数据。 |
| ? 无需原始加密握手 |
Velocity 模式不使用自定义的后端 EncryptionRequest 数据包。 |
| ? 支持离线后端 |
后端可保持离线模式以接纳离线玩家。 |
| ✅ 安全的身份处理 |
UUID 和 IP 地址不会被用作账户所有权的证明。 |
⚖️ 离线后端,在线代理体验
服务器后端保持离线模式,但 Velocity 会在玩家到达后端之前完成在线验证步骤。
在线玩家可以获得:
- 无缝的在线会话验证
- 原生的 UUID 和皮肤资料转发
- 后端的自动 PremiumBridge 认证
- 与配置的 AuthMe 或 OpeNLogin 集成兼容
- 无需自定义后端加密握手的简洁登录体验
离线玩家继续使用正常的后端认证流程,不会被视为在线状态。
? Velocity 支持
PremiumBridge Velocity 是一个可选的配套模块。PremiumBridge 本身并不依赖 Velocity,但当 PremiumBridge 部署在 Velocity 代理后面时,此模块是必需的。
启用 Velocity 支持的方法:
- 将
PremiumBridge-Velocity.jar 放入 Velocity/plugins/ 目录。
- 将
PremiumBridge.jar 放入每个 Paper 或 Purpur 后端的 plugins/ 文件夹中。
- 在
velocity.toml 中设置 player-info-forwarding-mode = "modern"。
- 在
config/paper-global.yml 中启用原生的 Velocity 转发功能,并使用相同的转发密钥。
- 在后端配置中将
premium-verification.mode 设置为 velocity-modern。
- 将配套的共享密钥复制到每个后端,然后重启代理和后端的服务器。
请确保保护后端端口,防止玩家绕过代理直接连接。
? 兼容性
该模块专为支持以下版本的 PremiumBridge 后端发布版设计:
- Minecraft Java
1.21.9-1.21.11
- Minecraft Java
26.1.x
- Minecraft Java
26.2
支持的后端平台:Paper 及其兼容分支(如 Purpur)。
? 要求
- 支持现代玩家信息转发的 Velocity
- 每个后端都需安装 PremiumBridge
- AuthMe、OpeNLogin 或其他受支持的后端认证插件
- 根据所选 PremiumBridge 功能的要求,后端可能需要安装 ProtocolLib
本项目仅为 Velocity 配套模块,并非独立的后端认证插件。
✨ 后端插件提供的额外功能
当与后端的 PremiumBridge 一起安装时,网络还可以使用以下功能:
- ? 可选的在线自动注册
- ? 离线到在线的数据迁移
- ?️ 在线昵称保护
- ? 对已验证在线玩家的认证插件消息过滤
- ? 通过
addhead.premium 权限集成 AddHeads
- ? 供其他插件使用的公共 API
PremiumBridge Velocity
PremiumBridge Velocity is a secure proxy companion for Velocity networks.
It keeps your Minecraft backend in offline mode so offline players can still join, while verified online sessions are checked at the proxy and passed to PremiumBridge on the backend through signed assertions and modern player information forwarding.
PremiumBridge required
? What makes it different
| Feature |
Benefit |
| ? Proxy-side verification |
Online sessions are checked before the backend authentication flow. |
| ?️ Signed verification result |
The backend accepts online auto-login only after validating a short-lived signed assertion. |
| ? Modern forwarding |
Online UUID, skin properties, and profile data are forwarded natively to Paper. |
| ? No raw encryption handshake |
Velocity mode does not use a custom backend EncryptionRequest packet. |
| ? Offline backend support |
The backend can remain in offline mode for offline players. |
| ✅ Safe identity handling |
UUIDs and IP addresses are never treated as proof of account ownership. |
⚖️ Offline backend, online proxy experience
The server backend remains in offline mode, but Velocity handles the online verification step before the player reaches the backend.
Online players can receive:
- Seamless online-session verification
- Native UUID and skin profile forwarding
- Automatic PremiumBridge authentication on the backend
- Compatibility with configured AuthMe or OpeNLogin integration
- A clean login experience without a custom backend encryption handshake
Offline players continue to use the normal backend authentication flow and are not treated as online automatically.
? Velocity Support
PremiumBridge Velocity is an optional companion module. PremiumBridge does not require Velocity, but this module is required when PremiumBridge is used behind a Velocity proxy.
To enable Velocity support:
- Put
PremiumBridge-Velocity.jar into Velocity/plugins/.
- Put
PremiumBridge.jar into the plugins/ folder of every Paper or Purpur backend.
- Enable
player-info-forwarding-mode = "modern" in velocity.toml.
- Enable native Velocity forwarding in
config/paper-global.yml and use the same forwarding secret.
- Set
premium-verification.mode to velocity-modern in the backend configuration.
- Copy the companion shared secret to every backend and restart the proxy and backends.
Keep backend ports protected so players cannot bypass the proxy.
? Compatibility
The module is designed for PremiumBridge backend releases supporting:
- Minecraft Java
1.21.9-1.21.11
- Minecraft Java
26.1.x
- Minecraft Java
26.2
Supported backend platforms: Paper and compatible forks such as Purpur.
? Requirements
- Velocity with modern player information forwarding
- PremiumBridge on every backend
- AuthMe, OpeNLogin, or another supported backend authentication plugin
- ProtocolLib on the backend when required by the selected PremiumBridge features
This project is the Velocity companion module. It is not a standalone backend authentication plugin.
✨ Extra features provided by the backend plugin
When installed together with PremiumBridge on the backend, the network can also use:
- ? Optional online auto-registration
- ? Offline-to-online data migration
- ?️ Online nickname protection
- ? Auth-plugin message filtering for verified online players
- ? AddHeads integration through the
addhead.premium permission
- ? Public API for other plugins
评论 0
登录后参与评分
还没有评论,来抢沙发吧