本指南介绍如何在 Legion Hosting 上设置 Portal Knights 专用服务器、配置启动变量、调整服务器设置、与好友连接以及管理世界存档。有关管理员控制和玩家管理，请参阅 Portal Knights 管理员命令。

1. 首次启动

1. 登录 GPanel 并选择您的 Portal Knights 服务器。
2. 转到 Startup 选项卡并查看可用变量（请参阅下表）。
3. 设置一个 SERVER_NAME 以便您在浏览器中识别您的服务器。
4. 更改 ADMIN_PASS 的默认值。可选择设置 USER_PASS 或 GUEST_PASS 以限制对您小组的访问。
5. 返回 Console 选项卡并点击 Start。
6. 等待控制台显示服务器已完成加载。首次启动将生成默认配置文件和一个新世界。

2. GPanel 启动变量

以下变量可在 GPanel Startup 选项卡中使用。这些值在每次服务器启动时应用。

3. 服务器配置

除了启动变量外，Portal Knights 还允许通过其服务器配置文件进行微调。在进行更改之前请停止服务器。

配置文件位置

dedicated_server/server_config.json

使用 GPanel 中的 Files 选项卡或通过 SFTP 连接打开此文件。如果文件不存在，请启动并停止服务器一次以生成默认值。

关键设置

配置文件使用 JSON 格式。关键属性包括：

配置示例

{
  "basicServerData": {
    "name": "My Portal Knights Server",
    "ipv4": "0.0.0.0",
    "port": 27015,
    "saveFolderPath": "./savedata"
  },
  "admins": {
    "credentials": {
      "password": "my_admin_password"
    }
  },
  "users": {
    "credentials": {
      "password": ""
    }
  },
  "guests": {
    "credentials": {
      "password": ""
    }
  },
  "gameplayMode": "Adventure",
  "universeSize": "Normal",
  "hideConsoleWindow": true
}

4. 世界设置

Portal Knights 世界由通过传送门连接的程序生成岛屿组成。与世界相关的关键注意事项：

• 存档文件夹： 世界数据存储在 savedata 目录中（通过配置中的 basicServerData.saveFolderPath 配置）。
• 游戏模式： 通过 GAMEMODE 启动变量设置。Adventure 是标准 RPG 体验；Creative 允许自由建造和探索。
• 宇宙大小： 通过 UNIVERSE_SIZE 启动变量设置。控制岛屿数量：Small、Normal 或 Large。
• 岛屿进度： 玩家通过收集传送门碎片和激活传送门在岛屿间推进。服务器会跟踪所有已发现的岛屿及其状态。

5. 如何连接

选项 A -- 游戏内服务器浏览器

1. 通过 Steam 启动 Portal Knights。
2. 从主菜单选择 Multiplayer。
3. 选择 Online Game，然后选择 Browse Servers。
4. 按名称搜索您的服务器或浏览列表。
5. 选择您的服务器并点击 Join。如果提示则输入密码。

选项 B -- 通过 IP 直接连接

1. 通过 Steam 启动 Portal Knights。
2. 从主菜单选择 Multiplayer。
3. 选择 Online Game，然后选择 Direct Connect。
4. 输入来自 GPanel Network 选项卡的服务器 IP 和端口：

   <your-server-ip>:<port>

5. 如果设置了服务器密码，请输入密码。

6. 存档管理

存档文件位置

世界存档存储在服务器上的以下位置：

dedicated_server/savedata/

此路径通过 server_config.json 中的 basicServerData.saveFolderPath 设置配置。

通过 SFTP 手动备份

1. 从 GPanel 停止服务器以确保所有数据已写入磁盘。
2. 通过 SFTP 连接到您的服务器。有关说明，请参阅 如何通过 SFTP 上传文件。
3. 导航到 dedicated_server/savedata/ 目录。
4. 下载您要备份的整个世界文件夹。

恢复存档

1. 从 GPanel 停止服务器。
2. 通过 SFTP 连接并导航到 dedicated_server/savedata/。
3. 上传您备份的世界文件夹，如需要可替换现有文件夹。
4. 确保文件夹名称与您配置中的 world_name 设置匹配。
5. 从 GPanel 启动服务器。

故障排除

• 服务器未出现在浏览器中： 确认服务器已在 GPanel 中完全启动。服务器浏览器可能需要 2-3 分钟来索引新服务器。在此期间请尝试通过 IP 直接连接。
• 无法连接： 在 GPanel Network 选项卡中验证您的服务器 IP 和端口。确保服务器正在运行且未处于崩溃状态。
• 启动时崩溃： 删除配置文件并重启以重新生成默认值。如果问题持续存在，请检查 GPanel 控制台的错误消息。
• 世界无法加载： 确保 server_config.json 中的 basicServerData.saveFolderPath 设置指向正确的目录。

相关文章

• Portal Knights 管理员命令
• 如何查找您的服务器 IP 和端口
• 如何通过 SFTP 上传文件
• 服务器启动指南

需要帮助？

如果您遇到本文未涵盖的问题，请提交支持工单，并提供您的服务器 IP、问题描述以及 GPanel 控制台中的任何错误消息。