模块介绍
HyperZoneLogin 由核心模块与多个子模块组成,打包在同一个jar文件中,由core.conf中的modules部分控制是否激活。并不是所有模块都激活,正确做法是根据你的登录方案与迁移需求选择组合。
| 模块 | 配置文件字段 | 作用 | 所需场景 |
|---|---|---|---|
| Velocity | - | 主插件 / 核心运行时,负责 Profile、数据库、命令与模块注册 | - |
| Yggdrasil验证 | auth-yggd | 提供 Mojang / 第三方 Yggdrasil 在线验证能力 | 正版登录/外置登录 |
| 离线登陆验证 | auth-offline | 提供本地 / 离线账号注册、登录、绑定、改密等能力 | 离线登录 |
| Floodgate登陆验证 | auth-floodgate | 提供利用 Floodgate 认证基岩版玩家的能力 | 基岩版玩家登录 |
| 数据迁移 | data-merge | 从 AuthMe 或 MultiLogin 迁移数据 | 只在迁移时需要 |
| 皮肤恢复 | profile-skin | 在认证链路中提取、修复、缓存并应用皮肤属性 | 有皮肤需求 |
| 安全防护 | safe | 简易的反假人功能 | 无其他反假人插件时 |
| API | - | 面向开发者的 API 项目 | - |
1. 正版登录+外置登录
Section titled “1. 正版登录+外置登录”如果你希望只允许 Mojang 正版和第三方外置登录玩家进入,不提供离线本地账号注册,且希望围绕 Yggdrasil 档案做统一管理:
请激活auth-yggd模块 ,无需激活auth-offline模块。如果需要缓存玩家皮肤,亦可激活profile-skin模块。
对应的配置文件样例如下:
modules { auth-floodgate=false auth-offline=false auth-yggd=true safe=true profile-skin=true data-merge=false}2. 正版登录+外置登录+离线玩家密码登录
Section titled “2. 正版登录+外置登录+离线玩家密码登录”如果你的服务器既要接收离线玩家,又要兼容正版和第三方外置登录玩家:
请激活auth-yggd模块和auth-offline模块 。如果需要缓存玩家皮肤,亦可激活profile-skin模块。
对应的配置文件样例如下:
modules { auth-floodgate=false auth-offline=true auth-yggd=true safe=true profile-skin=true data-merge=false}3. 基岩版玩家支持
Section titled “3. 基岩版玩家支持”如果你的服务器还希望支持基岩版玩家进入,请在前文所述的基础上进一步 激活auth-floodgate模块 ,同时需要在 Velocity 服务器安装 Geyser 和 Floodgate 插件。
4. 需要从Authme或Multilogin迁移
Section titled “4. 需要从Authme或Multilogin迁移”如果你的服务器之前在使用上述插件,并希望将数据迁移到本插件,在前文所述的基础上还需要 激活data-merge模块 。具体操作参见迁移数据。
data-merge模块仅在进行数据迁移时才需要,数据正确迁移后即可禁用或移除。
简易判断规则
Section titled “简易判断规则”如果你还拿不准自己该安装或激活什么,可以按下面这个顺序判断:
- 先装核心主插件;
- 需要在线验证,就激活
auth-yggd; - 需要离线本地账号,就激活
auth-offline; - 需要支持基岩版玩家,就激活
auth-floodgate,并安装 Geyser 和 Floodgate; - 需要迁移历史数据,才暂时激活
data-merge; - 需要皮肤修复与缓存,再激活
profile-skin; - 没有额外的反假人插件,并且有反假人的需求,才激活
safe。
这样选出来的组合,通常就是最接近实际需求的最小集。