模组:在Windows上安装SMAPI

模组:使用指南/header

本页介绍如何在Windows上安装SMAPI（该工具可让您使用Mod）。其他平台的安装指南：

安装SMAPI

无论您选择什么方法进行安装，都需要先完成下面的两个步骤：

运行未安装SMAPI的游戏一次，让游戏完成初始化设置。
Windows 10之前的Windows系统（例如Windows 7）需要提前安装最低版本为 4.5.2的.NET Framework。通常情况下，Windows 10系统已自带该框架，无需手动安装。

方法一：使用SMAPI自带的安装程序

下载最新版本的SMAPI。
在任意位置解压缩.zip文件(但不要在游戏文件夹里！)。
双击文件夹内的 install on Windows.bat ¹文件，接着根据屏幕上的提示进行安装即可。
安装完成后，您可以查看通过Steam或GOG Galaxy启动SMAPI这部分内容来通过游戏平台直接启动SMAPI。

如果您在以上安装步骤中出现了错误，请查看本页的疑难解答部分。

¹ 如果您想要手动安装SMAPI，请阅读SMAPI安装文件夹中的 README.txt 文件。

方法二：使用ModDrop安装

ModDrop是一款支持SMAPI的Mod管理器。您可以通过它安装并更新SMAPI，并简化安装/更新Mod的步骤。

安装ModDrop后打开该软件。
在软件左栏选定游戏为"Stardew Valley"，然后在右上角点击Install SMAPI 或Update Available 。
在弹出窗口中显示类似 "A new version of SMAPI is available." 的描述时，点击Install 按钮并按照窗口中的提示操作即可。

方法三：使用Vortex安装

Votex是一款由Nexus Mods发行的Mod管理器，您可以通过它安装并更新SMAPI，并简化安装/更新Mod的步骤。

登录Nexus Mods账号。
安装并运行Vortex。
点击软件界面左下角的Log In or Register 按钮，会打开一个浏览器窗口询问您是否授权Vortex同步您的Nexus Mods账号。选择同意授权以使得在Nexus mod的网页上可以直接使用Mod管理器下载Mod。
在Vortex软件中点击左侧的games 按钮，然后设置星露谷物语的本地文件路径。
点击Vortex软件内右上角的提醒图标，会提示并协助您下载并安装SMAPI。
安装SMAPI后，点击 "enable" 按钮，您就完成了SMAPI的安装步骤。
您可以查看通过Steam或GOG Galaxy启动SMAPI这部分内容来通过游戏平台直接启动SMAPI。

更新SMAPI

方法一：使用SMAPI自带的安装程序

直接下载最新版本的SMAPI，安装时会执行覆盖安装，无需提前卸载旧版本。更新后需要重新设置游戏平台的启动项。

方法二：使用ModDrop更新

在软件左栏选定游戏为"Stardew Valley"，然后在右上角点击Update Available 。
根据软件内的提示进行更新即可。

方法三：使用Vortex更新

前往Nexus Mods上SMAPI的发布页，然后点击Mod Manager Download 按钮。
在弹出窗口中点击打开Vortex 。
点击Vortex软件内右上角的提醒图标，会提示并协助您下载并更新SMAPI。

卸载SMAPI

重新运行SMAPI的安装程序 install on Windows.bat ，随后输入相应数字选择 Uninstall SMAPI 进行卸载。
如果您先前已经配置Steam或GOG Galaxy的启动项，需要按照以下步骤清除启动项：
- Steam：打开Steam客户端，在游戏库中右键点击Stardew Valley ，依次选择属性 > 通用 > 启动选项，然后清空启动选项的文本框即可。
- GOG Galaxy：打开GOG Galaxy客户端，选择游戏Stardew Valley ，然后点击在“开始游戏”右侧的选项图标，依次选择安装管理 > 设置 ，在弹出窗口中取消勾选自定义可执行文件/参数 选项，并点击确定以保存设置。

（如果您只是暂时不想使用Mod进行游戏，您可以不用卸载SMAPI，而是直接在本地游戏文件夹中启动 Stardew Valley.exe 或是重命名 Mods 文件夹。）

通过Steam或GOG Galaxy启动SMAPI

如果您正在使用Steam或GOG Galaxy且希望它们同步您的游戏时间和成就进度，您可以对它们进行设置，从而在开始运行星露谷物语时直接启动SMAPI。

如果您不需要同步您的游戏时间或是解锁游戏成就，您可以在游戏文件夹中直接启动 StardewModdingAPI.exe 来加载Mod进行游戏。

Steam

您可以通过Steam客户端启动SMAPI并使用Steam的游戏内覆盖和成就功能。

在配置Steam启动项之前，需要确保你的游戏路径里没有中文，否则将设置失败。

保持SMAPI的安装程序窗口打开。
（如果您已经关闭了它，只需再次运行安装程序即可。不需要先卸载。）
在安装程序窗口中复制文本，如图所示（查看如何复制文本：英文中文）：

请确保复制一整行，复制多余的空格也无所谓，包括 " 符号和 %command% 部分。
您复制的文本大概长这样： "StardewModdingAPI.exe文件的路径" %command% 。
在Steam客户端中，右键点击Stardew Valley并选择属性:
在通用中点击启动选项 下面的文本框:
用从安装程序复制的文本替换此文本框内的所有内容。
（若要粘贴文本，请在框中单击并按CTRL和V，当然你也可以右键后点粘贴）
关闭这个窗口来保存更改。
从现在开始，您便可以通过Steam客户端启动SMAPI并使用Steam的游戏内覆盖和成就功能。

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并显示出它的控制台窗口了，同时正常启动游戏了！