VeloAuth

插件

· 作者 rafalohaki

为正版玩家提供自动登录,为离线玩家提供注册/登录的安全 Velocity 认证插件。

0 本站下载 0 关注 更新于 1 个月前

最新 1.6.2 · 26.3 · Velocity

一键开服(送7天)

VeloAuth

VeloAuth

完整的 Velocity 身份验证插件,具备智能昵称保护、正版自动登录、安全的离线玩家管理以及可选的内置嵌入式 limbo 功能。

VeloAuth 是什么?

VeloAuth 是一个面向 Velocity 代理的综合身份验证系统,在玩家到达后端服务器之前处理所有玩家的授权。它包含一个仅限回环地址的嵌入式 limbo,同时保持与现有外部 limbo 服务器的完全兼容,并通过智能冲突解决机制保护昵称所有权。

在线测试服务器

想看看 VeloAuth 的实际效果吗?2b2t.pl 正在生产环境中运行该插件——加入服务器以在真实网络中测试正版自动登录、离线注册和昵称保护功能。

主要特性

  • ? 智能昵称保护 - 除非已被盗版玩家注册,否则保留正版昵称。
  • ⚡ 正版自动登录 - Mojang 账户拥有者在通过会话验证后可跳过密码输入;auth/limbo 透传为可选绕过选项。
  • ? 自动昵称变更检测 - 当正版玩家更改其 Mojang 账户名称时,会自动更新数据库记录。
  • ?️ 安全离线认证 - BCrypt 密码哈希、防暴力破解保护,以及由数据库强制执行的原子性首次所有者注册。
  • ? 可选 Floodgate 支持 - Bedrock 平台和关联的 Floodgate 账户会在解析 Mojang 信息前被检测;只有经 Floodgate 确认的 UUID 才能绕过认证服务器。
  • ? 可选内置 Limbo - 使用基于 1.8 版本的内置 limbo,配合经过审查且校验和固定的 ViaVersion 运行时,或者继续使用外部 limbo(如 NanoLimbo)。
  • ?️ 强制主机支持 - 玩家通过自定义域名(例如 pvp.server.com)连接,并在认证成功后被正确路由到目标服务器。
  • ? 智能命令隐藏 - 在授权活动期间隐藏身份验证命令(/login、/register);会话过期后重新显示这些命令。
  • ? 高性能 - 受限的三层正版缓存(内存 → 数据库 → Mojang/Ashcon API)、虚拟线程(Java 21),且在 Velocity 事件循环上无阻塞。
  • ? 可选双因素认证 (TOTP) - 可选的 RFC 6238 第二因素,兼容 Google Authenticator、Authy 和 Aegis。请参阅 2FA.md 获取操作员手册。
  • ? 冲突解决 - 智能处理正版/盗版昵称冲突,提供 /vauth conflicts 命令。
  • ? 管理员与诊断工具 - 健康检查、统计信息以及通过 /vauth report 一键生成的脱敏诊断报告(mclo.gs)。
  • ?️ 多数据库支持 - MySQL、PostgreSQL、H2 和 SQLite,并配备 HikariCP 连接池。
  • ? 17 种语言与 HEX 格式 - 支持 EN, PL, DE, FR, RU, TR, SI, FI, ZH_CN, ZH_HK, JA, HI, VI, KO, TH, ID, PT_BR,完整支持 RGB/HEX 颜色。
  • ? LimboAuth 兼容 - 100% 数据库架构兼容性,支持自动、增量的原地迁移。
  • ? Discord 警报 - 针对安全异常和解析器故障激增的网络钩子通知,并带有自动重试逻辑。

何时使用 VeloAuth

  • 你运行着 Velocity 代理,带有一个或多个后端服务器,并需要在代理层进行身份验证(而非每个后端单独设置)。
  • 你同时接受正版和盗版玩家,需要自动且安全的路由——正版玩家跳过 /login,盗版玩家通过 BCrypt 哈希注册的流程进入。
  • 你已在使用 LimboAuth 并希望在不丢失数据的情况下迁移——VeloAuth 能够无缝读取并升级相同的数据库架构。
  • 你需要高性能 ——正版状态通过三层缓存进行解析,而不会阻塞代理事件循环。

如果你只运行单个后端服务器(Paper/Spigot/Folia)而没有代理,请使用后端侧的身份验证插件。

运行配置文件

在 plugins/veloauth/config.yml 中选择昵称保护的严格程度:

配置 1 — 混合严格模式(默认,推荐)

premium:
  check-enabled: true
  allow-cracked-on-premium-nicks: false
  bypass-auth-server: false

  • 你将获得: 正版玩家使用真实的 Mojang UUID 自动登录;盗版玩家通过 /register + BCrypt 流程;正版昵称严格保留给 Mojang 所有者。
  • 你将失去: 尝试使用已注册的 Mojang 用户名加入的盗版客户端将被拒绝(提示“您未登录到您的 Minecraft 账户”)。
  • 最适合: 接受两类玩家的公共服务器,其中防止昵称被盗至关重要。

配置 2 — 仅盗版模式

premium:
  check-enabled: false

  • 你将获得: 零 HTTP 流量发送至 Mojang/Ashcon,为所有玩家生成确定的离线 UUID。
  • 你将失去: 所有玩家的正版自动登录功能均被禁用;第一个注册某个昵称的玩家即拥有该昵称。
  • 最适合: 私有网络、开发环境或纯离线模式设置。

