模组:在Windows上安装SMAPI

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


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

安装SMAPI

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

注意:如果您是在Xbox App上游玩星露谷物语,请先查看Xbox App一节。

  1. 运行未安装SMAPI的游戏一次,让游戏完成初始化设置。
  2. 下载最新版本的SMAPI
  3. 在任意位置解压缩.zip文件(但不要放在游戏文件夹、游戏文件夹的子目录、路径内有括号的文件夹内!)。
  4. 双击文件夹内的 install on Windows.bat ¹文件,接着根据屏幕上的提示进行安装即可。
  5. 安装完成后,您可以查看设置游戏平台启动项这部分内容来通过游戏平台直接启动SMAPI。

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

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

方法二:使用ModDrop安装

ModDrop尚未支持星露谷物语1.5.5。

方法三:使用Vortex安装

Vortex尚未支持星露谷物语1.5.5。

设置游戏平台启动项

如果您正在使用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,当然您也可以右键后点粘贴
    大部分玩家的默认命令为 "C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\StardewModdingAPI.exe" %command%
  6. 关闭这个窗口来保存更改。
  7. 从现在开始,您便可以通过Steam客户端启动SMAPI并使用Steam的游戏内覆盖和成就功能。

Xbox App

如果您是在Xbox App上游玩星露谷物语,Mod也可以正常安装使用,只是有一些额外步骤。

安装SMAPI之前:

  1. 在Xbox App里打开星露谷物语界面。
  2. 如下图所示选择“启用模组”选项,并在弹出窗口中确认启用。
    Modding - Enable SMAPI in Xbox app 1 ZH.png
  3. 然后选择“打开模组文件夹”,此时系统会使用文件资源管理器自动打开游戏目录。
    Modding - Enable SMAPI in Xbox app 2 ZH.png
  4. 在文件管理器的地址栏中中复制游戏目录。

运行SMAPI安装程序:

  1. 运行SMAPI安装程序,当它询问安装路径时(即显示“Where do you want to add or remove SMAPI?”时),输入选项“Enter a custom game path”前的阿拉伯数字自定义安装位置(即根据情况输入数字1或数字2或其他数字),然后按下回车键。
  2. 粘贴您刚刚复制的游戏目录位置后按下回车,等待安装成功。
    默认位置为C:\Program Files\ModifiableWindowsApps\Stardew Valley

安装SMAPI后:

  1. 在您的游戏文件夹中将 Stardew Valley.exe重命名为另外一个名称,例如 Stardew Valley original.exe
  2. 然后将 StardewModdingAPI.exe 重命名为 Stardew Valley.exe
  3. 通过Xbox App或开始菜单启动星露谷物语(您无法直接从文件夹里启动游戏或 StardewModdingAPI.exe)。

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

更新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 进行卸载(该方法不适用于Xbox APP,Xbox APP平台需要卸载并重新安装游戏才能删除SMAPI相关文件,您也可以选择按照下面的方法清除启动选项)。
  2. 如果您先前已经设置游戏平台启动项,需要按照以下步骤清除启动项:
    • Steam:打开Steam客户端,在游戏库中右键点击Stardew Valley ,依次选择属性 > 通用 > 启动选项,然后清空启动选项的文本框即可。
    • Xbox App:
    1. Stardew Valley.exe 重命名为 StardewModdingAPI.exe
    2. 将您在为Xbox App版星露谷物语安装SMAPI时重命名的原版游戏程序(例如 Stardew Valley original.exe)重新命名回 Stardew Valley.exe
    • GOG Galaxy:打开GOG Galaxy客户端,选择游戏Stardew Valley ,然后点击在“开始游戏”右侧的选项图标,依次选择安装管理 > 设置 ,在弹出窗口中取消勾选自定义可执行文件/参数 选项,并点击确定 以保存设置。

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

疑难解答

"Oops, couldn't find the game automatically"

如果您是通过Xbox App游玩,请查看为Xbox App版星露谷物语安装SMAPI这一部分。

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

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

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

与SMAPI或Mods有关的问题

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

入门