? FrozenAuth
? 插件信息
一款适用于 Paper/Folia/Purpur 服务器的安全认证插件,支持 GeyserMC/Floodgate。玩家必须注册并使用密码登录后才能移动或与世界交互。包含私人隔离平台、倒计时 Boss 栏、登录前隐藏加入消息以及通过 GUI 确认的密码重置流程。
- 名称: FrozenAuth
- 版本: 2.0.1
- 加载顺序: POSTWORLD
? 作者信息
✅ 版本 / 兼容性 / 软件支持
- API 版本: 1.20
- 构建基础: Paper API(针对 1.26.x 系列)、Java 工具链、Maven 构建
- 服务器软件: Paper, Folia, Purpur
- Folia 支持: ✅ 支持 (
folia-supported: true)
- 软依赖: Floodgate(可选 — 启用完整的 GeyserMC/基岩版支持)
- 自动代理认证检测: 如果服务器前端存在验证层(如带有 IP 转发功能的 Velocity/BungeeCord)或 FastLogin 等插件,FrozenAuth 会自动交由其处理——无需更改配置。
? 权限
| 权限 |
默认值 |
用途 |
frozenauth.register |
true |
允许玩家注册账户 |
frozenauth.login |
true |
允许玩家登录账户 |
frozenauth.changepass |
true |
允许玩家修改密码 |
frozenauth.reload |
op |
允许重载插件配置 |
⌨️ 命令
| 命令 |
用法 |
权限 |
描述 |
/register |
/register <password> <confirmPassword> |
frozenauth.register |
注册新账户 |
/login |
/login <password> |
frozenauth.login |
登录现有账户 |
/resetpassword |
/resetpassword <oldPassword> <newPassword> |
frozenauth.changepass |
更改账户密码,包含 GUI 确认/取消步骤 |
/frozenauth reload |
/frozenauth reload |
frozenauth.reload |
重载插件配置 |
所有命令均包含完整的 Tab 补全功能。
? 用途
- ?️ 要求玩家在开始游戏前输入密码,保护账户并防止冒充。
- ✅ Microsoft(正版)账户和基岩版玩家无需登录或注册——系统将自动欢迎他们进入。
- ? 将仍需认证的发送到一个隔离的、每玩家独立的私人 limbo 平台(5×5,周围由屏障方块阻挡),直到他们完成认证。
- ⏱️ 可配置的认证计时器,配有实时 Boss 栏倒计时;超时未认证的玩家将被踢出,并显示自定义标题/副标题。
- ? 可选择在玩家实际完成认证之前隐藏“玩家加入”广播——如果他们在认证前断开连接,其他人永远不会看到他们加入。
- ? 在认证期间冻结移动并施加失明效果,防止玩家在登录前窥探或穿越世界。
- ? 完全可自定义的消息、标题、Boss 栏和 GUI 文本,全程支持十六进制颜色代码 (
&#RRGGBB)。
- ? 智能的后认证传送:将首次到达的玩家以及最后位置在出生世界的玩家传送到出生点,并将其他玩家恢复到其确切的上次位置。
- ? 为基岩版玩家和 Microsoft(正版)玩家提供单独且可自定义的欢迎标题和聊天消息。
⚙️ 主要配置区域 (config.yml)
auth.* — 计时器时长、失明效果、移动冻结、加入消息隐藏
limbo.* — 用于后认证传送逻辑的出生世界
bedrock.* — 基岩版出生世界、欢迎标题和加入消息
bossbar.* — 倒计时 Boss 栏启用、标题、颜色、样式
titles.* — 认证期间显示的加入标题/副标题
messages.* — 所有面向用户的插件消息,包括认证超时踢出界面
gui.* — 密码重置确认/取消 GUI 的文本
premium.* — Microsoft(正版)账户的欢迎标题和加入消息
? 数据与配置
- 基于 YAML 的配置,支持按世界自定义出生点
- 持久化玩家数据存储(向后兼容 v1.x 的 data.yml)
- 重载命令,无需重启即可实时更新配置
? 开发者友好
- 基于 Maven 的构建系统,使用 Java 21 编译
- 使用 Lombok 减少样板代码
- 清晰、模块化的架构
- 详尽的 javadoc 和代码注释
命令
| 命令 |
描述 |
权限 |
/register <password> <confirmPassword> |
注册新账户 |
frozenauth.register |
/login <password> |
登录现有账户 |
frozenauth.login |
/resetpassword <oldPassword> <newPassword> |
更改你的密码 |
frozenauth.changepass |
/frozenauth reload |
重载插件配置 |
frozenauth.reload |
除 frozenauth.reload(仅限 OP)外,所有权限默认均为 true。
配置亮点
- 按世界自定义出生点 — 自定义玩家认证后的出生位置
- Limbo 平台自定义 — 选择外围和中心方块类型(默认:玻璃 + 附魔台)
- 认证超时时长 — 配置玩家进行认证的时限
- 加入消息屏蔽 — 在玩家认证成功前隐藏加入消息
- 渐变消息样式 — 带颜色编码的认证提示和反馈
基岩版支持
GeyserMC/Floodgate 玩家可以使用与 Java 版玩家相同的命令进行注册和登录。自动检测确保跨平台兼容性顺畅。
v2.0.0 更新内容
? 重大重构
- 全面的架构重组,以提升稳定性和性能
- 修复关键错误:新注册导致 limbo 平台插槽泄漏
- 已修复:
/register 现在尊重 limbo.spawn-world 配置(此前被忽略)
- 从已弃用的
AsyncPlayerChatEvent 迁移到现代的 AsyncChatEvent
? 性能与兼容性
- 移除了导致启动失败的硬性 LuckPerms 依赖
- 为所有异步操作实现了兼容 Folia 的调度器
- 强化了虚空区块生成器,采用显式生物群系提供程序
- 完全兼容 Paper 1.21.4–1.21.11+
? 界面改进
- 密码重置 GUI 重新设计,添加了黑色边框和渐变样式
- 认证超时踢出屏幕现在使用一致的渐变品牌风格
- 增强了等待平台(5×5 大小,中心放置附魔台)
安装
- 下载最新版本的 JAR 文件
- 放入
plugins/ 文件夹
- 重启服务器或使用
/reload 命令
- 根据需要配置
plugins/FrozenAuth/config.yml
- 重启服务器(或执行
/frozenauth reload)以使更改生效
如果从 v1.x 迁移:只需在安装后,将备份的 data.yml 放入 plugins/FrozenAuth/ 目录即可 —— 所有玩家密码均可正常加载。
权限矩阵
| 权限 |
默认值 |
效果 |
frozenauth.register |
True |
玩家可以注册账号 |
frozenauth.login |
True |
玩家可以登录账号 |
frozenauth.changepass |
True |
玩家可以重置密码 |
frozenauth.reload |
Op |
管理员可以重载配置 |
要求
- 服务端软件: Paper/Folia/Purpur 1.20+
- Java: Java 21(用于运行服务器)
- 依赖项: 无需额外依赖;Floodgate 为可选
验证层支持
如果您部署了 FastLogin 或在代理(Velocity/BungeeCord)上运行具备真实 Mojang 认证及现代玩家转发功能的服务器,FrozenAuth 会自动使用加密的高级版验证。否则,它将回退到基于用户名的标准检测模式 —— 无需任何配置,它会自动适应。
已知行为
- 高级版玩家(通过 Mojang 注册)可自动绕过注册和登录流程
- 未通过身份验证的玩家无法移动、使用物品栏、执行命令或与世界交互
- 等待世界完全隔离 —— 其他插件的功能(如 TAB 计分板等)可在其配置中按世界禁用
- 对于未通过身份验证的会话,加入/离开消息将被抑制
开发与贡献
构建所用技术:
- Paper API 1.21.11-R0.1-SNAPSHOT
- Lombok 1.18.30(用于代码整洁)
- GeyserMC Floodgate 2.2.2(可选,软依赖)
作者
FrozenAuth v2.0.0 — 为现代 Minecraft 服务器提供强大的身份验证功能。
? FrozenAuth
? Plugin Info
A secure authentication plugin for Paper/Folia/Purpur servers with GeyserMC/Floodgate support. Players are required to register and log in with a password before they can move or interact with the world. Includes a private limbo platform, countdown bossbar, join-message hiding until authenticated, and a GUI-confirmed password reset flow.
- Name: FrozenAuth
- Version: 2.0.1
- Load order: POSTWORLD
? Author Info
✅ Versions / Compatibility / Software Support
- API Version: 1.20
- Built against: Paper API (targeting the 1.26.x line), Java toolchain, Maven build
- Server software: Paper, Folia, Purpur
- Folia support: ✅ Supported (
folia-supported: true)
- Soft dependency: Floodgate (optional — enables full GeyserMC/Bedrock Edition support)
- Automatic proxy-auth detection: If a verification layer such as Velocity/BungeeCord with IP forwarding, or a plugin like FastLogin, is present in front of the server, FrozenAuth automatically defers to it — no config changes needed.
? Permissions
| Permission |
Default |
Purpose |
frozenauth.register |
true |
Allows a player to register an account |
frozenauth.login |
true |
Allows a player to log into an account |
frozenauth.changepass |
true |
Allows a player to change their password |
frozenauth.reload |
op |
Allows reloading the plugin's config |
⌨️ Commands
| Command |
Usage |
Permission |
Description |
/register |
/register <password> <confirmPassword> |
frozenauth.register |
Registers a new account |
/login |
/login <password> |
frozenauth.login |
Logs into an existing account |
/resetpassword |
/resetpassword <oldPassword> <newPassword> |
frozenauth.changepass |
Changes account password, with a GUI confirm/cancel step |
/frozenauth reload |
/frozenauth reload |
frozenauth.reload |
Reloads the plugin configuration |
Full tab completion is included for all commands.
? Uses
- ?️ Requires a password before players can play, protecting accounts and preventing impersonation.
- ✅ Microsoft (premium) accounts and Bedrock Edition players don't need to login or register — they're welcomed through automatically.
- ? Sends players who still need to authenticate to an isolated, private per-player limbo platform (5×5, barrier-blocked) until they finish.
- ⏱️ Configurable authentication timer with a live bossbar countdown; players who run out of time are kicked with a custom title/subtitle.
- ? Optionally hides the "player joined" broadcast until the player has actually authenticated — if they disconnect first, no one ever saw them join.
- ? Freezes movement and applies Blindness during the auth period so players can't peek at or wander through the world before logging in.
- ? Fully customizable messages, titles, bossbar, and GUI text, with hex color (
&#RRGGBB) support throughout.
- ? Smart post-auth teleport: sends first-time players and anyone whose last location was the spawn world to spawn, and restores everyone else to their exact last location.
- ? Separate, configurable welcome titles and chat messages for Bedrock Edition and Microsoft (premium) players.
⚙️ Key Config Areas (config.yml)
auth.* — timer length, blindness, movement freeze, join-message hiding
limbo.* — spawn world used for post-auth teleport logic
bedrock.* — Bedrock Edition spawn world, welcome title, and join message
bossbar.* — countdown bossbar enable, title, color, style
titles.* — join titles/subtitles shown during the auth period
messages.* — every user-facing plugin message, including the auth-timeout kick screen
gui.* — text for the password-reset confirm/cancel GUI
premium.* — welcome title and join message for Microsoft (premium) accounts
? Data & Configuration
- YAML-based configuration with per-world spawn customization
- Persistent player data storage (backward-compatible with v1.x data.yml)
- Reload command for live config updates without restart
? Developer-Friendly
- Maven build system with Java 21 compilation
- Lombok for reduced boilerplate
- Clean, modular architecture
- Extensive javadoc and code comments
Commands
| Command |
Description |
Permission |
/register <password> <confirmPassword> |
Register a new account |
frozenauth.register |
/login <password> |
Login to existing account |
frozenauth.login |
/resetpassword <oldPassword> <newPassword> |
Change your password |
frozenauth.changepass |
/frozenauth reload |
Reload plugin configuration |
frozenauth.reload |
All permissions default to true except frozenauth.reload (op-only).
Configuration Highlights
- Per-world spawn location — customize where players spawn after authentication
- Limbo platform customization — choose outer and center block types (default: glass + enchanting table)
- Auth timeout duration — configure how long players have to authenticate
- Join message suppression — hide join messages until players are authenticated
- Gradient message styling — color-coded authentication prompts and feedback
Bedrock Edition Support
GeyserMC/Floodgate players can register and login using the same commands as Java players. Automatic detection ensures smooth cross-platform compatibility.
What's New in v2.0.0
? Major Rework
- Complete architectural overhaul for stability and performance
- Fixed critical bug: new registrations were leaking limbo platform slots
- Fixed:
/register now respects limbo.spawn-world config (previously ignored)
- Migrated from deprecated
AsyncPlayerChatEvent to modern AsyncChatEvent
? Performance & Compatibility
- Removed hard LuckPerms dependency that was causing boot failures
- Implemented Folia-safe scheduler for all async operations
- Hardened void chunk generator with explicit biome provider
- Fully compatible with Paper 1.21.4–1.21.11+
? UI Improvements
- Password reset GUI redesigned with black border, gradient styling
- Auth-timeout kick screen now uses consistent gradient branding
- Enhanced limbo platform (5×5 with enchanting table center)
Installation
- Download the latest release JAR
- Drop into
plugins/ folder
- Restart server or use
/reload
- Configure
plugins/FrozenAuth/config.yml to your needs
- Restart (or
/frozenauth reload) for changes to take effect
If migrating from v1.x: Simply drop your backed-up data.yml into plugins/FrozenAuth/ after installing — all player passwords load normally.
Permissions Matrix
| Permission |
Default |
Effect |
frozenauth.register |
True |
Players can register accounts |
frozenauth.login |
True |
Players can login to accounts |
frozenauth.changepass |
True |
Players can reset passwords |
frozenauth.reload |
Op |
Operators can reload configuration |
Requirements
- Server Software: Paper/Folia/Purpur 1.20+
- Java: Java 21 (for running the server)
- Dependencies: None required; Floodgate is optional
Support for Verification Layers
If you deploy FastLogin or run a proxy (Velocity/BungeeCord) with real Mojang authentication + modern player forwarding, FrozenAuth automatically uses cryptographic premium verification. Otherwise, it falls back to standard username-based detection — no configuration needed, it adapts automatically.
Known Behavior
- Premium players (registered with Mojang) bypass registration and login automatically
- Unauthenticated players cannot move, use inventory, execute commands, or interact with the world
- Limbo world is completely isolated — other plugins' features (TAB scoreboard, etc.) can be disabled per-world in their configs
- Join/quit messages are suppressed for unauthenticated sessions
Development & Contributions
Built with:
- Paper API 1.21.11-R0.1-SNAPSHOT
- Lombok 1.18.30 (for clean code)
- GeyserMC Floodgate 2.2.2 (optional, soft dependency)
Author
FrozenAuth v2.0.0 — Robust authentication for the modern Minecraft server.
评论 0
登录后参与评分
还没有评论,来抢沙发吧