配置 3 — 宽松混合模式

premium:
  check-enabled: true
  allow-cracked-on-premium-nicks: true

  • 你获得什么: 现有的正版账户保留正版 UUID;破解玩家可注册未被占用的、外观类似正版的用户名。
  • 你失去什么: 首次连接的新正版玩家,若未预先注册为正版账户,将永久获得离线 UUID。
  • 适用场景: 优先接纳所有玩家且无踢出提示界面的“仅破解”社区。
目标 推荐配置
最高安全性,保留正版 UUID 1 — 混合严格模式
不调用 Mojang 服务,纯离线网络 2 — 仅破解模式
接受所有连接,不预留昵称 3 — 宽松混合模式

要求

  • Java 21 或更高版本(已在 Temurin 21 上测试)
  • Velocity Proxy(3.4.0+ / 3.5.x 系列)
  • 数据库:MySQL、PostgreSQL、H2(默认)或 SQLite
  • 认证服务器拓扑:
  • 外部(默认):NanoLimbo、LOOHP/Limbo、LimboService、PicoLimbo 或类似软件。
  • 内置(可选):内置 1.8 回环 Limbo(需要出站 HTTPS 访问 ViaVersion maven 仓库以进行运行时暂存)。

快速设置

1. 安装

  1. 从 Modrinth 下载最新的 veloauth-X.X.X.jar。
  2. 将其放入 Velocity 的 plugins/ 文件夹中。
  3. 启动并停止 Velocity,以在 plugins/veloauth/ 中生成配置文件。
  4. 在 plugins/veloauth/config.yml 中配置数据库详情和认证设置。
  5. 启动 Velocity。

2. Velocity 配置 (velocity.toml)

[servers]
limbo = "127.0.0.1:25566"   # 外部 Limbo 服务器(不要包含在尝试列表中!)
lobby = "127.0.0.1:25565"   # 主要后端大厅
survival = "127.0.0.1:25567" # 次要后端服务器

try = ["lobby", "survival"]   # 已认证玩家的后备后端顺序

[forced-hosts]
# 通过 survival.example.com 加入的玩家将在 Limbo 中进行认证,
# 然后直接路由到 'survival' 而不是 'lobby'。
"survival.example.com" = ["survival"]

3. VeloAuth 配置 (plugins/veloauth/config.yml)

language: en

auth-server:
  # 'external'(默认)使用注册的 Limbo 服务器;'embedded' 启动回环 Limbo。
  mode: external
  server-name: limbo
  timeout-seconds: 300
  embedded:
    port: 0 # 0 = 自动选择回环端口
    max-connections: 512
    handshake-timeout-seconds: 10
    login-timeout-seconds: 15

premium:
  check-enabled: true
  allow-cracked-on-premium-nicks: false
  # 仅当已验证的正版玩家应完全跳过认证服务器时,才设置为 true
  bypass-auth-server: false

# 可选的 Floodgate 集成
floodgate:
  enabled: false
  username-prefix: "."
  bypass-auth-server: true

密码复杂度策略(可选)

security:
  min-password-length: 8
  max-password-length: 72
  password-policy:
    min-digits: 0       # 例如,1 = 要求至少包含一个数字
    min-uppercase: 0    # 例如,1 = 要求至少包含一个大写字母
    min-lowercase: 0    # 例如,1 = 要求至少包含一个小写字母
    min-special: 0      # 例如,1 = 要求至少包含一个符号


命令与权限

玩家命令

命令 描述 备注
/register <password> <confirm> 注册新账户 登录后隐藏
/login <password> 登录你的账户 在认证/Limbo 状态下可用
/logout 使会话失效并断开连接 正常断开;返回时需要重新 /login
/changepassword <old> <new> 更新你的账户密码 需要处于活跃会话中
/2fa setup 开始 TOTP 身份验证器设置 需要处于活跃会话中
/2fa verify <code> 确认 TOTP 设置或提交 2FA 验证码 标准 RFC 6238 TOTP
/2fa disable <code> 从账户移除 2FA 需要有效的 TOTP 代码
/2fa qr / /2fa status 显示 2FA 注册状态 重新注册说明

管理员命令 (veloauth.admin)

命令 描述
/vauth reload 重新加载配置文件和语言文件
/vauth report 上传脱敏诊断包至 mclo.gs
/vauth stats 显示运行时缓存、线程和连接统计信息
/vauth conflicts 列出当前存在的昵称所有权冲突
/vauth cache-reset [player] 清除正版解析器/认证缓存
/vauth 2fa-remove <nickname> 管理员重置 2FA 以进行恢复
/unregister <nickname> 从数据库中删除账户记录

LimboAuth 迁移

VeloAuth 支持 100% 自动化的 LimboAuth 架构迁移:

  1. 停止后端服务器上的 LimboAuth。
  2. 在你的 Velocity 代理上安装 VeloAuth。
  3. 在 plugins/veloauth/config.yml 中使用相同的数据库凭据进行配置。
  4. 启动 Velocity。现有账户和 /premium 标志将在启动时无缝转换,无需手动重写 UUID。

链接与支持

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源