
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
- 会话
- 密码
- 数据库存储
- 认证状态
后端插件仅监听该状态,并在玩家登录前保护服务器。
工作原理
- 玩家通过代理加入。
- 玩家登录、注册或验证双重验证(2FA)。
- 玩家连接到后端服务器。
- Auth Backend 向代理询问玩家的登录状态。
- 代理回复当前的认证状态。
- 后端根据该状态允许或阻止游戏玩法。
后端与代理之间的通信使用:
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+ 后端系列 |
安装
- 将
Auth-Proxy-<version>.jar 安装到你的 Velocity 或 BungeeCord 代理上。
- 在每个后端服务器上安装匹配的
Auth-Backend-<version>.jar。
- 启动代理和后端服务器一次。
- 配置代理插件。
- 重启代理和后端服务器。
- 通过代理加入并进行身份验证。
注册:
/register <password> <password>
登录:
/login <password>
重要提示
- 后端服务器不需要数据库设置。
- 后端 jar 文件不能替代代理 jar 文件。
- 代理 jar 文件不能替代后端 jar 文件。
- 在所有需要保护的后端服务器上安装 Auth Backend。
- 使用与你的服务器软件匹配的后端 jar 文件。
- 认证逻辑由代理处理,而非后端。
支持
如果出现问题,请包含以下内容:
- 代理类型和版本
- 后端服务器类型和版本
- Auth 代理 jar 文件名
- Auth 后端 jar 文件名
- 控制台错误日志
- 后端配置文件

Auth Backend
Auth Backend is the lightweight backend protection layer for ZCraft Auth.
It runs on Spigot, Paper, Purpur, and Folia backend servers, keeping players restricted until the proxy confirms they are logged in.
The proxy handles accounts, passwords, sessions, 2FA, and database storage.
The backend plugin only protects gameplay until authentication is complete.
Summary
Lightweight backend protection for ZCraft Auth. Runs on Spigot, Paper, Purpur, and Folia servers, blocking gameplay until the proxy confirms the player is logged in. No backend database setup required.
Features
| Feature |
Status |
| Spigot backend support |
Yes |
| Paper backend support |
Yes |
| Purpur backend support |
Yes |
| Folia backend support |
Yes |
| Proxy auth-state sync |
Yes |
| Movement protection |
Yes |
| Chat protection |
Yes |
| Command protection |
Yes |
| Inventory click protection |
Yes |
| Item drop protection |
Yes |
| Item pickup protection |
Yes |
| Damage protection |
Yes |
| Attack protection |
Yes |
| Backend database setup |
Not required |
| Backend password hashing |
Not used |
| bStats support |
Yes |
What This Plugin Is
Auth Backend is made for Minecraft networks using Auth Proxy on Velocity or BungeeCord.
When a player joins a backend server, Auth Backend checks with the proxy to see if that player is authenticated.
If the player is logged in, they can play normally.
If not, the backend keeps them locked down until login, registration, or 2FA verification is complete.
This keeps backend servers protected without requiring every server to connect to your database.
Downloads
Install the backend jar that matches your server type.
| Jar |
Install on |
Auth-Backend-SpigotLegacy-<version>.jar |
Spigot-style 1.16-1.19 backends |
Auth-Backend-Spigot-<version>.jar |
Spigot-style 1.20-1.21 backends |
Auth-Backend-Paper-<version>.jar |
Paper/Purpur 1.21+ backends |
Auth-Backend-Folia-<version>.jar |
Folia 1.21+ backends |
Do not install backend jars on the proxy.
Do not install the proxy jar on backend servers.
Required Proxy Plugin
Auth Backend is not a standalone login plugin.
You must also install the proxy jar:
Auth-Proxy-<version>.jar
on your Velocity or BungeeCord proxy.
The proxy plugin handles:
/login
/register
/logout
/changepass
/2fa
- sessions
- passwords
- database storage
- authentication state
The backend plugin only listens for that state and protects the server until the player is logged in.
How It Works
- A player joins through the proxy.
- The player logs in, registers, or verifies 2FA.
- The player connects to a backend server.
- Auth Backend asks the proxy for the player's login state.
- The proxy replies with the current auth state.
- The backend allows or blocks gameplay based on that state.
Backend and proxy communication uses:
zcraftauth:state
No backend database credentials, ports, tokens, or separate linking setup are required.
Backend Protection
Auth Backend can block unauthenticated players from:
- moving
- chatting
- running blocked commands
- clicking inventory items
- dropping items
- picking up items
- taking damage
- attacking entities
You can still allow authentication-related commands before login.
Default backend config:
block-movement: true
allow-chat: false
enable-bypass-permission: false
allowed-commands:
- "/login"
- "/register"
- "/l"
- "/reg"
- "/2fa"
- "/totp"
- "/authenticator"
Operators are not bypassed by default.
To allow bypassing, you must enable it manually and give the player:
zcraftauth.backend.bypass
Performance
Auth Backend is intentionally small and low-impact.
It does not:
- connect to a database
- hash passwords
- perform account lookups
- manage sessions
- run the full authentication system
It only listens for protection events and proxy authentication state.
This keeps backend TPS/MSPT impact minimal while still preventing unauthenticated players from interacting with the server.
Requirements
| Component |
Supported |
| Java |
21+ |
| Proxy |
Velocity or BungeeCord with Auth Proxy |
| Backend |
Spigot-style, Paper, Purpur, Folia |
| Minecraft |
1.16-1.19, 1.20-1.21, and 1.21+ backend families |
Installation
- Install
Auth-Proxy-<version>.jar on your Velocity or BungeeCord proxy.
- Install the matching
Auth-Backend-<version>.jar on each backend server.
- Start the proxy and backend servers once.
- Configure the proxy plugin.
- Restart the proxy and backend servers.
- Join through the proxy and authenticate.
Register:
/register <password> <password>
Login:
/login <password>
Important Notes
- Backend servers do not need database settings.
- Backend jars do not replace the proxy jar.
- The proxy jar does not replace backend jars.
- Install Auth Backend on every backend server that should be protected.
- Use the backend jar that matches your server software.
- Authentication logic is handled by the proxy, not the backend.
Support
If something does not work, include:
- Proxy type and version
- Backend server type and version
- Auth proxy jar name
- Auth backend jar name
- Console error logs
- Backend config
评论 0
登录后参与评分
还没有评论,来抢沙发吧