Z-Auth Backend addon

插件

· 作者 ZraxGaming

Auth Backend 是 ZCraft Auth 的轻量级后端守卫。它运行在 Spigot、Paper、Purpur 和 Folia 服务器上,在代理确认玩家已登录之前保护玩家。

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

最新 1.0.0 · 1.21.11 · Spigot

一键开服(送7天)

z-auth banner

Auth Backend

Auth Backend 是 ZCraft Auth 的轻量级后端防护层。

它运行于 Spigot、Paper、Purpur 和 Folia 后端服务器上,在代理确认玩家已登录之前,限制其游戏行为。

代理负责处理账户、密码、会话、双重验证(2FA)和数据库存储。 后端插件仅在游戏认证完成前保护游戏玩法。


摘要

为 ZCraft Auth 提供的轻量级后端防护。运行于 Spigot、Paper、Purpur 和 Folia 服务器,在代理确认玩家已登录之前阻止游戏玩法。无需设置后端数据库。


功能

功能 状态
Spigot 后端支持 是
Paper 后端支持 是
Purpur 后端支持 是
Folia 后端支持 是
代理认证状态同步 是
移动保护 是
聊天保护 是
命令保护 是
物品栏点击保护 是
丢弃物品保护 是
拾取物品保护 是
受到伤害保护 是
攻击保护 是
后端数据库设置 不需要
后端密码哈希 不使用
bStats 支持 是

本插件的作用

Auth Backend 专为在 Velocity 或 BungeeCord 上使用 Auth Proxy 的 Minecraft 网络设计。

当玩家加入后端服务器时,Auth Backend 会向代理检查该玩家是否已通过身份验证。

如果玩家已登录,他们可以正常游戏。 如果没有,后端会将他们锁定,直到登录、注册或双重验证完成。

这可以在无需每台服务器都连接到你数据库的情况下,保护后端服务器。


下载

安装与你的服务器类型匹配的后端 jar 文件。

Jar 文件 安装于
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 文件。


所需的代理插件

Auth Backend 不是独立登录插件。

你还必须安装代理 jar:

Auth-Proxy-<version>.jar

在你的 Velocity 或 BungeeCord 代理上。

代理插件负责处理:

  • /login
  • /register
  • /logout
  • /changepass
  • /2fa
  • 会话
  • 密码
  • 数据库存储
  • 认证状态

后端插件仅监听该状态,并在玩家登录前保护服务器。


工作原理

  1. 玩家通过代理加入。
  2. 玩家登录、注册或验证双重验证(2FA)。
  3. 玩家连接到后端服务器。
  4. Auth Backend 向代理询问玩家的登录状态。
  5. 代理回复当前的认证状态。
  6. 后端根据该状态允许或阻止游戏玩法。

后端与代理之间的通信使用:

zcraftauth:state

无需后端数据库凭据、端口、令牌或单独的连接设置。


后端防护

Auth Backend 可以阻止未通过身份验证的玩家:

  • 移动
  • 聊天
  • 运行被阻止的命令
  • 点击物品栏中的物品
  • 丢弃物品
  • 拾取物品
  • 受到伤害
  • 攻击实体

你仍然可以在登录前允许与认证相关的命令。

默认后端配置:

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

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

操作员(Operators)默认不会被绕过限制。

若要允许绕过,你必须手动启用它并给予玩家权限:

zcraftauth.backend.bypass

性能

Auth Backend 故意保持小巧且低影响。

它不执行以下操作:

  • 连接数据库
  • 哈希密码
  • 进行账户查找
  • 管理会话
  • 运行完整的认证系统

它仅监听防护事件和代理认证状态。

这使得后端 TPS/MSPT 的影响降至最低,同时仍能防止未通过身份验证的玩家与服务器交互。


要求

组件 支持情况
Java 21+
代理 Velocity 或带有 Auth Proxy 的 BungeeCord
后端 Spigot 风格、Paper、Purpur、Folia
Minecraft 1.16-1.19、1.20-1.21 和 1.21+ 后端系列

安装

  1. 将 Auth-Proxy-<version>.jar 安装到你的 Velocity 或 BungeeCord 代理上。
  2. 在每个后端服务器上安装匹配的 Auth-Backend-<version>.jar。
  3. 启动代理和后端服务器一次。
  4. 配置代理插件。
  5. 重启代理和后端服务器。
  6. 通过代理加入并进行身份验证。

注册:

/register <password> <password>

登录:

/login <password>

重要提示

  • 后端服务器不需要数据库设置。
  • 后端 jar 文件不能替代代理 jar 文件。
  • 代理 jar 文件不能替代后端 jar 文件。
  • 在所有需要保护的后端服务器上安装 Auth Backend。
  • 使用与你的服务器软件匹配的后端 jar 文件。
  • 认证逻辑由代理处理,而非后端。

支持

如果出现问题,请包含以下内容:

  • 代理类型和版本
  • 后端服务器类型和版本
  • Auth 代理 jar 文件名
  • Auth 后端 jar 文件名
  • 控制台错误日志
  • 后端配置文件

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源