1,078
个编辑
更改
更新页面
{{ 模组: 使用指南/header}}
本页介绍如何在Windows上安装SMAPI( 该工具可让您使 用MOD) 。 相关页面 ：
本页介绍如何在Windows上安装SMAPI （ 该工具可让您使 用Mod） 。 其他平台的安装指南 ：
* [[ 使用 模组: 玩家常见问题| 玩家常见问题]]
* [[模组: 在Android上安装SMAPI| 在Android上安装SMAPI]]
* [[ 使用 模组:在Linux上安装SMAPI|Linux的说明]]
* [[模组:在Linux上安装SMAPI| 在Linux上安装SMAPI]]
* [[ 使用 模组:在Mac上安装SMAPI|Mac的说明]]
* [[模组:在Mac上安装SMAPI| 在Mac上安装SMAPI]]
__TOC__
__TOC__
==安 装==
==安 装SMAPI==
无论您选择什么方法进行安装，都需要先完成下面的两个 步 骤：
# 运行未 安装SMAPI 的游戏一次，让游戏完成初始化设置。
# Windows 10之前的Windows系统（例如Windows 7）需要提前安装最低版本为[https://dotnet.microsoft.com/download/dotnet-framework/net452 4.5.2的.NET Framework]，您也可以直接点击'''[https://dotnet.microsoft.com/download/dotnet-framework/thank-you/net452-chs 此链接]'''下载安装程序。通常情况下，Windows 10系统已自带该框架，无需手动安装。
===方法一：使用SMAPI自带 的安装 程序===
# 下载[https://smapi.io 最新版本的SMAPI]。
# 在任意位置解压缩<tt>.zip</tt>文件(但不要在游戏文件夹里！)。
# 双击 文件夹内的<tt> install on Windows.bat </tt>¹文件， 接着根据屏幕 上的 提示进行安装即可 。
# 安装完成后 ， 您 可以 查看[[# 通过Steam或GOG Galaxy启动SMAPI| 通过Steam或GOG Galaxy启动SMAPI]] 这部分内容来通过 游戏 平台直接启动SMAPI 。
如果您在以上安装 步 骤中出现了错误，请查看本页的[[# 疑难解答|疑难解答]]部分。
<small> ¹ 如果您 想要手动安装SMAPI ， 请阅读SMAPI 安装文 件夹 中的<tt> README.txt </tt>文 件 。</small>
===方法二：使用ModDrop 安装===
ModDrop是一款支持SMAPI的Mod管理器。您可以通过它安装并更新SMAPI ， 并简化 安装/更新Mod 的 步骤 。
==更 新==
# [https://www.moddrop.com 安装ModDrop]后打开该软件。
# 在软件左栏选定游戏为"Stardew Valley"，然后在右上角点击''Install SMAPI'' 或''Update Available'' 。
# 在弹出窗口中显示类似 "A new version of SMAPI is available." 的描述时，点击''Install'' 按钮并按照窗口中的提示操作即可。
===方法三：使用Vortex安装===
Votex是一款由Nexus Mods发行的Mod管理器，您可以通过它安装并更新SMAPI，并简化安装/更新Mod的步骤。
# 登录[https://www.nexusmods.com Nexus Mods]账号。
# 安装并运行[https://www.nexusmods.com/about/vortex/ Vortex]。
# 点击软件界面左下角的''Log In or Register'' 按钮，会打开一个浏览器窗口询问您是否授权Vortex同步您的Nexus Mods账号。选择同意授权以使得在Nexus mod的网页上可以直接使用Mod管理器下载Mod。
# 在Vortex软件中点击左侧的''games'' 按钮，然后设置星露谷物语的本地文件路径。
# 点击Vortex软件内右上角的提醒图标，会提示并协助您下载并安装SMAPI。
# 安装SMAPI后，点击 "enable" 按钮，您就完成了SMAPI的安装步骤。
# 您可以查看[[#通过Steam或GOG Galaxy启动SMAPI|通过Steam或GOG Galaxy启动SMAPI]]这部分内容来通过游戏平台直接启动SMAPI。
==更 新SMAPI==
===方法一：使用SMAPI自带的 安装 程序===
直接下载[https://smapi.io 最 新版本 的SMAPI]， 安装 时会执行覆盖安装，无需提 前 卸载旧 版本。 更新后 需要 重新[[#通过Steam或GOG Galaxy启动SMAPI|设置游戏平台的启动项]]。
===方法二：使用ModDrop更新===
# 在软件左栏选定游戏为"Stardew Valley"，然后在右上角点击''Update Available'' 。
# 根据软件内的提示进行更新即可。
===方法三：使用Vortex更新===
# 前往[https://www.nexusmods.com/stardewvalley/mods/2400 Nexus Mods上SMAPI的发布页]，然后点击''Mod Manager Download'' 按钮。
# 在弹出窗口中点击''打开Vortex'' 。
# 点击Vortex软件内右上角的提醒图标，会提示并协助您下载并更新SMAPI 。
==卸载SMAPI==
==卸载SMAPI==
# 运行<tt>install on Windows</tt> 并 在弹出来的 黑色 窗口 上输入数字2 ， 然后 按{{key|Enter}}。
# 重新 运行[[#方法一：使用SMAPI自带的安装程序|SMAPI的安装程序]] <tt> install on Windows.bat </tt> ，随后输入相应数字选择<tt> Uninstall SMAPI </tt>进行卸载。
# 清空Steam 启动选项（ 如果你修改过 ）。
# 如果您先前已经[[#通过Steam或GOG Galaxy启动SMAPI|配置Steam或GOG Galaxy的启动项]]，需要按照以下步骤清除启动项：
#* '''Steam：'''打开Steam客户端，在游戏库中右键点击''Stardew Valley'' ，依次选择''属性 > 通用 > 启动选项''，然后清空启动选项的文本框即可。
#* '''GOG Galaxy：'''打开GOG Galaxy客户端，选择游戏''Stardew Valley'' ，然后点击在“开始游戏”右侧的选项图标，依次选择''安装管理 > 设置'' ， 在弹出 窗口中取消勾选''自定义可执行文件/参数'' 选项，并点击''确定'' 以保存设置。
（如果您只是暂时不想使用Mod进行游戏，您可以不用卸载SMAPI，而是直接在本地游戏文件夹中启动 <tt>Stardew Valley.exe</tt> 或是重命名 <tt>Mods</tt> 文件夹。）
==通过Steam或GOG Galaxy启动SMAPI==
如果您正在使用Steam或GOG Galaxy且希望它们同步您的游戏时间和成就进度，您可以对它们进行设置，从而在开始运行星露谷物语时直接启动SMAPI。
如果您不需要同步您的游戏时间或是解锁游戏成就，您可以在[[模组:使用指南/入门#游戏文件夹|游戏文件夹]]中直接启动 <tt>StardewModdingAPI.exe</tt> 来 加载Mod进行游戏。
===Steam===
您可以通过Steam客户端启动SMAPI并使用Steam 的 游戏内覆盖和成就功能。
'''在配置Steam启动项之前，需要确保你的游戏路径里没有中文，否则将设置失败。'''
# 保持SMAPI的安装程序 窗口 打开。<br /><small>（如果您已经关闭了它，只需再次运行安装程序即可。不需要先卸载。）</small>
# '''在安装程序窗口中'''复制文本，如图所示（查看如何复制文本：[https://community.playstarbound.com/threads/smapi-stardew-modding-api.108375/page-139#post-3292321 英文] [https://tieba.baidu.com/p/5965562987 中文]）：<br />[[File:Modding - installing SMAPI on Windows - installer Steam text.png|700px]]<br />'''请确保复制一整行，复制多余的空格也无所谓，包括 <code>"</code> 符号和 <code>%command%</code> 部分。''' <br /><small>您复制的文本大概长这样： <code>"StardewModdingAPI.exe文件的路径" %command%</code> 。</small>
# 在Steam客户端中，右键点击'''Stardew Valley'''并选择'''属性''':<br />[[File:Modding - installing SMAPI on Windows - Steam 1 ZH.png]]<br /><br />
# 在''通用'' 中点击''启动选项'' 下面的文本框:<br />[[File:Modding - installing SMAPI on Windows - Steam 2 ZH.png]]<br /><br />
# 用从安装程序复制的文本替换此文本框内的所有内容。<br />（若要粘贴文本 ， 请在框中单击并 按{{key|CTRL}} 和{{key|V}}，当然你也可以'''右键'''后点'''粘贴'''）
# 关闭这个窗口来保存更改 。
# 从现在开始，您便可以通过Steam客户端启动SMAPI并使用Steam的游戏内覆盖和成就功能。
===GOG Galaxy===
您可以通过GOG Galaxy客户端启动SMAPI以同步您的游戏时间。下面的步骤用于告知GOG Galaxy运行一个启动 <tt>StardewModdingAPI.exe</tt> 的批处理脚本。因为如果直接在GOG Galaxy中设置 启动 <tt>StardewModdingAPI.exe</tt> 不会显示出SMAPI的控制台界面，也就无从得知Mod运行时的警告或错误提醒。
# 打开记事本复制并粘贴以下代码：<code>start "" "C:\Program Files (x86)\GOG Galaxy\Games\Stardew Valley\StardewModdingAPI.exe"</code> 。如果星露谷物语没有安装在默认位置 <code>C:\Program Files (x86)\GOG Galaxy\Games\Stardew Valley\</code> ，您需要将代码代码中的游戏路径更换成您安装星露谷物语的路径。
# 在记事本窗口中点击“文件”选项卡，然后点击“另存为…”选项。<br />[[File:Save_batch_script_ZH.png|800px]]<br /><br />
# 在保存时先定位到您的游戏文件位置，然后将保存类型从“文本文档”切换为“所有文件”，如下图所示。<br />[[File:Choose_batch_extension_ZH.png|800px]]<br /><br />
# 然后在“文件名”的文本框中将该文件命名为 <code>start.bat</code> ，如下图所示。<br />[[File:Name_batch_script_ZH.png|800px]]<br /><br />
# 打开GOG Galaxy客户端，选择游戏''Stardew Valley'' ，然后点击在“开始游戏”右侧的 选项 图标，依次选择''安装管理 > 设置'' ，如下图所示。<br /> [[File:Gog_galaxy_configure.png|800px]]<br /><br />
# 在弹出窗口中勾选''自定义可执行文件/参数'' 选项，如下图所示。<br />[[File:Gog_galaxy_custom_launch.png|400px]]<br /><br />
# 然后点击“添加另一个可执行文件/参数”选项，如下图所示。<br />[[File:Gog_galaxy_add_exectuable_ZH.png|400px]]<br /><br />
# 接着选择到之前保存 <tt>start.bat</tt> 文件的路径并选中这个文件，然后点击''打开'' 按钮，如下图所示。<br />[[File:Select_batch_file.png|800px]]<br /><br />
# 最后，选中“文件2”最下面的''默认可执行文件'' 选项，然后点击右下角的选定按钮，如下图所示。<br />[[File:Gog_galaxy_select_default_executable_ZH.png|400px]]<br /><br />
# 从现在开始，您便可以通过GOG Galaxy客户端启动SMAPI并显示出它的控制台窗口了，同时正常启动游戏了！
==疑难解答==
==="Oops, couldn't find the game automatically"===
如果SMAPI的安装程序显示了这条消息，您需要输入您的电脑中星露谷物语的游戏文件位置。您可以执行以下步骤：
# 退出安装程序。
# [[模组:使用指南/入门#游戏文件夹|找到您的游戏文件夹]]
# 将整个SMAPI的安装程序'''文件夹'''移动到您的游戏文件夹内。 （ 注意是移动整个文件夹，而不是里面的文件，文件夹的名字应该像 <code>SMAPI 版本号 installer</code> 这样 ） 。
# 重新运行SMAPI的安装程序，此时它应该就能自动检测到游戏文件夹了。
您可以在完成后删除这个安装程序的文件夹。
===与SMAPI或Mods有关的问题===
请查看[[模组:使用指南/疑难解答|疑难解答页面]]以帮助您解决安装完成后的其他问题 。
{{Modding guide footer
|prev = [[模组:使用指南/ 入门|入门]]
|next =
}}
[[Category:模组]]
[[Category:模组]]
[[en:Modding:Installing SMAPI on Windows]]
[[en:Modding:Installing SMAPI on Windows]]