MOD パッケージ：インストールと作り方

MOD パッケージは 1 つのフォルダー、またはそれを圧縮した 1 つの .srw64mod ファイルです。中身はデータだけで、プログラムは含みません。有効なパッケージがあると、ゲームはその内容で元の対応する部分を置き換えます。パッケージが何も指定していないところは、すべて元のままです。

反映されるのは音楽と戦闘ボイス、数値、名前、顔グラフィック、マップアイコン、追加シナリオ、シナリオのイベント、言語パッケージです。曲の差し替え、キャラクターやユニットごとの戦闘曲の指定、戦闘台詞のボイス（音楽 MOD）、ユニット・パイロット・武器の数値（数値 MOD）、名前の変更と顔グラフィック・マップアイコンの差し替え（名前・顔グラフィック・マップアイコン MOD）、原作のステージへのイベント追加・人物の加入・シナリオ分岐の変更（シナリオ MOD）、自分で組んだステージをつなぐキャンペーン（追加シナリオ MOD）、表示言語の追加や既存の言語の文字の差し替え（言語パッケージ MOD）ができます。その他のグラフィックは順次対応する予定で、パッケージの形式にはすでにその場所が用意されています。

MOD 機能にはバージョン 0.5.1 以降が必要です。音楽と地形適応以外は 0.5.2 以降、シナリオ MOD と言語パッケージは 0.5.3 以降、Switch 版は 0.5.3.1 以降が必要です。

インストール

MOD 管理を開きます。タイトル画面右下の「MOD」をクリックするか、設定を開いて「一般」ページの「MOD」をクリックします。
.srw64mod ファイル（.zip やパッケージのフォルダーでも可）をゲームのウィンドウにドラッグします。バックグラウンドでインストールされ、画面上部に通知が出て「インストール済み」ページが開きます。
「フォルダーを開く」で MOD フォルダーを開き、パッケージのファイルを直接置くこともできます。次に MOD 管理を開いたときに自動でインストールされます。0.5.4 以降（Switch 版は 0.5.3.1 以降）は、パッケージファイルを展開したフォルダーをそのまま置いてもかまいません（フォルダー名は変えなくて大丈夫です）。

同じパッケージの新しいバージョンをインストールすると、古いバージョンと置き換わります。古いバージョンや削除したパッケージは、すぐには消さず MOD フォルダー内の .trash に移します。

Android 版では、「ファイル」アプリの Marchwind64 フォルダー内 mods/ にパッケージファイルを置くと、ゲームの起動時か MOD ページを開いたときにインストールされます。MOD ページの「ファイルからインストール」で選ぶこともできます。

Android 版で MOD をインストール：設定 › 一般 › MOD を開き、「ファイルからインストール」で選ぶか、Documents/Marchwind64/mods に置く

Switch 版では、カードリーダーか FTP でパッケージファイル（または展開したフォルダー）を SD カードの /switch/Marchwind64/mods/ に置くと、ゲームの起動時か MOD ページを開いたときにインストールされます。大きなボイスパックは起動画面に進み具合が表示され、数分かかることがあります。

管理

「インストール済み」ページには、各パッケージの名前・バージョン・作者・内容・状態が並びます。有効・無効の切り替えと削除（確認のため 2 回押します）ができます。

一覧で上にあるパッケージが下のものより優先されます。2 つのパッケージが同じ曲を差し替えている場合は、上のほうが使われます。
別のパッケージに依存するパッケージは、自動でその上に並びます。依存先がない・バージョンが足りない・無効になっている場合は理由が表示され、そのパッケージは有効になりません。
より新しいゲームのバージョンが必要な場合も表示されます。

パッケージを作る

音楽パッケージをいちばん簡単に作るには、公式サイトの 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": { "ja": "戦闘曲を差し替えます。" },
  "authors": ["yourname"],
  "license": "CC-BY-4.0"
}

フィールド	意味
`schema`	常に `srw64.mod.v1`
`id`	パッケージ固有の名前。英数字と `.` `_` `-` で 64 文字まで。「作者.名前」の形がおすすめです。公開後は変えないでください
`version`	バージョン。`1.0.0` の形式で書きます
`name`	表示する名前。1 つの文字列でも、言語ごと（`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

著作権

パッケージに入れるものは、すべて再配布する権利があるものにしてください。原作アニメの楽曲などで作ったパッケージは個人利用に限り、公開しないでください。そうしたパッケージは公式にも掲載しません。