ARK: Survival Ascended 使用 CurseForge 进行 mod 分发，而不是 Steam Workshop。本指南涵盖了查找 mod、在服务器上安装 mod、管理 mod 加载顺序、添加自定义地图、更新和删除 mod 以及排除常见 mod 相关问题。
ASA 使用 CurseForge，而非 Steam Workshop。 与 ARK: Survival Evolved 不同，ARK: Survival Ascended 不使用 Steam Workshop 来管理 mod。所有 ASA mod 都托管在 CurseForge 上。您不能将 Steam Workshop mod ID 用于 ASA。
在 CurseForge 上查找 Mod
所有 ARK: Survival Ascended mod 都发布在 CurseForge 上。要找到服务器安装所需的 mod ID：
- 访问 CurseForge 上的 ARK: Survival Ascended 区域。
- 浏览或搜索您想要的 mod。您可以按类别筛选（游戏玩法、地图、物品、建筑等）。
- 打开 mod 页面，在右侧 About Project 部分找到 Project ID。这个数字 ID 就是您所需要的。
Example CurseForge URL: https://www.curseforge.com/ark-survival-ascended/mods/super-structures
Project ID (shown on the page): 929420
^^^^^^ this is the mod ID you need
提示： 在前往 GPanel 之前，请记下或保存 mod ID。如果您要安装多个 mod，请保留所有 ID 及您希望的加载顺序列表。
通过 GPanel 安装 Mod
在 ARK: Survival Ascended 服务器上添加 mod 的推荐方法是通过 GPanel 启动变量：
- 从 GPanel 控制台页面停止服务器。
- 导航至 Startup 选项卡。
- 找到 Mod IDs（或 MODS）启动变量。
- 输入您的 CurseForge mod ID，用逗号分隔，不带空格：
929420,926956,927131 - 启动服务器。 Mod 将在启动时自动下载和安装。
首次使用 mod 启动需要更长时间。 服务器必须在完成启动之前下载每个 mod。大型 mod 或完全转换 mod 可能会增加几分钟的启动时间。在 mod 下载期间不要重启服务器。
通过 GameUserSettings.ini 添加 Mod
您也可以通过直接编辑配置文件来添加 mod。通过 GPanel 的 File Manager 或通过 SFTP 访问 GameUserSettings.ini。
在 [ServerSettings] 部分下，添加或编辑 ActiveMods 行：
[ServerSettings]
ActiveMods=929420,926956,927131或者，可以在服务器启动命令行中使用 -mods 标志指定 mod：
-mods="929420,926956,927131"
注意： 在 Legion Hosting 服务器上，推荐使用 GPanel 启动变量方法，而非手动编辑文件。如果您同时在启动变量和配置文件中设置了 mod，启动变量通常会优先。
Mod 加载顺序
mod ID 的列出顺序决定了加载顺序。这很重要，因为修改相同游戏系统的 mod 可能会相互冲突。
| 位置 | 应放置的内容 | 示例 |
|---|---|---|
| 首位 | 完全转换 mod 或自定义地图（这些会覆盖核心游戏系统） | 完全转换、mod 地图 |
| 中间 | 主要游戏玩法改动（堆叠、建筑、驯服） | Super Structures, Awesome SpyGlass |
| 末位 | 次要的生活质量改善 mod 和装饰性 mod | Death Recovery, HUD mod |
如果两个 mod 冲突，排在前面的优先级更高。排除 mod 问题时，请先尝试调整加载顺序，然后再考虑完全移除 mod。
安装自定义地图（Mod 地图）
Mod 地图的工作方式与普通 mod 类似，但需要额外的步骤来告诉服务器加载哪个地图：
- 在 CurseForge 上找到 mod 地图并记下其 Project ID。
- 将地图的 mod ID 添加到您的 mod 列表中（最好作为第一个条目）。
- 在 GPanel 的 Startup 选项卡中，将 Map（或 SERVER_MAP）变量更改为地图的内部名称。这通常在 mod 的 CurseForge 页面的安装说明中列出。
- 启动服务器。地图 mod 将下载，服务器将加载自定义地图。
Mod 地图与 DLC 地图： DLC 地图（如 The Center、Scorched Earth、Aberration 等）是官方内容，不需要 mod ID。它们仅使用 Map 启动变量来选择。来自 CurseForge 的 mod 地图需要在 mod 列表中添加 mod ID，并在 Map 变量中设置正确的地图名称。
客户端 Mod 安装
连接到您的 mod 服务器的玩家必须在客户端安装相同的 mod。如果玩家缺少必需的 mod，他们将无法加入或在加载期间被断开连接。
玩家如何安装 Mod
- 玩家可以安装 CurseForge 应用程序并订阅与您服务器相同的 mod。
- 或者，当玩家尝试加入 mod 服务器时，ARK: Survival Ascended 会提示他们自动下载任何缺少的 mod（如果 mod 在 CurseForge 上可用）。
- 玩家应确保其 mod 版本与服务器一致。客户端 mod 过期会导致连接失败。
分享您的 mod 列表： 将服务器的 mod 列表（包括 CurseForge 链接或 mod ID）分享给您的玩家是一种好做法。这有助于他们在尝试连接之前安装 mod，减少故障排除时间。
更新 Mod
大多数情况下，mod 更新会自动处理：
- 服务器端： 服务器启动时会检查 mod 更新并自动下载新版本。简单地重启服务器通常足以应用 mod 更新。
- 客户端： 使用 CurseForge 应用程序的玩家将收到 mod 更新通知。玩家必须更新本地 mod 文件以匹配服务器版本。
- 强制更新： 如果 mod 没有自动更新，请停止服务器然后重新启动。启动过程会重新验证所有 mod 文件。
Mod 更新可能会导致问题。 Mod 更新可能会引入与其他 mod 或当前游戏版本的不兼容性。如果您的服务器在 mod 更新后停止工作，请查看该 mod 的 CurseForge 页面了解已知问题，或通过暂时禁用有问题的 mod 来回滚。
移除 Mod
- 停止服务器。
- 前往 GPanel 中的 Startup 选项卡，从 mod 列表中移除 mod ID。
- 如果您通过
GameUserSettings.ini添加了 mod，也请从ActiveMods行中移除它。 - 启动服务器。 该 mod 将不再加载。
警告： 移除添加了物品、建筑或生物的 mod 将导致这些对象从世界中消失。背包中有 mod 物品的玩家将失去这些物品。这可能会导致使用 mod 建筑建造的基地出现问题。在移除内容 mod 之前，请务必提前通知您的玩家。
常见 Mod 问题故障排除
服务器无法使用 mod 启动
- 检查 mod ID： 验证启动变量或配置文件中的所有 mod ID 都是正确的 CurseForge Project ID。拼写错误或无效 ID 将阻止服务器启动。
- 检查不兼容的 mod： 移除所有 mod，然后逐个添加回来，每次添加后启动服务器。这可以确定哪个 mod 导致了故障。
- 控制台错误： 检查 GPanel 控制台输出中的错误消息。与 mod 相关的错误通常会提到 mod ID 或 mod 名称。
- Mod 已停止维护： 如果 mod 已从 CurseForge 移除，服务器将无法下载它。请从您的 mod 列表中移除该 ID。
版本不匹配错误
- 游戏更新与 mod 更新： 在 ARK: Survival Ascended 进行重大游戏更新后，某些 mod 可能与新版本不兼容，直到 mod 作者更新它们。请查看每个 mod 的 CurseForge 页面了解兼容性说明。
- 客户端/服务器不匹配： 服务器和所有玩家必须运行每个 mod 的相同版本。重启服务器以获取最新 mod 版本，并要求玩家通过 CurseForge 应用程序更新他们的 mod。
Mod 冲突
- 症状： 添加新 mod 后出现崩溃、物品丢失、UI 损坏或意外的游戏行为。
- 解决方法： 重新排列 mod 加载顺序（请参阅上面的 Mod 加载顺序部分）。如果冲突持续存在，请查看 CurseForge 上的 mod 页面了解已知的不兼容性。您可能需要在两个 mod 中选择其一。
玩家无法连接到 mod 服务器
- 确认玩家已安装所有必需的 mod 并且是最新版本。
- 验证服务器和客户端之间的 mod 版本是否匹配。
- 如果问题是在添加新 mod 后开始的，请尝试暂时移除它以确认它是否是原因。
- 确保服务器和客户端之间的 BattleEye 设置匹配。有关详细信息，请参阅如何连接指南。
Mod 导致的性能问题
- 每个 mod 都会增加服务器负载。运行许多大型 mod 会增加启动时间、RAM 使用量并导致延迟。
- 完全转换 mod 是最重的。不建议组合多个完全转换 mod。
- 如果服务器运行困难，请考虑减少活跃 mod 的数量或升级服务器套餐以获得更多资源。
热门 Mod 类别
| 类别 | 说明 | 示例 |
|---|---|---|
| 建筑 | 增强型建筑部件、吸附改进和新的建造选项 | Super Structures, Castles & Keeps |
| 生活质量 | 堆叠 mod、HUD 增强、死亡恢复辅助 | Awesome SpyGlass, Death Recovery |
| 生物 | 新的可驯服生物、生物平衡调整和伙伴系统改进 | Additional Creatures, Dino Storage |
| 地图 | 具有独特地形、资源和挑战的自定义世界 | 社区创建的自定义地图 |
| 完全转换 | 改变核心机制、进度和游戏玩法的完整游戏改造 | 各种完全转换项目 |
相关文章
- ARK: Survival Ascended 服务器配置
- ARK: Survival Ascended 管理员命令
- 如何连接到您的 ARK: Survival Ascended 服务器
- 如何查找您的服务器 IP 和端口
- 如何通过 SFTP 上传文件
需要帮助？ 如果您遇到本指南未涵盖的 mod 问题，请提交支持工单，并附上您的服务器 ID、正在使用的 mod ID 以及 GPanel 中的相关控制台输出。
