Z-Auth

插件

· 作者 ZraxGaming

适用于 Paper 1.21.1+ 及整个 1.21.x 系列的 Minecraft 专业身份验证插件

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

最新 1.0.0 · 1.21.11 · BungeeCord / Velocity

一键开服(送7天)

Z-auth_banner

Auth

Auth 是一个面向 Minecraft 网络的代理优先认证系统。它使用一个适用于 Velocity/BungeeCord 的代理插件,以及用于 Spigot/Paper/Purpur/Folia 服务器的轻量级后端守卫插件。

玩家通过 /login 或 /register 在代理上进行认证,而后端服务器则在代理确认玩家已登录后才受到保护。

需要安装附加组件 - 链接


功能

功能 状态
Velocity 支持 是
BungeeCord 支持 是
Spigot 后端守卫 是
Paper/Purpur 后端守卫 是
Folia 后端守卫 是
SQLite 数据库 是
MySQL / MariaDB / PostgreSQL 是
/login 和 /register 是
会话登录 是
Authenticator 双重验证 (2FA) 是
管理员 /zauth 命令 是
后端移动/聊天/命令保护 是
后端物品栏/掉落/伤害保护 是
更新时配置自动合并 是
bStats 支持 是

下载

Auth 构建多个 jar 文件。请为每种服务器类型安装正确的 jar 文件。

Jar 文件 安装位置
Auth-Proxy-<version>.jar Velocity 或 BungeeCord 代理
Auth-Backend-SpigotLegacy-<version>.jar Spigot 风格 1.16-1.19 后端服务器
Auth-Backend-Spigot-<version>.jar Spigot 风格 1.20-1.21 后端服务器
Auth-Backend-Paper-<version>.jar Paper/Purpur 1.21+ 后端服务器
Auth-Backend-Folia-<version>.jar Folia 1.21+ 后端服务器

不要将代理 jar 安装到后端服务器上。
不要将后端 jar 安装到代理上。


工作原理

  1. 玩家加入代理服务器。
  2. Auth 检查该玩家是否已注册。
  3. 玩家进行登录、注册或验证双重认证(2FA)。
  4. 代理将认证状态发送给后端服务器。
  5. 在后端服务器确认登录之前,会阻止玩家进行游戏操作。

后端与代理通过以下频道自动通信:

zcraftauth:state

无需配置后端数据库。


命令

命令 描述
/login <password> 登录你的账号
/l <password> 登录快捷命令
/register <password> <password> 注册新账号
/reg <password> <password> 注册快捷命令
/logout 登出并重新锁定后端访问
/changepass <old> <new> 修改密码
/2fa enable 生成身份验证器密钥
/2fa verify <code> 验证你的两步登录
/2fa disable <code> 禁用身份验证器两步验证

管理员命令

使用 /zauth 需要以下权限:

zcraftauth.admin
命令 描述
/zauth status 显示已认证玩家数量
/zauth unregister <player> 删除玩家的登录记录
/zauth setpassword <player> <password> 更改玩家密码
/zauth disable2fa <player> 移除玩家的 2FA(双重验证)
/zauth forcelogin <player> 将玩家标记为已登录
/zauth logout <player> 将玩家标记为已登出

数据库支持

Auth 支持以下数据库:

  • SQLite
  • MySQL
  • MariaDB
  • PostgreSQL

默认配置:

database:
  type: sqlite

  sqlite:
    file: auth.db

外部数据库示例:

database:
  type: mysql

  external:
    host: localhost
    port: 3306
    database: zcraft_auth
    username: root
    password: ""
    ssl: false

会话登录

当玩家的 IP 地址与上次已知登录 IP 匹配时,Auth 可以恢复玩家的会话。

session:
  enabled: true

这有助于在保护后端服务器免受攻击的同时,避免不必要的重新登录。


超时设置

登录和注册的超时时间是分开的。

general:
  login-timeout: 0
  register-timeout: 0

将任一值设置为 0 即可禁用该超时功能。


后端保护

后端插件故意设计得小巧且影响极小。它不连接数据库,也不运行重复任务。

它可以阻止以下行为:

  • 移动
  • 聊天
  • 命令
  • 物品栏点击
  • 物品掉落
  • 拾取物品
  • 受到伤害
  • 攻击他人

后端配置:

block-movement: true
allow-chat: false
enable-bypass-permission: false

allowed-commands:
  - "/login"
  - "/register"
  - "/l"
  - "/reg"
  - "/2fa"
  - "/totp"
  - "/authenticator"

操作员(Operators)默认不会被豁免。


2FA 身份验证器

玩家可以启用基于身份验证器的 2FA:

/2fa enable

在后续登录时,输入正确密码后,他们必须验证:

/2fa verify <code>

兼容常见的身份验证器应用,如 Google Authenticator、Authy、2FAS 以及类似的 TOTP 应用。


性能

Auth 旨在保持对后端服务器的轻量级影响:

  • 后端插件没有数据库连接。
  • 后端插件不对密码进行哈希处理。
  • 后端插件不执行账户查找。
  • 后端插件仅监听保护事件和代理状态。
  • 代理端的数据库操作是异步运行的。
  • 提示条由事件驱动。

这使得后端 TPS/MSPT 的影响降至最低。


尚未移植的功能

较旧的仅 Paper 代码库包含更多计划中或遗留的系统。这些功能尚未完全移植到当前的以代理为主的系统中:

  • 电子邮件恢复与确认
  • 国家白名单/黑名单
  • 内置代理 AntiBot
  • Mojang 正版验证绕过
  • 自定义外部表/列映射
  • 旧版哈希导入/迁移格式
  • 可编辑的多语言消息包
  • 自动数据库备份
  • 账户导入工具

这些是未来计划在代理端实现的候选功能。

要求

组件 支持情况
Java 21+
代理服务器 Velocity、BungeeCord
后端 Spigot 风格、Paper、Purpur、Folia
Minecraft 适用于 1.16–1.19、1.20–1.21 和 1.21+ 系列的后端变体

安装

  1. 将 Auth-Proxy-<version>.jar 安装到你的代理服务器上。
  2. 在每个后端服务器上安装对应的 Auth-Backend-<version>.jar。
  3. 启动一次代理以生成配置文件。
  4. 如有需要,编辑代理的配置文件。
  5. 重启代理和后端服务器。
  6. 加入服务器并使用以下命令注册:
/register <密码> <密码>

支持

如果出现问题,请提供以下信息:

  • 代理类型和版本
  • 后端服务器类型和版本
  • 认证代理 JAR 文件名
  • 认证后端 JAR 文件名
  • 控制台错误日志
  • 配置数据库类型

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源