离线安装模组压缩包

离线安装模组压缩包

适用于已经下载到电脑上的 .zip、.7z 或 .rar 模组文件。

安装前

• 关闭《星露谷物语》和 SMAPI。
• 确认文件来自可信来源。
• 通常不用提前解压压缩包。
• 如果是在更新已安装的模组，优先使用 一键更新模组。

安装步骤

1. 打开添加窗口

进入 模组管理，点击顶部的 添加模组。窗口标题可能显示为“添加Mod”，两者是同一个功能。

2. 加入压缩包

选择一种方式：

• 把压缩包拖到窗口的虚线区域。
• 点击 通过文件选择器添加，选择压缩包后点击 打开。

第一次使用时，建议一次只安装一个模组。选不到 .rar 文件时，可以改用拖放。

3. 确认文件

确认列表中的文件名正确，然后点击 下一步。

管理器会查找 manifest.json，并判断真正的模组文件夹。如果提示找不到 manifest.json，请先看下方的“常见问题”。

4. 确认文件夹名称

• 模组文件夹名称：安装后显示在 Mods 文件夹中的名称。一般保留默认值即可。
• 备注：可选。可以填写中文名、用途或下载来源，方便以后查找。

不要让两个不同的模组使用同一个文件夹名称。

5. 安装并刷新

点击 下一步 开始安装。保持窗口打开，直到显示成功或明确的错误。

安装完成后：

1. 关闭添加窗口。
2. 回到 模组管理。
3. 点击 刷新。
4. 确认新模组出现在列表中。

常见问题

提示“目标文件夹已经存在”

通常表示这个模组已经安装。不要随便换个名称继续安装，否则可能出现两个重复模组。

需要更新时，请使用 检查模组更新 / 一键更新模组；也可以先备份并删除旧版本，再安装新版本。

提示“找不到 manifest.json”

常见原因：

• 下载的是源码包，不是安装包。
• 真正的安装包还在压缩包里面。
• 这个文件不是 SMAPI 模组。

打开压缩包，找到包含 manifest.json 的那一层或里面的安装压缩包，再重新添加。

安装成功，但游戏没有加载模组

依次检查：

1. SMAPI 是否已经安装。
2. 模组是否已启用。
3. 模组需要的前置是否齐全。
4. SMAPI 窗口是否显示红色错误。