← 模组:目录
模组使用指南
入门
疑难解答
按键绑定
兼容性（站外）
本页介绍如何在 Windows 上安装 SMAPI（该工具可让您使用模组）。其他平台的安装指南：
在 Android 上安装SMAPI
在 Linux 上安装SMAPI
在 Mac 上安装SMAPI
在 Steam Deck 上安装 SMAPI
目录
1 安装SMAPI
2 设置游戏平台启动项
2.1 Steam
2.2 Xbox App
2.3 GOG Galaxy
3 更新SMAPI
4 卸载SMAPI
5 疑难解答
5.1 "Oops, couldn't find the game automatically"
5.2 我无法找到指南中提到的某个文件
5.3 与SMAPI或Mods有关的问题
安装SMAPI
运行未安装SMAPI的游戏一次，让游戏完成初始化设置。
下载最新版本的SMAPI。
在任意位置解压缩.zip文件(但不要放在游戏文件夹、游戏文件夹的子目录、路径内有括号的文件夹内！)。
双击文件夹内的 install on Windows.bat ¹文件，接着根据屏幕上的提示进行安装即可。
安装完成后，您可以查看设置游戏平台启动项这部分内容来通过游戏平台直接启动SMAPI。
如果您在以上安装步骤中出现了错误，请查看本页的疑难解答部分。
¹ 如果您想要手动安装SMAPI，请阅读SMAPI安装文件夹中的 README.txt 文件。
设置游戏平台启动项
如果您正在使用Steam或GOG Galaxy且希望它们同步您的游戏时间和成就进度，您可以对它们进行设置，从而在开始运行星露谷物语时直接启动SMAPI。
如果您不需要同步您的游戏时间或是解锁游戏成就，您可以在游戏文件夹中直接启动 StardewModdingAPI.exe 来加载Mod进行游戏。
Steam
您可以通过 Steam 客户端启动 SMAPI 以使用Steam的游戏内覆盖、成就和游戏时间跟踪功能（如果您不需使用这些功能，则可以使用您的游戏文件夹中的 StardewModdingAPI.exe 来直接启动游戏。）
在配置Steam启动项之前，需要确保您的游戏路径里没有中文，否则将设置失败。
保持SMAPI的安装程序窗口打开。（如果您已经关闭了它，只需再次运行安装程序即可。不需要先卸载。）
在安装程序窗口中复制文本，如图所示（查看如何复制文本：英文 中文）：请确保复制一整行，复制多余的空格也无所谓，包括两个 " 符号（英文引号！）和 %command% 部分。 您复制的文本大概长这样： "StardewModdingAPI.exe文件的路径" %command% 。
在Steam客户端中，右键点击Stardew Valley并选择属性:
在“通用” 点击“启动选项”下面的文本框:
用从安装程序复制的文本替换此文本框内的所有内容。（若要粘贴文本，请在框中单击并按CTRL和V，当然您也可以右键后点粘贴）大部分玩家的默认命令为 "C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\StardewModdingAPI.exe" %command%
关闭这个窗口来保存更改。
从现在开始，您便可以通过Steam客户端启动SMAPI并使用Steam的游戏内覆盖和成就功能。
与此相对地，如果您希望在 Steam 中为无模组版游戏和模组版分别设置启动按钮，则可以按如下方式操作：
保持SMAPI的安装程序窗口打开，就像前一种方法中那样。（如果您已经关闭了它，只需再次运行安装程序即可。不需要先卸载。）
像上文那样复制安装窗口中的文本，但不要复制 %command% 部分。
在 Steam 客户端中，选择窗口左上角的“游戏”，然后选择“添加非 Steam 游戏到我的库中...”
在弹出的菜单中，选择“浏览...”
在浏览窗口的文件框中粘贴先前复制的文本。您也可采取另一种方法，也就是在窗口中一步一步地找到游戏文件 - 您可以通过浏览星露谷的本地文件找到游戏文件夹，但是对于大多数用户而言，Steam 的游戏文件位于 "C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley。
选中 StardewModdingAPI 并点击“打开”。SMAPI 会被添加到游戏库的程序列表中。在“浏览”按钮所在的窗口中点击“添加所选程序” ，然后您的游戏库中就会出现 StardewModdingAPI。
（可选）如果您希望自定义标题，则可以在 Steam 客户端中，右击 "StardewModdingAPI" 并选择“属性...”。您现在可以在顶端的输入框中为 StardewModdingAPI 起一个自定义标题 - 建议您设为 "SMAPI" 或 "Stardew Valley Modded"（不包含引号）。（这不会对安装造成任何影响，而只会改变模组客户端在 Steam 库中的标题）。
您现在可以选择启动 StardewModdingAPI（或您的自定义标题），然后 SMAPI 就会启动，且能保持您的 Steam 游戏库中原有的 "Stardew Valley" 不变，以便您游玩无模组游戏。Steam 内覆盖仍然有效，且 Steam 也能识别到 Stardew Valley 正在运行，因此能够添加游戏时长。成就也会正常工作，因为 SMAPI 运行时，Stardew Valley 也能够被识别为正在运行。
Xbox App
如果您是在Xbox App上游玩星露谷物语，Mod也可以正常安装使用，只是有一些额外步骤。
安装SMAPI之前：
在Xbox App里打开星露谷物语界面。
如下图所示选择“启用模组”选项，并在弹出窗口中确认启用。
然后选择“打开模组文件夹”，此时系统会使用文件资源管理器自动打开游戏目录。
在文件管理器的地址栏中中复制游戏目录。
运行SMAPI安装程序：
运行SMAPI安装程序，当它询问安装路径时（即显示“Where do you want to add or remove SMAPI?”时），输入选项“Enter a custom game path”前的阿拉伯数字自定义安装位置（即根据情况输入数字1或数字2或其他数字），然后按下回车键。
粘贴您刚刚复制的游戏目录位置后按下回车，等待安装成功。默认位置为C:\Program Files\ModifiableWindowsApps\Stardew Valley
安装SMAPI后：
在您的游戏文件夹中将 Stardew Valley.exe重命名为另外一个名称，例如 Stardew Valley original.exe。
然后将 StardewModdingAPI.exe 重命名为 Stardew Valley.exe。
通过Xbox App或开始菜单启动星露谷物语（您无法直接从文件夹里启动游戏或 StardewModdingAPI.exe）。
GOG Galaxy
您可以通过GOG Galaxy客户端启动SMAPI以同步您的游戏时间。下面的步骤用于告知GOG Galaxy运行一个启动 StardewModdingAPI.exe 的批处理脚本。因为如果直接在GOG Galaxy中设置启动 StardewModdingAPI.exe 不会显示出SMAPI的控制台界面，也就无从得知Mod运行时的警告或错误提醒。
打开记事本复制并粘贴以下代码：start "" "C:\Program Files (x86)\GOG Galaxy\Games\Stardew Valley\StardewModdingAPI.exe" 。如果星露谷物语没有安装在默认位置 C:\Program Files (x86)\GOG Galaxy\Games\Stardew Valley\ ，您需要将代码代码中的游戏路径更换成您安装星露谷物语的路径。
在记事本窗口中点击“文件”选项卡，然后点击“另存为…”选项。
在保存时先定位到您的游戏文件位置，然后将保存类型从“文本文档”切换为“所有文件”，如下图所示。
然后在“文件名”的文本框中将该文件命名为 start.bat ，如下图所示。
打开GOG Galaxy客户端，选择游戏Stardew Valley ，然后点击在“开始游戏”右侧的选项图标，依次选择安装管理 > 设置 ，如下图所示。
在弹出窗口中勾选自定义可执行文件/参数 选项，如下图所示。
然后点击“添加另一个可执行文件/参数”选项，如下图所示。
接着选择到之前保存 start.bat 文件的路径并选中这个文件，然后点击打开 按钮，如下图所示。
最后，选中“文件2”最下面的默认可执行文件 选项，然后点击右下角的选定按钮，如下图所示。
从现在开始，您便可以通过GOG Galaxy客户端启动SMAPI并显示出它的控制台窗口了，同时正常启动游戏了！
更新SMAPI
只需安装最新版本；安装程序会自动清除掉先前的版本。（无需重新配置 Steam 或 Gog Galaxy）。
卸载SMAPI
重新运行SMAPI的安装程序 install on Windows.bat ，随后输入相应数字选择 Uninstall SMAPI 进行卸载（该方法不适用于Xbox APP，Xbox APP平台需要卸载并重新安装游戏才能删除SMAPI相关文件，您也可以选择按照下面的方法清除启动选项）。
如果您先前已经设置游戏平台启动项，需要按照以下步骤清除启动项：
Steam：打开Steam客户端，在游戏库中右键点击Stardew Valley ，依次选择属性 > 通用 > 启动选项，然后清空启动选项的文本框即可。
Xbox App：
将 Stardew Valley.exe 重命名为 StardewModdingAPI.exe。
将您在为Xbox App版星露谷物语安装SMAPI时重命名的原版游戏程序（例如 Stardew Valley original.exe）重新命名回 Stardew Valley.exe。
GOG Galaxy：打开GOG Galaxy客户端，选择游戏Stardew Valley ，然后点击在“开始游戏”右侧的选项图标，依次选择安装管理 > 设置 ，在弹出窗口中取消勾选自定义可执行文件/参数 选项，并点击确定 以保存设置。
如果您只是暂时不想使用Mod进行游戏，您可以不用卸载SMAPI，而是直接在本地游戏文件夹中启动 Stardew Valley.exe 或是重命名 Mods 文件夹（不适用于XBox App）。
疑难解答
"Oops, couldn't find the game automatically"
如果您是通过Xbox App游玩，请查看为Xbox App版星露谷物语安装SMAPI这一部分。
如果您在Steam等其他平台安装时，SMAPI的安装程序显示了这条消息，您需要输入您的电脑中星露谷物语的游戏文件位置。您可以执行以下步骤：
退出安装程序。
找到您的游戏文件夹
将整个SMAPI的安装程序文件夹移动到您的游戏文件夹内。（注意是移动整个文件夹，而不是里面的文件，文件夹的名字应该像 SMAPI 版本号 installer 这样）。
重新运行SMAPI的安装程序，此时它应该就能自动检测到游戏文件夹了。
您可以在完成后删除这个安装程序的文件夹。
我无法找到指南中提到的某个文件
Windows 默认隐藏文件扩展名。欲显示，则需勾选文件浏览器中的如下选项：
若您正在使用 Windows 11，则需参考如下截图：
与SMAPI或Mods有关的问题
请查看疑难解答页面以帮助您解决安装完成后的其他问题。
← 入门
Modding:Installing SMAPI on Windows