基础安装
本章目标是帮助你完成一套最小可运行的 HyperZoneLogin 部署。
HyperZoneLogin 目前主要以单文件 JAR 包分发,运作时使用内置的模块;服主也可以同时安装独立版模块。
HyperZoneLogin 需要:
- 一个真实的后端服务器作为认证等待区;
- 一个游戏后端作为认证成功后跳转的服务器;
- 将整个群组服网络配置为使用
modern转发模式。
在安装 HyperZoneLogin 之前,请务必按照前述章节的指引完成 Velocity 与游戏后端服的基础配置。
此外,你还需要阅读模块介绍页面,确认你所需要激活的模块。
- 确认所有准备工作均已完成;
- 从 Github Release 下载所需的插件文件;
- 将插件放入 Velocity 的
plugins/目录; - 重启 Velocity,让插件下载所需的依赖并生成配置文件;
- 在
start.conf中设置好语言,并设置ready=true; - 重启 Velocity;
- 按照
配置索引中的说明正确配置core.conf中的module、v-server、和database字段; - 再次重启 Velocity,让插件配置生效。
如果你激活了你所需的模块,并且正确调整了所需配置,即可尝试加入服务器。如无异常,应当观察到以下现象:
- 玩家不能直接连接后端服务器,只能从 Velocity 反代理端连接;
- 玩家先进入等待区,此时玩家名称为
HZLxxxxxx(后接随机数字); - 正版玩家、外置登录玩家或基岩版玩家应自动完成认证过程,离线玩家会被提示需要使用
/register或/login命令进行注册或登录; - 认证通过后,玩家应当自动跳转到正式游戏服务器,并恢复原有名称;
- 整个过程中 Velocity 控制台没有输出明显的错误。