Skip to content

模块介绍

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 项目-

如果你希望只允许 Mojang 正版和第三方外置登录玩家进入,不提供离线本地账号注册,且希望围绕 Yggdrasil 档案做统一管理:

激活auth-yggd模块 ,无需激活auth-offline模块。如果需要缓存玩家皮肤,亦可激活profile-skin模块。

对应的配置文件样例如下:

core.conf
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模块。

对应的配置文件样例如下:

core.conf
modules {
auth-floodgate=false
auth-offline=true
auth-yggd=true
safe=true
profile-skin=true
data-merge=false
}

如果你的服务器还希望支持基岩版玩家进入,请在前文所述的基础上进一步 激活auth-floodgate模块 ,同时需要在 Velocity 服务器安装 Geyser 和 Floodgate 插件。

如果你的服务器之前在使用上述插件,并希望将数据迁移到本插件,在前文所述的基础上还需要 激活data-merge模块 。具体操作参见迁移数据

data-merge模块仅在进行数据迁移时才需要,数据正确迁移后即可禁用或移除。

如果你还拿不准自己该安装或激活什么,可以按下面这个顺序判断:

  1. 先装核心主插件
  2. 需要在线验证,就激活 auth-yggd
  3. 需要离线本地账号,就激活 auth-offline
  4. 需要支持基岩版玩家,就激活 auth-floodgate,并安装 Geyser 和 Floodgate;
  5. 需要迁移历史数据,才暂时激活 data-merge
  6. 需要皮肤修复与缓存,再激活 profile-skin
  7. 没有额外的反假人插件,并且有反假人的需求,才激活 safe

这样选出来的组合,通常就是最接近实际需求的最小集。