模组:在Windows上安装SMAPI

← 模組:目錄

模組使用指南

• 入門
• 疑難解答
• 按鍵綁定
• 兼容性

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

• 在Android上安裝SMAPI
• 在Linux上安裝SMAPI
• 在Mac上安裝SMAPI

安裝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. 在安裝程序窗口中複製文本，如圖所示（查看如何複製文本：英文 中文）：
   
   請確保複製一整行，複製多餘的空格也無所謂，包括兩個 " 符號（英文引號！）和 %command% 部分。
   您複製的文本大概長這樣： "StardewModdingAPI.exe文件的路径" %command% 。
3. 在Steam客戶端中，右鍵點擊Stardew Valley並選擇屬性:
   
   
   
4. 在「通用」 點擊「啟動選項」下面的文本框:
   
   
   
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. 如下圖所示選擇「啟用模組」選項，並在彈出窗口中確認啟用。
   
3. 然後選擇「打開模組文件夾」，此時系統會使用文件資源管理器自動打開遊戲目錄。
   
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. 在記事本窗口中點擊「文件」選項卡，然後點擊「另存為…」選項。
   
   
   
3. 在保存時先定位到您的遊戲文件位置，然後將保存類型從「文本文檔」切換為「所有文件」，如下圖所示。
   
   
   
4. 然後在「文件名」的文本框中將該文件命名為 start.bat ，如下圖所示。
   
   
   
5. 打開GOG Galaxy客戶端，選擇遊戲Stardew Valley ，然後點擊在「開始遊戲」右側的選項圖標，依次選擇安裝管理 > 設置 ，如下圖所示。
   
   
   
6. 在彈出窗口中勾選自定義可執行文件/參數 選項，如下圖所示。
   
   
   
7. 然後點擊「添加另一個可執行文件/參數」選項，如下圖所示。
   
   
   
8. 接着選擇到之前保存 start.bat 文件的路徑並選中這個文件，然後點擊打開 按鈕，如下圖所示。
   
   
   
9. 最後，選中「文件2」最下面的默認可執行文件 選項，然後點擊右下角的選定按鈕，如下圖所示。
   
   
   
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有關的問題

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

← 入門