105,831
个编辑
更改
use header template
{{Modding player guide 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自带的安装程序===
注意：如果您是在Xbox App上游玩星露谷物语，请先查看[[#Xbox App|Xbox App]]一节。
# 运行 未 安装SMAPI的游戏一次，让游戏完成 初始化 设置。
# 下载[https://smapi.io 最新版本的SMAPI]。
# 在任意位置解压缩<samp>.zip</samp>文件(但不要 放 在游戏文件夹 、游戏文件夹的子目录、路径内有括号的文件夹内 ！)。
# 双击 文件夹内的<samp> install on Windows.bat </samp>¹ 文件 ， 接着根据 屏幕上的 提示 进行安装 即可 。
# 安装完成后 ， 您 可以 查看[[# 设置 游戏 平台启动项| 设置 游戏 平台启动项]] 这部分内容来通过 游戏 平台直接启动SMAPI 。
如果您在以上安装 步 骤中出现了错误，请查看本页的[[# 疑难解答|疑难解答]]部分。
: 你可以通过Steam客户端使用SMAPI来启用游戏中的Steam界面和Steam成就。这需要更多的步骤。
<span style="font-size: smaller;">¹ 如果您 想要手动安装SMAPI ， 请阅读SMAPI 安装 文件夹 中的<samp> README.txt </samp>文 件 。</span>
<small>¹ 要手动 安装， 请参阅 安装 程序readme文件中 的 说明 。</small>
===方法二：使用ModDrop安装===
ModDrop尚未支持星露谷物语1.5.5。
<!--
ModDrop是一款支持SMAPI的Mod管理器。您可以通过它 安装 并更新SMAPI ， 并简化 安装/更新Mod 的 步骤 。
==更 新==
# [https://www.moddrop.com 安装ModDrop]后打开该软件。
只需安装 新版 本 ； 安装程序将 自 动 清除 以前的版本。(不 需要 再次配置Steam) 。
# 在软件左栏选定游戏为"Stardew Valley"，然后在右上角点击''Install SMAPI'' 或''Update Available'' 。
# 在弹出窗口中显示类似 "A new version of SMAPI is available." 的描述时，点击''Install'' 按钮并按照窗口中的提示操作即可。-->
===方法三：使用Vortex安装===
Vortex尚未支持星露谷物语1.5.5。
<!--
Vortex是一款由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的安装步骤。
# 您可以查看[[#设置游戏平台启动项|设置游戏平台启动项]]这部分内容来通过游戏平台直接启动SMAPI。
-->
==设置游戏平台启动项==
如果您正在使用Steam或GOG Galaxy且希望它们同步您的游戏时间和成就进度，您可以对它们进行设置，从而在开始运行星露谷物语时直接启动SMAPI。
如果您不需要同步您的游戏时间或是解锁游戏成就，您可以在[[模组:使用指南/入门#找到你的游戏文件夹|游戏文件夹]]中直接启动 <samp>StardewModdingAPI.exe</samp> 来加载Mod进行游戏。
===Steam===
您可以通过Steam客户端启动SMAPI并使用Steam的游戏内覆盖和成就功能。
'''在配置Steam启动项之前，需要确保您的游戏路径里没有中文，否则将设置失败。'''
# 保持SMAPI的安装程序窗口打开。<br /><span style="font-size: smaller;">（如果您已经关闭了它， 只需 再次运行安装程序即可。不需要先卸载。）</span>
# '''在 安装 程序窗口中'''复制文本，如图所示（查看如何复制文本：[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 /><span style="font-size: smaller;">您复制的文本大概长这样： <code>"StardewModdingAPI.exe文件的路径" %command%</code> 。</span>
# 在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|700px]]<br /><br />
# 用从安装程序复制的文本替换此文本框内的所有内容。<br />（若要粘贴文 本 ，请在框中单击并按{{key|CTRL}}和{{key|V}}，当然您也可以'''右键'''后点'''粘贴'''）<br /><small>大部分玩家的默认命令为 <code>"C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\StardewModdingAPI.exe" %command%</code></small>
# 关闭这个窗口来保存更改。
# 从现在开始，您便可以通过Steam客户端启动SMAPI并使用Steam的游戏内覆盖和成就功能。
===Xbox App===
如果您是在Xbox App上游玩星露谷物语，Mod也可以正常安装使用，只是有一些额外步骤。
'''安装SMAPI之前：'''
# 在Xbox App里打开星露谷物语界面。
# 如下图所示选择“启用模组”选项，并在弹出窗口中确认启用。<br />[[File:Modding - Enable SMAPI in Xbox app 1 ZH.png|700px]]
# 然后选择“打开模组文件夹”，此时系统会使用文件资源管理器自动打开游戏目录。<br />[[File:Modding - Enable SMAPI in Xbox app 2 ZH.png|700px]]
# 在文件管理器的地址栏中中复制游戏目录。
'''运行SMAPI 安装程序 ：'''
# [[#安装SMAPI|运行SMAPI安装程序]]，当它询问安装路径时（即显示“Where do you want to add or remove SMAPI?”时），输入选项“Enter a custom game path”前的阿拉伯数字自定义安装位置（即根据情况输入数字1或数字2或其他数字），然后按下回车键。
# 粘贴您刚刚复制的游戏目录位置后按下回车，等待安装成功。<br /><small>默认位置为<code>C:\Program Files\ModifiableWindowsApps\Stardew Valley</code></small>
'''安装SMAPI后：'''
# 在您的游戏文件夹中将 <samp>Stardew Valley.exe</samp>重命名为另外一个名称，例如 <samp>Stardew Valley original.exe</samp>。
# 然后 将 <samp>StardewModdingAPI.exe</samp> 重命名为 <samp>Stardew Valley.exe</samp>。
# 通过Xbox App或开始菜单启动星露谷物语（您无法直接从文件夹里启动游戏或 <samp>StardewModdingAPI.exe</samp>）。
===GOG Galaxy===
您可以通过GOG Galaxy客户端启动SMAPI以同步您的游戏时间。下面的步骤用于告知GOG Galaxy运行一个启动 <samp>StardewModdingAPI.exe</samp> 的批处理脚本。因为如果直接在GOG Galaxy中设置启 动 <samp>StardewModdingAPI.exe</samp> 不会显示出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|700px]]<br /><br />
# 在保存时先定位到您的游戏文件位置，然后将保存类型从“文本文档”切换为“所有文件”，如下图所示。<br />[[File:Choose_batch_extension_ZH.png|700px]]<br /><br />
# 然后在“文件名”的文本框中将该文件命名为 <code>start.bat</code> ，如下图所示。<br />[[File:Name_batch_script_ZH.png|700px]]<br /><br />
# 打开GOG Galaxy客户端，选择游戏''Stardew Valley'' ，然后点击在“开始游戏”右侧的选项图标，依次选择''安装管理 > 设置'' ，如下图所示。<br /> [[File:Gog_galaxy_configure.png|700px]]<br /><br />
# 在弹出窗口中勾选''自定义可执行文件/参数'' 选项，如下图所示。<br />[[File:Gog_galaxy_custom_launch.png|400px]]<br /><br />
# 然后点击“添加另一个可执行文件/参数”选项，如下图所示。<br />[[File:Gog_galaxy_add_exectuable_ZH.png|400px]]<br /><br />
# 接着选择到之 前 保存 <samp>start.bat</samp> 文件的路径并选中这个文件，然后点击''打开'' 按钮，如下图所示。<br />[[File:Select_batch_file.png|700px]]<br /><br />
# 最后，选中“文件2”最下面的''默认可执行文件'' 选项，然后点击右下角的选定按钮，如下图所示。<br />[[File:Gog_galaxy_select_default_executable_ZH.png|400px]]<br /><br />
# 从现在开始，您便可以通过GOG Galaxy客户端启动SMAPI并显示出它的控制台窗口了，同时正常启动游戏了！
==更新SMAPI==
===方法一：使用SMAPI自带 的 安装程序===
直接下载[https://smapi.io 最新版本的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.exe</tt>并选择''uninstall''。
# 重新 运行[[#方法一：使用SMAPI自带的安装程序|SMAPI的安装程序]] <samp> install on Windows.bat </samp>，随后输入相应数字选择<samp> Uninstall SMAPI </samp> 进行卸载（该方法不适用于Xbox APP，Xbox APP平台需要卸载 并 重新安装游戏才能删除SMAPI相关文件，您也可以选择按照下面的方法清除启动选项）。
# 清空Steam 启动 选项 （如果你 修改过 ）。
# 如果您先前已经[[#设置游戏平台启动项|设置游戏平台启动项]]，需要按照以下步骤清除启动项：
#* '''Steam：'''打开Steam客户端，在游戏库中右键点击''Stardew Valley'' ，依次 选择'' 属性 > 通用 > 启动选项'' ，然后清空启动选项的文本框即可。
#* '''Xbox App：'''
## 将 <samp>Stardew Valley.exe</samp> 重命名为 <samp>StardewModdingAPI.exe</samp> 。
## 将您在[[#Xbox App|为Xbox App版星露谷物语安装SMAPI]]时重命名的原版游戏程序（例如 <samp>Stardew Valley original.exe</samp>）重新命名回 <samp>Stardew Valley.exe</samp>。
#* '''GOG Galaxy：'''打开GOG Galaxy客户端，选择游戏''Stardew Valley'' ，然后点击在“开始游戏”右侧的选项图标，依次选择''安装管理 > 设置'' ，在弹出窗口中取消勾选''自定义可执行文件/参数'' 选项，并点击''确定'' 以保存设置。
如果您只是暂时不想使用Mod进行游戏，您可以不用卸载SMAPI，而是直接在本地游戏文件夹中 启动 <samp>Stardew Valley.exe</samp> 或是重命名 <samp>Mods</samp> 文件夹 （ 不适用于XBox App）。
==疑难解答==
==="Oops, couldn't find the game automatically"===
如果 您是通过Xbox App游玩，请查看[[#Xbox App|为Xbox App版星露谷物语安装SMAPI]]这一部分。
如果您在Steam等其他平台安装时，SMAPI的安装程序显示了这条消息，您需要输入您的电脑中星露谷物语的游戏文件位置。您可以执行以下步骤：
# 退出安装程序。
# [[模组:使用指南/入门#找到 你 的游戏文件夹|找到您的游戏文件夹]]
# 将整个SMAPI的安装程序'''文件夹'''移动到您的游戏文件夹内。（注意是移动整个文件夹，而不是里面的文件，文件夹的名字应该像 <code>SMAPI 版本号 installer</code> 这样 ） 。
# 重新运行SMAPI的安装程序，此时它应该就能自动检测到游戏文件夹了。
您可以在完成后删除这个安装程序的文件夹。
===与SMAPI或Mods有关的问题===
请查看[[模组:使用指南/疑难解答|疑难解答页面]]以帮助您解决安装完成后的其他问题 。
{{Modding guide footer
|prev = [[模组:使用指南/ 入门|入门]]
|next =
}}
[[Category: 使用 模组]]
[[Category:模组]]
[[de:Modding:SMAPI auf Windows]]
[[en:Modding:Installing SMAPI on Windows]]
[[en:Modding:Installing SMAPI on Windows]]
[[es:Modding:Instalar SMAPI en Windows]]
[[ru:Моддинг:Установка SMAPI на Windows]]