模组:在Windows上安装SMAPI

来自Stardew Valley Wiki
跳到导航 跳到搜索
模组使用指南 SMAPI mascot.png


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

安装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 SMAPIUpdate 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自带的安装程序

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

方法二:使用ModDrop更新

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

方法三:使用Vortex更新

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

卸载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

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

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

Steam

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

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

  1. 保持SMAPI的安装程序窗口打开。
    (如果您已经关闭了它,只需再次运行安装程序即可。不需要先卸载。)
  2. 在安装程序窗口中复制文本,如图所示(查看如何复制文本:英文 中文):
    Modding - installing SMAPI on Windows - installer Steam text.png
    请确保复制一整行,复制多余的空格也无所谓,包括 " 符号和 %command% 部分。
    您复制的文本大概长这样: "StardewModdingAPI.exe文件的路径" %command%
  3. 在Steam客户端中,右键点击Stardew Valley并选择属性:
    Modding - installing SMAPI on Windows - Steam 1 ZH.png

  4. 通用 中点击启动选项 下面的文本框:
    Modding - installing SMAPI on Windows - Steam 2 ZH.png

  5. 用从安装程序复制的文本替换此文本框内的所有内容。
    (若要粘贴文本,请在框中单击并按CTRLV,当然你也可以右键后点粘贴
  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. 在记事本窗口中点击“文件”选项卡,然后点击“另存为…”选项。
    Save batch script ZH.png

  3. 在保存时先定位到您的游戏文件位置,然后将保存类型从“文本文档”切换为“所有文件”,如下图所示。
    Choose batch extension ZH.png

  4. 然后在“文件名”的文本框中将该文件命名为 start.bat ,如下图所示。
    Name batch script ZH.png

  5. 打开GOG Galaxy客户端,选择游戏Stardew Valley ,然后点击在“开始游戏”右侧的选项图标,依次选择安装管理 > 设置 ,如下图所示。
    Gog galaxy configure.png

  6. 在弹出窗口中勾选自定义可执行文件/参数 选项,如下图所示。
    Gog galaxy custom launch.png

  7. 然后点击“添加另一个可执行文件/参数”选项,如下图所示。
    Gog galaxy add exectuable ZH.png

  8. 接着选择到之前保存 start.bat 文件的路径并选中这个文件,然后点击打开 按钮,如下图所示。
    Select batch file.png

  9. 最后,选中“文件2”最下面的默认可执行文件 选项,然后点击右下角的选定按钮,如下图所示。
    Gog galaxy select default executable ZH.png

  10. 从现在开始,您便可以通过GOG Galaxy客户端启动SMAPI并显示出它的控制台窗口了,同时正常启动游戏了!

疑难解答

"Oops, couldn't find the game automatically"

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

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

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

与SMAPI或Mods有关的问题

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

入门