使用模组:在Windows上安装SMAPI

Template:模组:使用指南/header

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

• 在Android上安装SMAPI
• 在Linux上安装SMAPI
• 在Mac上安装SMAPI

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

1. 运行未安装SMAPI的游戏一次，让游戏完成初始化设置。
2. Windows 10之前的Windows系统（例如Windows 7）需要提前安装最低版本为4.5.2的.NET Framework，您也可以直接点击此链接下载安装程序。通常情况下，Windows 10系统已自带该框架，无需手动安装。

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

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

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

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

方法二：使用ModDrop安装

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

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

方法三：使用Vortex安装

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

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

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

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

方法二：使用ModDrop更新

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

方法三：使用Vortex更新

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

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

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

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

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

Steam

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

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

1. 保持SMAPI的安装程序窗口打开。
   （如果您已经关闭了它，只需再次运行安装程序即可。不需要先卸载。）
2. 在安装程序窗口中复制文本，如图所示（查看如何复制文本：英文 中文）：
   
   请确保复制一整行，复制多余的空格也无所谓，包括 " 符号和 %command% 部分。
   您复制的文本大概长这样： "StardewModdingAPI.exe文件的路径" %command% 。
3. 在Steam客户端中，右键点击Stardew Valley并选择属性:
   
   
   
4. 在通用 中点击启动选项 下面的文本框:
   
   
   
5. 用从安装程序复制的文本替换此文本框内的所有内容。
   （若要粘贴文本，请在框中单击并按CTRL和V，当然你也可以右键后点粘贴）
6. 关闭这个窗口来保存更改。
7. 从现在开始，您便可以通过Steam客户端启动SMAPI并使用Steam的游戏内覆盖和成就功能。

GOG Galaxy

您可以通过GOG Galaxy客户端启动SMAPI以同步您的游戏时间。下面的步骤用于告知GOG Galaxy运行一个启动 StardewModdingAPI.exe 的批处理脚本。因为如果直接在GOG Galaxy中设置启动 StardewModdingAPI.exe 不会显示出SMAPI的控制台界面，也就无从得知Mod运行时的警告或错误提醒。

1. 打开记事本复制并粘贴以下代码：start "" "C:\Program Files (x86)\GOG Galaxy\Games\Stardew Valley\StardewModdingAPI.exe" 。如果星露谷物语没有安装在默认位置 C:\Program Files (x86)\GOG Galaxy\Games\Stardew Valley\ ，您需要将代码代码中的游戏路径更换成您安装星露谷物语的路径。
2. 在记事本窗口中点击“文件”选项卡，然后点击“另存为…”选项。
   
   
   
3. 在保存时先定位到您的游戏文件位置，然后将保存类型从“文本文档”切换为“所有文件”，如下图所示。
   
   
   
4. 然后在“文件名”的文本框中将该文件命名为 start.bat ，如下图所示。
   
   
   
5. 打开GOG Galaxy客户端，选择游戏Stardew Valley ，然后点击在“开始游戏”右侧的选项图标，依次选择安装管理 > 设置 ，如下图所示。
   
   
   
6. 在弹出窗口中勾选自定义可执行文件/参数 选项，如下图所示。
   
   
   
7. 然后点击“添加另一个可执行文件/参数”选项，如下图所示。
   
   
   
8. 接着选择到之前保存 start.bat 文件的路径并选中这个文件，然后点击打开 按钮，如下图所示。
   
   
   
9. 最后，选中“文件2”最下面的默认可执行文件 选项，然后点击右下角的选定按钮，如下图所示。
   
   
   
10. 从现在开始，您便可以通过GOG Galaxy客户端启动SMAPI并显示出它的控制台窗口了，同时正常启动游戏了！

"Oops, couldn't find the game automatically"

如果SMAPI的安装程序显示了这条消息，您需要输入您的电脑中星露谷物语的游戏文件位置。您可以执行以下步骤：

1. 退出安装程序。
2. 找到您的游戏文件夹
3. 将整个SMAPI的安装程序文件夹移动到您的游戏文件夹内。（注意是移动整个文件夹，而不是里面的文件，文件夹的名字应该像 SMAPI 版本号 installer 这样）。
4. 重新运行SMAPI的安装程序，此时它应该就能自动检测到游戏文件夹了。

您可以在完成后删除这个安装程序的文件夹。

与SMAPI或Mods有关的问题

请查看疑难解答页面以帮助您解决安装完成后的其他问题。