發布或更新已完成的 TF3 模組

先準備完整 TF3 套件

本任務從模組製作及檢查完成後開始。保持其 mod.json, _metadata/modinfo.json 和 content 結構完整。技術欄位 modId 用來識別套件，不取決於資料夾名稱。更改 TF2 資料夾後綴不會轉換資源。

閱讀官方發布要求，只散布自己擁有或獲准分享的內容。使用獲准 Urban Games 資產時，遵守來源標示要求。本地套件可運行，仍須通過發布驗證。

發布已準備好的套件

1. 找到真正的使用者資料資料夾。 使用 Settings → Advanced → Open User Data Folder，再開啟其 staging_area。將完整套件複製至該處，不要取代遊戲安裝檔案。
2. 開啟 Main Menu → Mod Hub → My Mods。 選取暫存區的模組，檢查名稱、標籤、圖片、可見性與更新紀錄。
3. 選取 Upload。 遊戲會驗證套件。主機準備與核准取決於更嚴格的主機要求，桌面上傳成功不代表所有平台皆核准。
4. 檢查產生的 mod.io 項目。 上傳後會自動開啟。檢查 Files 中上傳版本與平台核准狀態，以及頁面的預期可見性。

更新既有發布而不建立重複項目

提高 revision ，其位於 mod.json。保留 _metadata/mod.io_fileid.txt，此檔案將套件連結至既有 mod.io 項目。若遺失，官方流程是使用頁面資訊框中的項目 ID 還原該檔案。

回到 My Mods 並選取套件。使用 Update 前，確認顯示訊息 The existing mod on mod.io will be updated。備份直接在 mod.io 修改的描述文字：本地的 modinfo.json 文字會在更新時覆寫它們。

模組定義手冊建議，不相容於前版的更新應使用新 mod ID 及獨立發布，避免破壞訂閱者存檔。資料夾名稱本身無法確認更新對象。

如何判斷修復成功

預期頁面包含預期版本、可見性正確，且所需平台檔案狀態已核准。更新時應檢查同一項目，不要把任何新頁面都當成功。向玩家推薦前，先在獨立測試世界檢查已發布套件的預期行為。

發布未完成時

• 找不到 My Mods： 檢查真正的使用者資料暫存目錄及套件結構。其他位置的訂閱下載不會自動成為作者暫存套件。
• 驗證失敗： 保留回報問題，並依連結要求修正套件。到達 Upload 不代表驗證通過。
• 更新對象無法識別： 再次上傳前，先確認記錄的項目 ID 與套件身分。
• 本地測試載入錯誤修訂： 文件優先順序是暫存區、手動安裝、訂閱模組。比對相同 modId 的副本；暫存副本可能遮蔽訂閱更新。