快速上手

如果你现在的目标是：先把 HyperZoneLogin 跑起来，再逐步细化配置，请先按本章完成一套最小可用部署。

本文档展示了一个完整示例思路：Velocity 代理 + Outpre等待后端 + 真实游戏后端。这也是当前更稳妥、排障成本更低的入门方式。

前置条件

开始前请先确认：

你已经准备好一台 Velocity 代理；
你至少准备了两个后端服：一个等待后端、一个正式游戏后端；
你至少准备好了一个正式游戏后端；
你打算让玩家通过代理地址进入，而不是直连后端；
你已经看过 服务器基础配置，或者熟悉 Velocity 的modern转发配置方法。
- 尤其是 modern forwarding、forwarding.secret、后端 online-mode 这些基础项，本章不会重复展开配置片段。如果这里还没有配置好，请先回到 服务器基础配置。

安装方式

下载 HyperZoneLogin 的发行 jar；
把 jar 放进 Velocity 的 plugins/目录中；
在velocity.toml中正确配置正式游戏后端服的ID和IP地址（等待后端服无需配置）；
启动一次 Velocity，让插件生成初始配置文件；
按照下方说明修改 start.conf 配置：

# 配置注释语言，影响其他配置文件首次生成时的注释语言。使用中文请设置为"zh_cn"。
language="zh_cn"
# 配置文件格式，影响其他配置文件的序列化方式。建议保持hocon不变。
format=hocon
# 确认上述配置完成之后，将本字段改为true。
ready=true

再次重启Velocity，让插件生成完整配置。
按照下方说明修改 core.conf 配置：

v-server {
    # 认证完成后默认进入的服务器。将其改为你在velocity.toml中设置的游戏后端服ID。
    post-auth-default-server=play
    ...
    outpre {
        ...
        # 认证服的直连 Host。将其设置为等待后端的地址。
        auth-host="127.0.0.1"
        # 认证服的直连 Port。将其设置为等待后端的端口。
        auth-port=30066
        ...
    }
}

最后再次重启Velocity，并确保游戏后端服也已经运行。

检验方式

当你完成上述所有配置后，即可通过代理地址加入服务器检验链路是否正常。

如果链路正常，应该会观察到以下现象：

玩家先进入Outpre等待区；
在Outpre等待区里看到的玩家名表现为 HZLxxxxxx（xxxxxx 为一串随机数字）；
认证完成并进入正式游戏后端后，玩家名恢复为正常玩家名称。

如果没有出现上述现象，优先回查以下内容：

服务器基础配置：确认 modern forwarding 与后端代理设置；
velocity.toml：确认后端服务器名与 try 顺序；
core.conf：确认正式游戏后端名称填写正确。

继续阅读

当你已经完成本文内容后，建议继续按下面顺序阅读：

模块介绍：确定你到底需要哪些模块；
基础安装：了解更完整的安装与首次启动检查项；
配置索引：调整配置，以接入自己的皮肤站、自定义 Entry、调整数据库或离线识别策略等。