「模组:在Windows上安装SMAPI」修訂間的差異

出自Stardew Valley Wiki
跳至導覽 跳至搜尋
（更新内容）
第11行： 第11行：
  
 
===方法一：使用SMAPI自带的安装程序===
 
===方法一：使用SMAPI自带的安装程序===
 +
注意：如果您是在XBOX APP上游玩星露谷物语，请先查看[[#Xbox APP|XBOX APP]]一节。
 
# 运行未安装SMAPI的游戏一次，让游戏完成初始化设置。
 
# 运行未安装SMAPI的游戏一次，让游戏完成初始化设置。
 
# 需要提前安装[https://dotnet.microsoft.com/download/dotnet/5.0/runtime .NET 5 (desktop x64)]:<br />[[File:Modding - .NET 5 download on Windows.png|thumb|none|700px|具体版本]]
 
# 需要提前安装[https://dotnet.microsoft.com/download/dotnet/5.0/runtime .NET 5 (desktop x64)]:<br />[[File:Modding - .NET 5 download on Windows.png|thumb|none|700px|具体版本]]
第16行： 第17行：
 
# 在任意位置解压缩<samp>.zip</samp>文件(但不要放在游戏文件夹、游戏文件夹的子目录、路径内有括号的文件夹内！)。
 
# 在任意位置解压缩<samp>.zip</samp>文件(但不要放在游戏文件夹、游戏文件夹的子目录、路径内有括号的文件夹内！)。
 
# 双击文件夹内的<samp> install on Windows.bat </samp>¹文件，接着根据屏幕上的提示进行安装即可。
 
# 双击文件夹内的<samp> install on Windows.bat </samp>¹文件，接着根据屏幕上的提示进行安装即可。
−
# 安装完成后，您可以查看[[# 通过Steam或GOG Galaxy 启 动SMAPI| 通过Steam或GOG Galaxy 启 动SMAPI]]这部分内容来通过游戏平台直接启动SMAPI。
+
# 安装完成后，您可以查看[[# 设置游戏平台 启 动项| 设置游戏平台 启 动项]]这部分内容来通过游戏平台直接启动SMAPI。
  
 
 如果您在以上安装步骤中出现了错误，请查看本页的[[#疑难解答|疑难解答]]部分。
 
 如果您在以上安装步骤中出现了错误，请查看本页的[[#疑难解答|疑难解答]]部分。
第42行： 第43行：
 
# 点击Vortex软件内右上角的提醒图标，会提示并协助您下载并安装SMAPI。
 
# 点击Vortex软件内右上角的提醒图标，会提示并协助您下载并安装SMAPI。
 
# 安装SMAPI后，点击 "enable" 按钮，您就完成了SMAPI的安装步骤。
 
# 安装SMAPI后，点击 "enable" 按钮，您就完成了SMAPI的安装步骤。
−
# 您可以查看[[# 通过Steam或GOG Galaxy 启 动SMAPI| 通过Steam或GOG Galaxy 启 动SMAPI]]这部分内容来通过游戏平台直接启动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自带的安装程序|SMAPI的安装程序]] <samp> install on Windows.bat </samp>，随后输入相应数字选择<samp> Uninstall SMAPI </samp>进行卸载。
 
−
# 如果您先前已经[[#通过Steam或GOG Galaxy启动SMAPI|配置Steam或GOG Galaxy的启动项]]，需要按照以下步骤清除 启动项 ：
 
−
#* '''Steam：'''打开Steam客户端，在游戏库中右键点击''Stardew Valley'' ，依次选择''属性 > 通用 > 启动选项''，然后清空启动选项的文本框即可。
 
−
#* '''GOG Galaxy：'''打开GOG Galaxy客户端，选择游戏''Stardew Valley'' ，然后点击在“开始游戏”右侧的选项图标，依次选择''安装管理 > 设置'' ，在弹出窗口中取消勾选''自定义可执行文件/参数'' 选项，并点击''确定'' 以保存设置。
 
−
 
 
−
（如果您只是暂时不想使用Mod进行游戏，您可以不用卸载SMAPI，而是直接在本地游戏文件夹中启动 <samp>Stardew Valley.exe</samp> 或是重命名 <samp>Mods</samp> 文件夹。）
 
−
 
 
−
==通过Steam或GOG Galaxy启动SMAPI==
 
 
 如果您正在使用Steam或GOG Galaxy且希望它们同步您的游戏时间和成就进度，您可以对它们进行设置，从而在开始运行星露谷物语时直接启动SMAPI。
 
 如果您正在使用Steam或GOG Galaxy且希望它们同步您的游戏时间和成就进度，您可以对它们进行设置，从而在开始运行星露谷物语时直接启动SMAPI。
  
第82行： 第62行：
 
# 关闭这个窗口来保存更改。
 
# 关闭这个窗口来保存更改。
 
# 从现在开始，您便可以通过Steam客户端启动SMAPI并使用Steam的游戏内覆盖和成就功能。
 
# 从现在开始，您便可以通过Steam客户端启动SMAPI并使用Steam的游戏内覆盖和成就功能。
 +
 +
===XBOX APP===
 +
如果你是在XBOX APP上游玩星露谷物语，Mod也可以正常安装使用，只是有一些额外步骤。
 +
 +
'''安装SMAPI之前：'''
 +
# 在XBOX APP里打开星露谷物语界面。
 +
# 如下图所示选择“启用模组”选项，并在弹出窗口中确认启用。<br />[[File:Modding - installing SMAPI on Windows - Game Pass ZH.png|700px]]
 +
# 然后选择“打开模组文件夹”，此时系统会使用文件资源管理器自动打开游戏目录。
 +
# 在文件管理器的地址栏中中复制游戏目录。
 +
 +
'''运行SMAPI安装程序：'''
 +
# [[#安装SMAPI|运行SMAPI安装程序]]，当它询问安装路径时（即显示“Where do you want to add or remove SMAPI?”时），输入选项“Enter a custom game path”前的阿拉伯数字自定义安装位置，然后按下回车键。
 +
# 粘贴您刚刚复制的游戏目录位置后按下回车，等待安装成功。<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===
第96行： 第94行：
 
# 最后，选中“文件2”最下面的''默认可执行文件'' 选项，然后点击右下角的选定按钮，如下图所示。<br />[[File:Gog_galaxy_select_default_executable_ZH.png|400px]]<br /><br />
 
# 最后，选中“文件2”最下面的''默认可执行文件'' 选项，然后点击右下角的选定按钮，如下图所示。<br />[[File:Gog_galaxy_select_default_executable_ZH.png|400px]]<br /><br />
 
# 从现在开始，您便可以通过GOG Galaxy客户端启动SMAPI并显示出它的控制台窗口了，同时正常启动游戏了！
 
# 从现在开始，您便可以通过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自带的安装程序|SMAPI的安装程序]] <samp> install on Windows.bat </samp>，随后输入相应数字选择<samp> Uninstall SMAPI </samp>进行卸载。
 +
# 如果您先前已经[[#设置游戏平台启动项|配置Steam或GOG Galaxy的启动项]]，需要按照以下步骤清除启动项：
 +
#* '''Steam：'''打开Steam客户端，在游戏库中右键点击''Stardew Valley'' ，依次选择''属性 > 通用 > 启动选项''，然后清空启动选项的文本框即可。
 +
#* '''GOG Galaxy：'''打开GOG Galaxy客户端，选择游戏''Stardew Valley'' ，然后点击在“开始游戏”右侧的选项图标，依次选择''安装管理 > 设置'' ，在弹出窗口中取消勾选''自定义可执行文件/参数'' 选项，并点击''确定'' 以保存设置。
 +
 +
（如果您只是暂时不想使用Mod进行游戏，您可以不用卸载SMAPI，而是直接在本地游戏文件夹中启动 <samp>Stardew Valley.exe</samp> 或是重命名 <samp>Mods</samp> 文件夹。）
  
 
==疑难解答==
 
==疑难解答==

於 2021年12月3日 (五) 17:58 的修訂

模組:使用指南/header

本頁介紹如何在Windows上安裝SMAPI（該工具可讓您使用Mod）。其他平台的安裝指南：

安裝SMAPI

方法一：使用SMAPI自帶的安裝程序

注意：如果您是在XBOX APP上遊玩星露谷物語，請先查看XBOX APP一節。

  1. 運行未安裝SMAPI的遊戲一次，讓遊戲完成初始化設置。
  2. 需要提前安裝.NET 5 (desktop x64):
    File:Modding - .NET 5 download on Windows.png
    具體版本
  3. 下載最新版本的SMAPI。
  4. 在任意位置解壓縮.zip文件(但不要放在遊戲文件夾、遊戲文件夾的子目錄、路徑內有括號的文件夾內！)。
  5. 雙擊文件夾內的 install on Windows.bat ¹文件，接着根據屏幕上的提示進行安裝即可。
  6. 安裝完成後，您可以查看設置遊戲平台啟動項這部分內容來通過遊戲平台直接啟動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. 用從安裝程序複製的文本替換此文本框內的所有內容。
    （若要粘貼文本，請在框中單擊並按CTRL和V，當然你也可以右鍵後點粘貼）
    大部分玩家的默認命令為 "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. 如下圖所示選擇「啟用模組」選項，並在彈出窗口中確認啟用。
    700px
  3. 然後選擇「打開模組文件夾」，此時系統會使用文件資源管理器自動打開遊戲目錄。
  4. 在文件管理器的地址欄中中複製遊戲目錄。

運行SMAPI安裝程序：

  1. 運行SMAPI安裝程序，當它詢問安裝路徑時（即顯示「Where do you want to add or remove SMAPI?」時），輸入選項「Enter a custom game path」前的阿拉伯數字自定義安裝位置，然後按下回車鍵。
  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 進行卸載。
  2. 如果您先前已經配置Steam或GOG Galaxy的啟動項，需要按照以下步驟清除啟動項：
    • Steam：打開Steam客戶端，在遊戲庫中右鍵點擊Stardew Valley ，依次選擇屬性 > 通用 > 啟動選項，然後清空啟動選項的文本框即可。
    • GOG Galaxy：打開GOG Galaxy客戶端，選擇遊戲Stardew Valley ，然後點擊在「開始遊戲」右側的選項圖標，依次選擇安裝管理 > 設置 ，在彈出窗口中取消勾選自定義可執行文件/參數 選項，並點擊確定 以保存設置。

（如果您只是暫時不想使用Mod進行遊戲，您可以不用卸載SMAPI，而是直接在本地遊戲文件夾中啟動 Stardew Valley.exe 或是重命名 Mods 文件夾。）

疑難解答

"Oops, couldn't find the game automatically"

如果SMAPI的安裝程序顯示了這條消息，您需要輸入您的電腦中星露谷物語的遊戲文件位置。您可以執行以下步驟：

  1. 退出安裝程序。
  2. 找到您的遊戲文件夾
  3. 將整個SMAPI的安裝程序文件夾移動到您的遊戲文件夾內。（注意是移動整個文件夾，而不是裏面的文件，文件夾的名字應該像 SMAPI 版本号 installer 這樣）。
  4. 重新運行SMAPI的安裝程序，此時它應該就能自動檢測到遊戲文件夾了。

您可以在完成後刪除這個安裝程序的文件夾。

與SMAPI或Mods有關的問題

請查看疑難解答頁面以幫助您解決安裝完成後的其他問題。

← 入門
取自 "https://zh.stardewvalleywiki.com/mediawiki/index.php?title=模组:在Windows上安装SMAPI&oldid=23428"