本指南介绍如何为您在 Legion Hosting 上托管的 ARK: Survival Ascended 服务器配置 GameUserSettings.ini 和 Game.ini 文件。
编辑配置文件前请停止服务器。 在编辑任何
.ini 文件之前，请务必从 GPanel Console 选项卡停止服务器。ARK 在关闭时可能会覆盖文件，因此在服务器运行时进行的更改可能会丢失。
配置文件概述
ARK: Survival Ascended 使用两个主要配置文件来控制服务器行为。两者都位于服务器上的 ShooterGame/Saved/Config/WindowsServer/ 目录中。
| 文件 | 用途 |
|---|---|
GameUserSettings.ini |
核心服务器设置 — 会话名称、密码、玩家数量、倍率、跨平台、BattleEye 等。此文件在首次服务器启动时创建。 |
Game.ini |
高级游戏覆盖 — 印痕点数、属性缩放、物品堆叠大小、自定义 NPC 刷新。文件名必须精确为 Game.ini（区分大小写）。如果不存在则需手动创建。 |
Game.ini 默认可能不存在。 如果文件不存在，请在 GPanel 文件编辑器中手动创建。文件名必须精确为
Game.ini，G 和 I 大写 — game.ini 或 GAME.INI 将不起作用。
步骤 1 — 在 GPanel 中访问文件管理器
- 登录 GPanel。
- 从服务器列表中选择您的 ARK: Survival Ascended 服务器。
- 如果服务器正在运行，请在 Console 选项卡上点击 Stop，并等待状态变为 Offline。
- 点击 Files 选项卡打开文件管理器。
- 导航至
ShooterGame/Saved/Config/WindowsServer/。服务器至少启动过一次后，您将在此处找到GameUserSettings.ini。如果Game.ini不存在，您将在步骤 3 中手动创建它。
步骤 2 — 配置 GameUserSettings.ini
在文件管理器中点击 GameUserSettings.ini 以在内联编辑器中打开。该文件分为多个部分 — 服务器配置中最重要的是 [SessionSettings] 和 [ServerSettings]。
[SessionSettings] 中的关键设置
| 设置 | 示例值 | 说明 |
|---|---|---|
SessionName |
My Legion Server |
在游戏内服务器浏览器中显示的名称。请保持唯一，以便玩家轻松找到。 |
QueryPort |
7778 |
服务器浏览器使用的查询端口。必须与 GPanel 中分配的端口匹配。默认为游戏端口 + 1。 |
[ServerSettings] 中的关键设置
| 设置 | 示例值 | 说明 |
|---|---|---|
ServerPassword |
mypassword |
玩家加入时需要的密码。留空则为公共服务器。 |
ServerAdminPassword |
adminpass123 |
用于验证游戏内管理员命令的管理员密码。请保密。 |
MaxPlayers |
20 |
同时在线的最大玩家数量。应与您套餐的玩家槽位限制匹配。 |
XPMultiplier |
2.0 |
经验值获取倍率。1.0 为默认值，2.0 为双倍经验。 |
TamingSpeedMultiplier |
3.0 |
驯服速度倍率。数值越高驯服越快。 |
HarvestAmountMultiplier |
2.0 |
每次采集动作获得的资源倍率。 |
DifficultyOffset |
1.0 |
控制生物等级分布。设置为 1.0 可获得官方风格设置的最大野生等级。 |
OverrideOfficialDifficulty |
5.0 |
当 DifficultyOffset=1.0 时，设置野生恐龙的最大等级。值为 5.0 允许最高 150 级。 |
AllowCrateSpawnsOnTopOfStructures |
True |
允许补给箱降落在玩家建筑上。推荐用于 PvE 服务器。 |
EnablePvPGamma |
True |
允许玩家在 PvP 中调整伽马值。禁用以获得更具竞争性的体验。 |
一个最小化的已配置 GameUserSettings.ini 部分示例：
[SessionSettings]
SessionName=My Legion Server
QueryPort=7778
[ServerSettings]
ServerPassword=
ServerAdminPassword=adminpass123
MaxPlayers=20
XPMultiplier=2.0
TamingSpeedMultiplier=3.0
HarvestAmountMultiplier=2.0
DifficultyOffset=1.0
OverrideOfficialDifficulty=5.0步骤 3 — 创建和配置 Game.ini
创建 Game.ini
如果 Game.ini 尚不存在，必须由用户手动创建。在 GPanel 文件管理器中导航至 ShooterGame/Saved/Config/WindowsServer/。如果 Game.ini 未列出，请创建一个文件名精确为 Game.ini 的新文件（G 和 I 大写 — game.ini 或 GAME.INI 将不起作用）。
文件开头添加以下标题 — 所有 Game.ini 设置都放在此单一部分下：
[/script/shootergame.shootergamemode]编辑 Game.ini
Game.ini 使用基于部分的格式。服务器自定义最常用的部分是 [/script/shootergame.shootergamemode]。设置在相应部分内每行一个。
常见的 Game.ini 自定义：
[/script/shootergame.shootergamemode]
; Engram points per level (one entry per level, starting at level 1)
OverridePlayerLevelEngramPoints=8
OverridePlayerLevelEngramPoints=8
OverridePlayerLevelEngramPoints=8
; Increase max XP required per level (one entry per level)
LevelExperienceRampOverrides=(...)
; Custom harvest amounts per resource
ResourceItemReplacementClasses=(...)
; Disable specific engrams
EngramEntryAutoUnlocks=(EngramClassName="EngramEntry_TurretGun_Rocket_C",LevelToAutoUnlock=0)| 设置 | 说明 |
|---|---|
OverridePlayerLevelEngramPoints=N |
设置每个等级奖励的印痕点数。每个玩家等级添加一行。使用此设置可在每次升级时授予更多印痕。 |
MaxCustomNodes=N |
控制最大自定义刷新节点数。与高级 mod 刷新配置相关。 |
EngramEntryAutoUnlocks=(...) |
强制特定印痕在指定等级自动解锁，适用于让所有玩家无需花费点数即可获得某些物品。 |
ConfigOverrideItemMaxQuantity=(...) |
覆盖特定物品的最大堆叠大小。 |
提示：
[/script/shootergame.shootergamemode] 部分标题在 Game.ini 中必须且仅出现一次。如果添加了第二次，只有最后一个会被使用。请将所有设置添加在单一标题下。
查询端口配置
查询端口与游戏端口分开，专门用于服务器浏览器（Steam/Epic）列出您的服务器。如果查询端口错误或不可达，即使服务器运行正常，您的服务器也不会出现在浏览器中。
| 端口 | 默认值 | 配置位置 | 用途 |
|---|---|---|---|
| 游戏端口 | 7777 |
GPanel Startup / Network 选项卡 | 玩家通过此端口连接加入服务器 |
| 查询端口 | 7778 |
GameUserSettings.ini — [SessionSettings] 下的 QueryPort |
服务器浏览器轮询 — 必须与 GPanel 中分配的端口匹配 |
查询端口必须与 GPanel 匹配。
GameUserSettings.ini 中的 QueryPort 值必须与 GPanel Network 选项卡中显示的查询端口完全匹配。Legion Hosting 在创建服务器时会预先分配两个端口 — 请在编辑 .ini 文件之前查看 Network 选项卡中您的具体值。不要假设默认值 7777/7778 适用于您的服务器。
应用更改
- 使用 GPanel 文件编辑器中的 Save 按钮保存已编辑的
.ini文件。 - 返回 Console 选项卡。
- 点击 Start 启动服务器。GPanel 将在启动时加载您更新的配置。
- 监控控制台输出是否有错误。配置错误（如无效值或重复的部分标题）通常会在启动日志中产生警告。
始终在服务器停止时编辑配置文件。 在服务器停止时编辑
GameUserSettings.ini 或 Game.ini，然后启动服务器即可。不要尝试在服务器运行时热重载配置文件 — ARK 的大多数设置不支持实时配置重新加载。
故障排除
Game.ini 不存在或设置未被读取
Game.ini不会自动创建。如果文件不存在，请在 GPanel 文件编辑器中手动创建，路径为ShooterGame/Saved/Config/WindowsServer/。- 文件名区分大小写。必须精确为
Game.ini— 而非game.ini、GAME.INI或任何其他变体。 - 确保文件第一行包含
[/script/shootergame.shootergamemode]标题，且此标题只出现一次。
Game.ini 或 GameUserSettings.ini 中的设置未被应用
- 确认在编辑文件之前服务器已完全停止。如果服务器正在运行，它可能会在下次关闭时覆盖您的更改。
- 检查部分标题（例如
[ServerSettings]或[/script/shootergame.shootergamemode]）在文件中是否只出现一次。重复的部分标题会导致后面的设置覆盖前面的设置，或根据解析器的不同被完全忽略。 - 保存文件后，在测试之前从 GPanel 完全重启服务器。
- 验证文件是否在正确的目录中：
ShooterGame/Saved/Config/WindowsServer/。放在错误位置的文件会被静默忽略。
配置设置后服务器未出现在服务器浏览器中
- 确认
GameUserSettings.ini中的QueryPort与 GPanel Network 选项卡中列出的端口完全匹配。 - 服务器浏览器可能需要 5-10 分钟来索引新启动或重新配置的服务器。在浏览器更新期间，可以在 ASA 游戏内控制台中使用
open IP:GAMEPORT直接连接以验证服务器是否可达。 - 如果启用了跨平台游戏，玩家必须在服务器浏览器中取消勾选平台锁定过滤器。有关详细信息，请参阅连接指南。
