RimWorld Mod 上傳教學：SteamCMD 與遊戲內管理器

在《RimWorld》製作完成一個 Mod 後，想要分享給其他玩家，就需要將它上傳到 Steam Workshop。本文將介紹兩種上傳方法，分別是透過 SteamCMD 以及 RimWorld 遊戲內建的 Mod 管理器，讓你能依照需求選擇最適合的方式。

上傳方法一：使用 SteamCMD

SteamCMD 是 Valve 官方提供的命令列工具，可用於管理與上傳 Steam Workshop 的內容，適合需要自動化或批次上傳的開發者。相比遊戲內管理器，SteamCMD 能夠更靈活地控制上傳流程，並能整合到 CI/CD 自動化管線中。

下載與安裝 SteamCMD

1. 前往官方網站下載工具：
   SteamCMD 官方下載頁面

2. 將下載的壓縮檔解壓縮到任意資料夾，例如：

   C:\steamcmd\

3. 執行 steamcmd.exe 以進行初次更新，完成後即可使用。

上傳流程詳細步驟

1. 登入 Steam 帳號
   在命令列中輸入：

   steamcmd.exe login <你的Steam帳號>

   若有啟用 Steam Guard，系統會提示輸入驗證碼。

2. 撰寫上傳設定檔 (.vdf)
   建立一個 .vdf 檔案，例如 mod_upload.vdf，內容如下：

   "workshopitem"
   {
       "appid"      "294100"                     // RimWorld 的 Steam AppID
       "publishedfileid"  "1234567890"          // 首次上傳可留空，更新時填入已有 ID
       "contentfolder"    "C:\RimWorld\Mods\MyMod"   // Mod 主資料夾
       "previewfile"      "C:\RimWorld\Mods\MyMod\About\Preview.png" // 封面圖片
       "title"            "我的模組"
       "description"      "這是模組描述，可支援換行和簡單文字格式。"
       "changenote"       "首次上傳版本。"
   }

   小技巧：建議將設定檔放在版本控制系統 (如 Git) 中管理，以便更新時直接修改 changenote，快速重新上傳。

3. 執行上傳指令
   使用以下命令上傳：

   workshop_build_item C:\steamcmd\mod_upload.vdf

   系統將會：

   • 驗證檔案內容與設定檔
   • 將 Mod 壓縮後上傳至 Steam Workshop
   • 返回一個 publishedfileid（若為首次上傳），請妥善保存，方便未來更新使用。

4. 更新現有 Mod

   • 將 publishedfileid 填入 .vdf 檔案
   • 修改 changenote 紀錄更新內容
   • 再次執行 workshop_build_item 指令

5. 常見錯誤排查

   • ERROR! Access Denied：確認帳號已購買 RimWorld 並擁有上傳權限。
   • ERROR! Timeout：檢查網路連線，或稍後重試。
   • 檔案大小限制：Steam Workshop 單一檔案大小限制約 2GB，請確保 Mod 不超過限制。
   • Preview.png：不得大於1MB

mod_upload.bat 快速上傳批次檔

<steamcmd.exe路徑> +login <使用者名稱> <密碼> +workshop_build_item <mod.vdf路徑> +quit

上傳方法二：使用 RimWorld Mod 管理器

如果你偏好圖形介面，可以直接透過遊戲內的 Mod 管理器 上傳。

注意事項

• 首次上傳時，請確保 About 資料夾內 沒有 PublishedFileId.txt，否則上傳按鈕不會出現。
• 必須開啟遊戲內建的開發者模式
• 完成首次上傳後，遊戲會自動產生 PublishedFileId.txt，之後的更新就能直接覆蓋到同一個 Workshop 項目。

操作步驟

1. 啟動 RimWorld。

2. 開啟開發者模式

   

3. 進入 主選單 → Mod 管理器。

4. 在右下角找到 「上傳至 Steam Workshop」 按鈕。

   

5. 點擊上傳，等待完成即可。

   

   

   等待項目審核完成，大概等待 5~10 分鐘

   

結論

無論你是喜歡命令列工具的進階玩家，還是偏好圖形介面的創作者，都能找到合適的上傳方式：

• SteamCMD：適合自動化流程、頻繁更新或多人協作的專案。
• RimWorld Mod 管理器：適合手動操作、首次上傳或簡單更新。

建議首次上傳時可以用遊戲內管理器完成，之後若要維護多個模組或進行 CI/CD 自動化，就改用 SteamCMD，更有效率。