← 技術文件

MOD 包:安裝與製作

MOD 包是什麼、怎麼安裝和管理,以及自己做包時 mod.json 怎麼寫。能生效的有音樂和戰鬥語音、數值、名字、頭像、地圖圖示、追加劇本、劇情事件和語言包。

更新於 2026-11-04

MOD 包是一個資料夾,或者把它壓縮成的一個 .srw64mod 檔案,裡面只放資料,不放程式。遊戲讀到啟用的包,就用包裡的內容替換原版對應的部分;沒有包的地方一切照原版。

現在能生效的有音樂和戰鬥語音、數值、名字、頭像、地圖圖示、追加劇本、劇情事件和語言包:替換曲目、指定誰打仗時放哪首歌、給戰鬥臺詞配音,做法見音樂 MOD;改機體、駕駛員和武器的數值,見數值 MOD;改名字、換頭像和地圖圖示,見名字、頭像與地圖圖示 MOD;給原版關卡加事件、讓人物加入或改變劇情分支,見劇情 MOD;把幾關自己編排的關卡串成戰役,見追加劇本 MOD;增加新的閱讀語言或換掉現有語言的文字,見語言包 MOD。其他美術會陸續開放,包格式已經為它們留好了位置。

MOD 功能需要 0.5.1 或更新的版本;音樂和地形適應以外的部分需要 0.5.2,劇情 MOD 和語言包需要 0.5.3,Switch 版需要 0.5.3.1。

安裝

  1. 開啟 MOD 管理:點標題畫面右下角的「MOD」,或者開啟設定,在「通用」頁點「MOD」。
  2. 把 .srw64mod 檔案(.zip 或包資料夾也可以)拖進遊戲視窗,遊戲會在後臺安裝,裝好後在畫面上方提示,並開啟「已安裝」頁。
  3. 也可以點「開啟資料夾」,把包檔案直接放進 MOD 資料夾,下次開啟 MOD 管理時會自動安裝。從 0.5.4 起(Switch 版從 0.5.3.1 起),包檔案解壓出來的資料夾也可以直接放進去,資料夾名不用改。

同一個包裝新版本時會替換舊版本,舊版本和刪除的包都會移到 MOD 資料夾裡的 .trash,不會直接刪掉。

安卓版:把包檔案放進「檔案」裡 Marchwind64 資料夾的 mods/,遊戲啟動或開啟 MOD 頁時自動安裝;也可以在 MOD 頁點「從檔案安裝」直接選檔案。

安卓版安裝 MOD:設定 › 通用 › MOD,再點「從檔案安裝」選檔案,或把檔案放進 Documents/Marchwind64/mods

Switch 版:用讀卡器或 FTP 把包檔案(或解壓出來的資料夾)放進 SD 卡上的 /switch/Marchwind64/mods/,再啟動遊戲或開啟 MOD 頁就會安裝。裝大的語音包時,啟動畫面會顯示安裝進度,可能需要幾分鐘。

管理

「已安裝」頁列出每個包的名字、版本、作者、包含的內容和狀態,可以啟用、停用或刪除(刪除要按兩次確認)。

  • 列表上面的包覆蓋下面的:兩個包都替換了同一首歌時,用上面那個包的。
  • 一個包依賴另一個包時,會自動排在它上面;缺了依賴、版本不夠或者被停用,都會寫明原因,這個包暫時不啟用。
  • 包需要更新的遊戲版本時,也會寫明。

自己做一個包

做音樂包最簡單的辦法是官網的 BGM MOD 製作工具,它會生成下面這些檔案。想手工做,或者瞭解包裡有什麼,看這一節。

包裡有什麼

mod.json        包的資訊(必需)
audio/          音樂與語音
campaign/       追加劇本
art/            美術
dialogue/       臺詞與語言
data/           數值

只放用得到的目錄。發布時把整個資料夾壓縮成 zip,擴充名改成 .srw64mod;mod.json 放在壓縮包最外層,或者在唯一的一個頂層資料夾裡都可以。

mod.json

{
  "schema": "srw64.mod.v1",
  "id": "yourname.bgm",
  "version": "1.0.0",
  "name": { "zh-Hans": "我的 BGM", "en": "My BGM", "ja": "マイ BGM" },
  "description": { "zh-Hans": "替換了戰鬥曲。" },
  "authors": ["yourname"],
  "license": "CC-BY-4.0"
}
欄位 說明
schema 固定寫 srw64.mod.v1
id 包的唯一名字,只能用字母、數字和 . _ -,最多 64 個字元。建議寫成「作者.名字」,發布後不要再改
version 版本號,寫成 1.0.0 這樣的格式
name 顯示的名字,可以是一個字串,也可以按語言分別寫(zh-Hans、zh-Hant、en、ja,以及裝著的語言包的語言;繁體沒寫時用簡體,其他沒寫的語言依次找退回語言、日文)
description 可選,說明文字,寫法同 name
authors 可選,作者列表
license 許可證,必須是允許再分發的:CC-BY-4.0、CC-BY-SA-4.0、CC-BY-NC-4.0、CC-BY-NC-SA-4.0、CC0-1.0、MIT、GPL-3.0-or-later
game 可選,需要的遊戲版本,例如 ">=0.5.1"
requires 可選,必需的其他包,例如 { "someone.base": ">=1.0" }
optional 可選,有就一起用的包,寫法同 requires
conflicts 可選,不能同時啟用的包,例如 { "someone.old": "*" }

版本要求寫成 *(任意版本),或者用空格隔開的幾個條件,比如 ">=1.0 <2"。mod.json 裡不認識的欄位會被當成錯誤,不要自己加欄位。

檢查

原始碼倉庫裡的 tools/mods/validate.py 用和遊戲相同的規則檢查一個包,問題會逐條列出:

python3 tools/mods/validate.py yourname.bgm-1.0.0.srw64mod

版權

包裡的東西必須是你有權再分發的。用原作動畫歌曲之類的素材做的包只適合自己使用,不要公開分發;我們也不會收錄這類包。