Add mod documentation in seven languages

docs/ja.md

@@ -0,0 +1,87 @@
+# Music Pack — あなたのゲームのためのサウンドトラック
+
+探索・戦闘・メインメニューのための**22曲**。音声を物語 MOD ごとにコピーせずに、cthangover の複数のゲームでサウンドトラックを共用できます。
+
+![3つの音楽の場面：探索、戦闘、メインメニュー](assets/playlists.png)
+
+## プレイヤーに聞こえるもの
+
+- **探索：** 専用プレイリストを持たないシーン（RPG マップを含む）のための8曲。
+- **戦闘：** プレイリスト `Battle` の12曲。予備の戦闘プレイリスト `default` には `Empty Save Room` も含まれ、計13曲になります。
+- **メインメニュー：** `Serpent's Lament`。
+
+> Music Pack が提供するのは音声とプレイリストです。ロケーション・クエスト・ゲームプレイの仕組みは追加しません。
+
+## 何か設定は必要か
+
+ゲームがすでに Music Pack を使っていれば、曲を個別にインストールしたり選んだりする必要はありません。再生は `audio_base` システムが担います。
+
+このパックは、メインメニュー、Cthangover、ノベルテンプレート、プロジェクトの RPG ゲームが使っています。メインゲームの物語コンテンツを必要としません。
+
+## 自分のゲームで使う
+
+1. `music_pack` とその依存関係 `audio_base` をインストールします。
+2. 自分のコンテンツ MOD の `manifest.json` にある既存の `depends` リストに `music_pack>=1` を追加します。
+3. 付属のプレイリストを使うか、独自の選曲なら自分の MOD の `music/playlists/` ディレクトリに JSON ファイルを追加します。
+
+依存関係の例：
+
+```jsonc
+// 既存のリストに依存関係を追加します：
+"depends": ["music_pack>=1"]
+```
+
+独自プレイリストの置き場所の例：
+
+```filestree
+my_game/
+├── manifest.json
+└── music/
+    └── playlists/
+        └── my_scene.json  # あなたのシーンの音楽
+```
+
+シーン `my_scene` 用のプレイリストの例：
+
+```json
+{
+  "Scene": "my_scene",
+  "Musics": [
+    {
+      "MusicType": "Ambient",
+      "MusicNames": ["Airborne Melody", "Twilight Interlude"]
+    }
+  ]
+}
+```
+
+曲名は **`.ogg` 拡張子を付けず**、大文字小文字とスペースをそのままに書きます。`my_scene` は自分のシーン名に置き換えてください。
+
+## 収録プレイリスト
+
+- `default` — 探索音楽（`Ambient`）と予備の戦闘音楽（`Combat`）。
+- `Battle` — 両方のバトルシステム向けの戦闘音楽。
+- `MainMenu` — メインメニューのテーマ。
+
+プレイリスト `town_entry` は物語 MOD `cthangover_game` の側にあり、このパックには含まれません。
+
+## 全22曲
+
+### 探索
+
+Abyssal Void · Airborne Melody · Binary Prelude · Cinders of Dawn · Melancholic Journey · Nebula Pulse Echoes · Quantum Archive · Twilight Interlude.
+
+### 戦闘と予備の戦闘リスト
+
+Aura of Decay · Circuit Dreams II · Crimson Echoes · Crimson Horizon · Empty Save Room · Glass Symphony · Hex Doom Cart · Iron Resonance · Iron Resonance II · Luminous Twilight · Rusty Frequencies · Skull Resonance · Venom's Embrace.
+
+### メインメニュー
+
+Serpent's Lament.
+
+## 音が鳴らないとき
+
+- `music_pack` と `audio_base` がインストールされ、有効になっているか確認してください。
+- ゲーム設定の音楽音量を確認してください。
+- 特定のシーンだけの問題なら、そのシーン専用のプレイリストと曲名の正確なつづりを確認してください。
+- 後から読み込まれた依存 MOD は、同じシーンと同じ音楽の種類について選曲を差し替えられます。