本指南将引导您在 Legion Hosting 上设置 Hytale 专用服务器，包括必需的首次身份验证步骤、基本服务器配置以及玩家如何连接到您的服务器。
Hytale 处于抢先体验阶段。 服务器功能、配置选项和身份验证流程可能会随游戏更新而变化。本文反映游戏的当前状态，并将在引入新功能时更新。
前提条件
- 在 Legion Hosting 上拥有一个活跃的 Hytale 服务器
- 来自欢迎邮件的 GPanel 凭据（如未找到请检查垃圾邮件文件夹）
- 在您的 PC 上已安装 Hytale
- 来自 GPanel 的服务器 IP 地址和端口（登录 gpanel.legionhosting.net）
步骤 1 — 登录 GPanel 并启动服务器
- 打开浏览器并访问 https://gpanel.legionhosting.net。
- 输入欢迎邮件中的邮箱和密码，然后点击 Login。
- 从服务器列表中点击您的 Hytale 服务器以打开它。
- 在 Console 选项卡上，状态指示器将显示 Offline。点击 Start 按钮。
- 等待服务器下载并安装所需文件。首次启动可能需要 2 到 5 分钟来设置 Hytale 服务器文件。
- 观察控制台输出。服务器最终会暂停并显示一个身份验证提示，其中包含 URL 和设备代码。此时请勿关闭或重启服务器。
无法登录 GPanel？ 请使用登录页面上的 Forgot Password 链接。如果您未收到重置邮件，请检查垃圾邮件文件夹。如需进一步帮助，请 提交工单。
步骤 2 — 验证您的服务器身份
Hytale 在首次启动时需要进行服务器身份验证。在您完成此步骤之前，服务器将不接受玩家连接。
- 在 GPanel 控制台中，查找包含 URL 和设备代码的消息。它看起来类似于：
To authenticate, visit: https://auth.hytale.com/device Enter the code: XXXX-XXXX - 在任何设备（PC、手机、平板电脑）上用浏览器打开该验证 URL。
- 使用您的 Hytale 账户（您用来玩游戏的账户）登录。
- 在提示时输入控制台中显示的设备代码。
- 确认验证。浏览器将显示成功消息。
- 返回 GPanel 并观察控制台。几秒钟内，服务器应继续启动过程，状态将变为 Running。
验证期间请勿重启服务器。 如果在完成设备登录之前重启或停止服务器，验证代码将过期，您需要重新开始整个过程。代码仅在有限时间内有效。
身份验证是一次性步骤。 一旦您的服务器完成验证，它将记住凭据。常规重启后无需重复此过程，除非重新安装了服务器文件或验证令牌过期。
步骤 3 — 查找您的连接信息
- 在 GPanel 中，点击 Console 选项卡（或服务器概览区域）。
- 记下页面顶部附近显示的 IP 地址和端口。
- 格式为
IP:Port，例如192.0.2.10:25565。您将与想要加入服务器的人分享这些信息。
有关查找连接信息的详细说明，请参阅 如何查找您的服务器 IP 和端口。
步骤 4 — 基本服务器配置
Hytale 专用服务器通过 GPanel Startup 选项卡公开关键设置。这些变量控制最常见的服务器选项，无需手动编辑文件。
使用启动变量
- 在 GPanel 中，点击 Startup 选项卡。
- 您将看到可配置变量列表。编辑任意值并点击 Save 或按 Enter。
- 更改后，从 Console 选项卡重启服务器以使新设置生效。
常用设置
| 设置 | 功能说明 | 示例值 |
|---|---|---|
| Server Name | 在服务器浏览器中显示并向连接玩家展示的名称 | My Legion Server |
| Max Players | 允许同时在线的最大玩家数量 | 16 |
| Server Password | 要求玩家输入密码才能加入。留空则为公开服务器。 | MySecret123 |
请记住： 更改任何 Startup 变量后，您必须重启服务器才能使更改生效。使用 Console 选项卡上的 Restart 按钮。
编辑配置文件
对于 Startup 选项卡中未提供的高级设置，您可以通过 GPanel 文件管理器直接编辑服务器配置文件。
- 在 GPanel 中点击 Files 选项卡。
- 浏览到服务器根目录并查找配置文件（这些文件可能会随 Hytale 更新而变化）。
- 点击文件以在内置文本编辑器中打开它。进行更改后点击 Save Content。
- 停止并重启服务器以使更改生效。
如需批量文件传输或大文件上传，请使用 SFTP 代替浏览器文件管理器。请参阅 如何通过 SFTP 上传文件 了解操作说明。
步骤 5 — 连接到您的 Hytale 服务器
- 在您的 PC 上启动 Hytale。
- 从主菜单导航到 Multiplayer 或 Server Browser 选项。
- 选择 Direct Connect（或通过 IP 加入的等效选项）。
- 输入步骤 3 中获取的服务器
IP:Port— 例如192.0.2.10:25565。 - 如果在步骤 4 中设置了服务器密码，请在提示时输入。
- 点击 Connect。您应该在几秒钟内加载到服务器世界中。
分享您的连接信息。 将您的 IP 地址、端口和服务器密码（如果设置了）告诉您的朋友，以便他们可以按照上述相同步骤连接。
验证
连接后，确认一切正常运行：
- 您的角色应该成功加载到游戏世界中。
- 检查 GPanel Console 选项卡 — 您应该看到一条日志记录，显示您的玩家已加入服务器。
- 请一位朋友使用相同的 IP 和端口连接，以验证外部连接性。
- 服务器状态应保持为 Running，控制台输出中没有错误。
故障排除
服务器无法启动或在启动过程中卡住
- 检查控制台输出中的错误消息。首次安装时，服务器可能需要几分钟来下载所需文件。
- 如果服务器正在等待身份验证，请完成步骤 2 中描述的设备登录。
- 如果验证后错误仍然存在，请尝试从 GPanel 的 Settings 选项卡重新安装服务器（这将删除服务器数据 — 请先备份重要文件）。
验证代码过期或失败
- 设备代码仅在有限时间内有效。如果过期，请重启服务器以生成新代码。
- 确保您使用的是拥有该游戏的有效 Hytale 账户登录。
- 如果验证页面无法加载，请尝试使用其他浏览器或清除浏览器缓存。
无法连接到服务器
- 确认 GPanel 中服务器状态显示为 Running。如果显示 Offline 或 Starting，请等待其完全启动。
- 仔细检查 IP 地址和端口 — 确保在冒号后包含端口号。
- 在尝试连接之前，确保服务器已成功完成身份验证步骤。
- 如果服务器刚刚启动，请等待 1-2 分钟让其完全初始化后再尝试连接。
- 请参阅 如何查找您的服务器 IP 和端口 以获取查找正确连接信息的帮助。
设置更改未生效
- 启动变量更改需要完全重启服务器。保存后使用 Console 选项卡上的 Restart 按钮。
- 如果直接编辑配置文件，请确保在保存更改前服务器已停止。某些游戏在关闭时会覆盖配置文件，这可能会撤销您的编辑。
服务器崩溃或意外离线
- 检查服务器离线前控制台输出中的错误消息或崩溃日志。
- Hytale 处于抢先体验阶段 — 崩溃可能由游戏 bug 导致。请尝试重启服务器。
- 如果反复崩溃，请复制错误消息并 提交工单，以便我们的团队进行调查。
需要帮助？
如果您遇到上述未涵盖的问题，请 提交工单 并附上：
- 您在 GPanel 中的服务器名称
- 问题描述及开始时间
- GPanel 控制台中的任何错误消息（复制并粘贴相关行）
