概要

HyperZoneLogin 是一个面向 Minecraft 代理服场景的多登录方式框架，用于统一管理不同来源的玩家身份验证、档案（Profile）与相关扩展能力，旨在实现多种登入方式的框架。

兼容范围

目前 HyperZoneLogin 的兼容情况如下：

• 客户端版本：完全支持1.19.1及以上版本，1.19及以下版本只能使用域名作为识别方式；
• Velocity版本：3.5.0-SNAPSHOT-584及以上；
• 启动器支持：支持市面常见启动器；
• 可导入数据来源：AuthMe、MultiLogin。

适用场景

作为服主或服务器管理员，如果你有以下需求：

1. 具有同时接受正版玩家、Yggdrasil 外置登录玩家和离线玩家的需求；
2. 希望在 Velocity 代理层统一处理登录逻辑，而不是在后端服拼接多套插件；
3. 希望让玩家在正版、第三方皮肤站、离线账号等不同接入方式之间获得更一致的登录体验；
4. 正在从 Authme 或 Multilogin 迁移到新架构；
5. 希望后续继续接入自定义验证逻辑、Web 管理或更多扩展功能……

那么HyperZoneLogin正适合你。本插件关注的不是“只支持一种登录方式”，而是“把多种验证入口整合到同一套档案模型中”，让登录、迁移、皮肤处理与后续扩展都能围绕同一个核心运行。

你应该如何阅读本手册

建议按以下顺序阅读：

1. 如果你想先把环境快速跑通，先看 快速上手；
2. 再看 服务器基础配置，确认代理服基础环境正确；
3. 然后阅读 模块介绍，决定你需要启用哪些模块；
4. 接着查看 基础安装，完成更完整的最小部署；
5. 需要继续微调时，再参考 配置索引；
6. 遇到问题时，可查阅 常见问题 并按 问题反馈 整理反馈材料。

如果你当前还没有完成 Velocity 与后端服的基础转发配置，请不要急着安装本项目。对代理服登录框架来说，基础网络与转发配置是前置条件，不是可选项。