Add mod documentation in seven languages

docs/zh.md

@@ -0,0 +1,87 @@
+# Music Pack — 为你的游戏配乐
+
+**22 首曲目**，覆盖探索、战斗和主菜单。在 cthangover 的各个游戏之间共用这套配乐，无需把音频复制进每个剧情模组。
+
+![三种音乐情境：探索、战斗和主菜单](assets/playlists.png)
+
+## 玩家会听到什么
+
+- **探索：** 8 首曲目，供没有专属播放列表的场景使用，包括 RPG 地图。
+- **战斗：** `Battle` 播放列表中的 12 首曲目。备用战斗列表 `default` 还包含 `Empty Save Room`，合计 13 首。
+- **主菜单：** `Serpent's Lament`。
+
+> Music Pack 提供音频和播放列表，不添加地点、任务或玩法机制。
+
+## 需要配置什么吗
+
+如果你的游戏已经在用 Music Pack，就无需单独安装或挑选曲目。播放由 `audio_base` 系统负责。
+
+主菜单、Cthangover、小说模板和项目的 RPG 游戏都在使用这个素材包。加载它不需要主游戏的剧情内容。
+
+## 在自己的游戏中使用
+
+1. 安装 `music_pack` 及其依赖 `audio_base`。
+2. 在内容模组 `manifest.json` 已有的 `depends` 列表中加入 `music_pack>=1`。
+3. 直接使用自带的播放列表，或者想自定义选曲时，在你模组的 `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` 仍属于剧情模组 `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` 是否已安装并启用。
+- 检查游戏设置中的音乐音量。
+- 如果只有某个场景有问题，检查它自己的播放列表和确切的曲目名。
+- 后加载的依赖模组可以覆盖同一场景、同一音乐类型的选曲。