“模组:在Windows上安装SMAPI”的版本间的差异
小 (Change Category) |
(更新页面) |
||
第1行: | 第1行: | ||
− | + | {{ 模组: 使用指南/header}} | |
− | 本页介绍如何在Windows上安装SMAPI | + | 本页介绍如何在Windows上安装SMAPI ( 该工具可让您使 用Mod) 。 其他平台的安装指南 : |
− | * [[ | + | * [[模组: 在Android上安装SMAPI| 在Android上安装SMAPI]] |
− | * [[ | + | * [[模组:在Linux上安装SMAPI| 在Linux上安装SMAPI]] |
− | * [[ | + | * [[模组:在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> | + | # 重新 运行[[#方法一:使用SMAPI自带的安装程序|SMAPI的安装程序]] <tt> install on Windows.bat </tt> ,随后输入相应数字选择<tt> Uninstall SMAPI </tt>进行卸载。 |
− | # | + | # 如果您先前已经[[#通过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]] |
2021年2月7日 (日) 14:38的版本
本页介绍如何在Windows上安装SMAPI(该工具可让您使用Mod)。其他平台的安装指南:
安装SMAPI
无论您选择什么方法进行安装,都需要先完成下面的两个步骤:
- 运行未安装SMAPI的游戏一次,让游戏完成初始化设置。
- Windows 10之前的Windows系统(例如Windows 7)需要提前安装最低版本为4.5.2的.NET Framework,您也可以直接点击此链接下载安装程序。通常情况下,Windows 10系统已自带该框架,无需手动安装。
方法一:使用SMAPI自带的安装程序
- 下载最新版本的SMAPI。
- 在任意位置解压缩.zip文件(但不要在游戏文件夹里!)。
- 双击文件夹内的 install on Windows.bat ¹文件,接着根据屏幕上的提示进行安装即可。
- 安装完成后,您可以查看通过Steam或GOG Galaxy启动SMAPI这部分内容来通过游戏平台直接启动SMAPI。
如果您在以上安装步骤中出现了错误,请查看本页的疑难解答部分。
¹ 如果您想要手动安装SMAPI,请阅读SMAPI安装文件夹中的 README.txt 文件。
方法二:使用ModDrop安装
ModDrop是一款支持SMAPI的Mod管理器。您可以通过它安装并更新SMAPI,并简化安装/更新Mod的步骤。
- 安装ModDrop后打开该软件。
- 在软件左栏选定游戏为"Stardew Valley",然后在右上角点击Install SMAPI 或Update Available 。
- 在弹出窗口中显示类似 "A new version of SMAPI is available." 的描述时,点击Install 按钮并按照窗口中的提示操作即可。
方法三:使用Vortex安装
Votex是一款由Nexus Mods发行的Mod管理器,您可以通过它安装并更新SMAPI,并简化安装/更新Mod的步骤。
- 登录Nexus Mods账号。
- 安装并运行Vortex。
- 点击软件界面左下角的Log In or Register 按钮,会打开一个浏览器窗口询问您是否授权Vortex同步您的Nexus Mods账号。选择同意授权以使得在Nexus mod的网页上可以直接使用Mod管理器下载Mod。
- 在Vortex软件中点击左侧的games 按钮,然后设置星露谷物语的本地文件路径。
- 点击Vortex软件内右上角的提醒图标,会提示并协助您下载并安装SMAPI。
- 安装SMAPI后,点击 "enable" 按钮,您就完成了SMAPI的安装步骤。
- 您可以查看通过Steam或GOG Galaxy启动SMAPI这部分内容来通过游戏平台直接启动SMAPI。
更新SMAPI
方法一:使用SMAPI自带的安装程序
直接下载最新版本的SMAPI,安装时会执行覆盖安装,无需提前卸载旧版本。更新后需要重新设置游戏平台的启动项。
方法二:使用ModDrop更新
- 在软件左栏选定游戏为"Stardew Valley",然后在右上角点击Update Available 。
- 根据软件内的提示进行更新即可。
方法三:使用Vortex更新
- 前往Nexus Mods上SMAPI的发布页,然后点击Mod Manager Download 按钮。
- 在弹出窗口中点击打开Vortex 。
- 点击Vortex软件内右上角的提醒图标,会提示并协助您下载并更新SMAPI。
卸载SMAPI
- 重新运行SMAPI的安装程序 install on Windows.bat ,随后输入相应数字选择 Uninstall SMAPI 进行卸载。
- 如果您先前已经配置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启动项之前,需要确保你的游戏路径里没有中文,否则将设置失败。
- 保持SMAPI的安装程序窗口打开。
(如果您已经关闭了它,只需再次运行安装程序即可。不需要先卸载。) - 在安装程序窗口中复制文本,如图所示(查看如何复制文本:英文 中文):
请确保复制一整行,复制多余的空格也无所谓,包括"
符号和%command%
部分。
您复制的文本大概长这样:"StardewModdingAPI.exe文件的路径" %command%
。 - 在Steam客户端中,右键点击Stardew Valley并选择属性:
- 在通用 中点击启动选项 下面的文本框:
- 用从安装程序复制的文本替换此文本框内的所有内容。
(若要粘贴文本,请在框中单击并按CTRL和V,当然你也可以右键后点粘贴) - 关闭这个窗口来保存更改。
- 从现在开始,您便可以通过Steam客户端启动SMAPI并使用Steam的游戏内覆盖和成就功能。
GOG Galaxy
您可以通过GOG Galaxy客户端启动SMAPI以同步您的游戏时间。下面的步骤用于告知GOG Galaxy运行一个启动 StardewModdingAPI.exe 的批处理脚本。因为如果直接在GOG Galaxy中设置启动 StardewModdingAPI.exe 不会显示出SMAPI的控制台界面,也就无从得知Mod运行时的警告或错误提醒。
- 打开记事本复制并粘贴以下代码:
start "" "C:\Program Files (x86)\GOG Galaxy\Games\Stardew Valley\StardewModdingAPI.exe"
。如果星露谷物语没有安装在默认位置C:\Program Files (x86)\GOG Galaxy\Games\Stardew Valley\
,您需要将代码代码中的游戏路径更换成您安装星露谷物语的路径。 - 在记事本窗口中点击“文件”选项卡,然后点击“另存为…”选项。
- 在保存时先定位到您的游戏文件位置,然后将保存类型从“文本文档”切换为“所有文件”,如下图所示。
- 然后在“文件名”的文本框中将该文件命名为
start.bat
,如下图所示。 - 打开GOG Galaxy客户端,选择游戏Stardew Valley ,然后点击在“开始游戏”右侧的选项图标,依次选择安装管理 > 设置 ,如下图所示。
- 在弹出窗口中勾选自定义可执行文件/参数 选项,如下图所示。
- 然后点击“添加另一个可执行文件/参数”选项,如下图所示。
- 接着选择到之前保存 start.bat 文件的路径并选中这个文件,然后点击打开 按钮,如下图所示。
- 最后,选中“文件2”最下面的默认可执行文件 选项,然后点击右下角的选定按钮,如下图所示。
- 从现在开始,您便可以通过GOG Galaxy客户端启动SMAPI并显示出它的控制台窗口了,同时正常启动游戏了!
疑难解答
"Oops, couldn't find the game automatically"
如果SMAPI的安装程序显示了这条消息,您需要输入您的电脑中星露谷物语的游戏文件位置。您可以执行以下步骤:
- 退出安装程序。
- 找到您的游戏文件夹
- 将整个SMAPI的安装程序文件夹移动到您的游戏文件夹内。(注意是移动整个文件夹,而不是里面的文件,文件夹的名字应该像
SMAPI 版本号 installer
这样)。 - 重新运行SMAPI的安装程序,此时它应该就能自动检测到游戏文件夹了。
您可以在完成后删除这个安装程序的文件夹。
与SMAPI或Mods有关的问题
请查看疑难解答页面以帮助您解决安装完成后的其他问题。