Add mod documentation in seven languages

docs/zh.md

@@ -0,0 +1,91 @@
+# Town Pack — 城镇、住宅与酒吧背景及酒吧环境音
+
+Town Pack 是为小镇故事准备的现成布景：三张绘制好的背景图——城镇入口的街角、住宅门厅和夜晚的酒吧——外加酒吧的环境音循环。它不含剧情、场景或角色：图在哪里出现，由游戏自己决定。
+
+两个内置游戏已经在共用它。**Cthangover** 使用城镇入口和门厅；**My Novel** 模板则把三张背景和酒吧环境音全用上了。由于两个游戏取用的是这个模组里的同一批文件，Town Pack 里的一处修正或一张更好的图，两边都能受益。
+
+## 里面有什么
+
+城镇入口 `town/town_entry`：铺着石板的街角，商店遮阳篷条纹相间。
+
+![城镇入口背景：石板路街角的一栋转角建筑，带着绿色和白色的遮阳篷。](assets/town_entry.jpg)
+
+住宅门厅 `home/vestibule`：带楼梯、扶手椅和挂画的门厅。
+
+![门厅背景：暖光笼罩的门厅里有木质楼梯、扶手椅、长凳和一幅装框的画。](assets/vestibule.jpg)
+
+酒吧 `bar/bar`：挂着灯笼的桌台、吧台和一排排酒瓶。
+
+![酒吧背景：灯笼照亮的桌台、吧台，以及横梁天花板下的酒架。](assets/bar.jpg)
+
+酒吧环境音 `bar/bar_ambient`：供 Ambience 声音通道使用的酒吧氛围 Ogg Vorbis 循环。
+
+三张图都是 1920 × 1024。每张图都有一个同名、带 `_depth` 后缀的灰色伴生文件：
+
+![城镇入口的深度图：同一构图的灰度版本。](assets/town_entry_depth.jpg)
+
+深度图不会直接展示给你看。显示背景时，游戏会同时加载 `<name>_depth` 并交给光照系统，供放置在场景上的光源使用。没有深度图的背景也能正常显示。
+
+## 在哪里能看到它
+
+- **Cthangover：** `town_entry` 场景（城镇入口）和 `home_vestibule` 场景。
+- **My Novel 模板：** `my_novel_town`、`my_novel_home` 和 `my_novel_bar`。酒吧场景还会播放 `bar/bar_ambient`。
+
+同一段城镇入口，在 My Novel 模板里伴着一段叙述为游戏开场：
+
+![My Novel 的第一个场景：城镇入口背景上显示一行「傍晚的小镇。路灯已经亮起，一阵凉风沿着石板路吹过」。](assets/reuse-my-novel.jpg)
+
+而在 Cthangover 里，同一个画面上，另一个故事给出了自己的选项：
+
+![Cthangover 的城镇入口：同一背景，选项为「回家」和「查看小巷」。](assets/reuse-cthangover.jpg)
+
+Town Pack 属于两个游戏的合集，会随它们一起加载。仅安装它并不会把这些地点加进别的游戏：游戏必须在自己的场景里使用这些背景。
+
+## 在你的游戏中使用这些背景
+
+1. 把 `town_pack>=1` 加入内容模组的 `depends` 列表。
+2. 把 `town_pack>=1` 加入游戏的合集，就像 My Novel 模板在 **Assets** 块中做的那样。
+3. 按下文的名称引用资源。名称相对于 `backgrounds/` 和 `sounds/`，不带扩展名。
+
+```jsonc
+// mods/my_game/manifest.json — 添加到已有列表
+"depends": ["town_pack>=1"]
+```
+
+下面这段取自模板的 `my_novel_bar` 场景，展示酒吧并播放环境音：
+
+```json
+{
+  "name": "my_bar",
+  "defaultBackground": "bar/bar",
+  "defaultAmbient": "bar/bar_ambient"
+}
+```
+
+剧本也可以在对话中途切换画面：
+
+```scenario
+background town/town_entry
+text "这个点，街上一个人影也没有。"
+```
+
+可用的名称如下：
+
+```text
+town/town_entry     backgrounds/town/town_entry.png
+home/vestibule      backgrounds/home/vestibule.png
+bar/bar             backgrounds/bar/bar.png
+bar/bar_ambient     sounds/bar/bar_ambient.ogg
+```
+
+## 为你的游戏替换图片
+
+想替换图片又不想改动 Town Pack，可以在自己的模组里放一个相对名称相同的文件（例如 `backgrounds/bar/bar.png`），并在 `depends` 里声明 `town_pack>=1`。依赖所有者的模组后加载、优先生效。替换背景时，还要附带一个同名的 `_depth` 文件：否则游戏仍会找到 Town Pack 原来的深度图，光照就会按旧图的构图分布。
+
+没有依赖声明时，两个提供同名资源的模组加载顺序不确定；资源图谱工具会把这种情况报为错误。
+
+## 如果有东西没显示
+
+1. 背景变黑或缺失，多半是名称写错了。名称区分大小写，使用 `/`。
+2. 确认 Town Pack 被包含在所启动的游戏里，而不只是安装了。
+3. 酒吧没有声音：检查场景的 `defaultAmbient` 是否为 `bar/bar_ambient`，并确认 **Settings → Sound**（设置 → 声音）里 **Ambience** 已开启。声音播放由 Audio Engine 模组提供。