模组:在Windows上安裝SMAPI

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

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

安裝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 SMAPI 或Update 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. 在安裝程序窗口中複製文本，如圖所示（查看如何複製文本：英文 中文）：
   
   請確保複製一整行，複製多餘的空格也無所謂，包括 " 符號和 %command% 部分。
   您複製的文本大概長這樣： "StardewModdingAPI.exe文件的路径" %command% 。
3. 在Steam客戶端中，右鍵點擊Stardew Valley並選擇屬性:
   
   
   
4. 在通用 中點擊啟動選項 下面的文本框:
   
   
   
5. 用從安裝程序複製的文本替換此文本框內的所有內容。
   （若要粘貼文本，請在框中單擊並按CTRL和V，當然你也可以右鍵後點粘貼）
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. 在記事本窗口中點擊「文件」選項卡，然後點擊「另存為…」選項。
   
   
   
3. 在保存時先定位到您的遊戲文件位置，然後將保存類型從「文本文檔」切換為「所有文件」，如下圖所示。
   
   
   
4. 然後在「文件名」的文本框中將該文件命名為 start.bat ，如下圖所示。
   
   
   
5. 打開GOG Galaxy客戶端，選擇遊戲Stardew Valley ，然後點擊在「開始遊戲」右側的選項圖標，依次選擇安裝管理 > 設置 ，如下圖所示。
   
   
   
6. 在彈出窗口中勾選自定義可執行文件/參數 選項，如下圖所示。
   
   
   
7. 然後點擊「添加另一個可執行文件/參數」選項，如下圖所示。
   
   
   
8. 接着選擇到之前保存 start.bat 文件的路徑並選中這個文件，然後點擊打開 按鈕，如下圖所示。
   
   
   
9. 最後，選中「文件2」最下面的默認可執行文件 選項，然後點擊右下角的選定按鈕，如下圖所示。
   
   
   
10. 從現在開始，您便可以通過GOG Galaxy客戶端啟動SMAPI並顯示出它的控制台窗口了，同時正常啟動遊戲了！

疑難解答

"Oops, couldn't find the game automatically"

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

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

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

與SMAPI或Mods有關的問題

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

← 入門