星露谷物语模组管理器 (SMAPI)

更新日期：2025年9月30日

简介

SMAPI（Stardew Modding API）是星露谷物语的模组加载器，它允许玩家在游戏中使用各种模组。本指南将详细介绍如何在Windows系统上安装和配置SMAPI。

安装SMAPI

基本安装步骤

1. 首先至少运行一次不带SMAPI的游戏（以便进行首次设置）
2. 下载最新版本的SMAPI：
   • SMAPI官网下载
   • SMAPI Github下载
3. 将*.zip文件解压到某个位置（下载文件夹即可）
4. 双击运行”install on Windows.bat”文件，并按照屏幕上的指示操作
5. 配置您的游戏客户端：请参考Steam、GOG Galaxy或Xbox应用的说明

注意：如果要手动安装而不是使用安装程序，请参阅安装程序自述文件中的说明。

配置游戏客户端

Steam平台

默认启动SMAPI（推荐）

如果您希望通过Steam启动SMAPI并启用Steam覆盖层、成就和游戏时间跟踪功能，需要进行以下配置。如果您不关心成就或游戏时间跟踪，可以直接在游戏文件夹中运行StardewModdingAPI.exe来使用模组玩游戏。

配置步骤：

1. 保持SMAPI安装程序窗口打开（如果已经关闭，只需再次运行它，无需先卸载）

2. 复制安装程序窗口中显示的文本，格式如下：

   1	"您的SMAPI文件路径" %command%

   大多数用户的默认路径是：

   1	"C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\StardewModdingAPI.exe" %command%

   重要提示：确保复制整行文本，包括双引号”和%command%部分。引号和%command%都是必需的！

3. 在Steam客户端中，右键单击星露谷物语并选择属性

4. 点击”启动选项”下的文本框

5. 将文本框中的任何内容替换为您从安装程序复制的文本（按Ctrl+V粘贴）

6. 从现在开始，只需通过Steam启动游戏即可运行带有Steam覆盖层和成就的SMAPI

将SMAPI作为非Steam游戏启动

或者，您可以将SMAPI添加为非Steam游戏，以便在Steam客户端中为无模组和有模组版本的游戏提供独立的播放按钮。大多数玩家不需要这样做。

GOG Galaxy平台

如果您希望通过GOG Galaxy启动SMAPI并启用游戏时间跟踪功能，需要进行以下配置。如果您不关心游戏时间跟踪，可以直接在游戏文件夹中运行StardewModdingAPI.exe来使用模组玩游戏。

配置步骤：

1. 打开记事本并粘贴以下内容：

   1	start "" "C:\Program Files (x86)\GOG Galaxy\Games\Stardew Valley\StardewModdingAPI.exe"

   注意：如果您的游戏安装到其他文件夹，请替换上述命令中的路径。

2. 点击”文件”，然后选择”另存为”

3. 在出现的”另存为”窗口中：导航到您的星露谷物语游戏文件夹，将”保存类型”更改为”所有文件”，将文件名更改为”start.bat”，然后点击”保存”

4. 在GOG Galaxy客户端中，点击星露谷物语 > 设置图标 > 管理安装 > 配置

5. 在出现的菜单中，启用”自定义可执行文件/参数”复选框

6. 点击”添加另一个可执行文件/参数”

7. 在出现的窗口中选择start.bat并点击”打开”

8. 启用”文件2”部分下的”默认可执行文件”单选按钮，然后点击”确定”

9. 从现在开始，您可以通过GOG Galaxy启动星露谷物语，SMAPI控制台和游戏都将按预期加载！

Xbox应用

模组可以在Xbox应用上使用，但需要一些额外的步骤。

安装SMAPI之前：

1. 在Xbox应用中打开星露谷物语部分
2. 点击… > 管理按钮
3. 点击”文件”选项卡，然后点击”浏览”打开您的游戏文件夹
4. 打开星露谷物语 > Content文件夹。您应该会看到许多名称如api-ms-win-core-*的文件
5. 从顶部的地址栏复制完整路径

运行SMAPI安装程序：

像往常一样运行SMAPI安装程序，但：

1. 将安装程序下载到非游戏目录的位置（如下载文件夹）
2. 当询问安装位置时，输入您在上一步复制的路径

安装SMAPI后：

在您的游戏文件夹中：

1. 将”Stardew Valley.exe”重命名为其他名称，如”Stardew Valley original.exe”
2. 制作”StardewModdingAPI.exe”的副本，并将副本命名为”Stardew Valley.exe”

就是这样！现在只需通过Xbox应用启动游戏即可使用模组玩游戏。请注意，当游戏更新时，您需要重新执行最后两个步骤。

更新SMAPI

只需安装新版本；安装程序将自动清理以前的版本。（您不需要再次配置Steam或GOG Galaxy。）

卸载SMAPI

再次运行安装程序，但选择卸载以删除SMAPI。（不适用于Xbox应用。）

如果您配置了Steam或GOG Galaxy来启动SMAPI，请撤消您的更改：

• Steam：在Steam客户端中：右键单击星露谷物语，选择属性 > 常规 > 设置启动选项，并清空启动选项文本框。
• GOG Galaxy：在GOG Galaxy客户端中：单击星露谷物语，单击”播放”按钮旁边的设置图标，单击管理安装 > 配置，并清除自定义可执行文件/参数复选框。
• Xbox应用：按照Xbox应用的安装步骤打开您的游戏文件夹，然后撤销安装后所做的更改。

参考资料

本文档内容整理自星露谷物语Wiki官方指南 0