Add mod documentation in seven languages

docs/zh.md

@@ -0,0 +1,123 @@
+# My Novel — 你自己的视觉小说起点
+
+My Novel 是项目中最小的完整视觉小说：傍晚的小镇、一家酒吧和一处住宅，由选项连接起来。它没有角色、物品和战斗——只有场景、简短的剧本文件和它们的翻译。它生来就是供人复制的：改个名字，然后从这三个地点生长出你自己的故事。
+
+从“开始游戏 → My Novel → 新游戏”进入。它是 **My Novel** 游戏（合集 `novel_template`）的内容。
+
+![My Novel 中的酒吧：酒吧背景和一行文本“酒吧里温暖又喧闹，但今晚在这里没什么可做的。”.](assets/bar.jpg)
+
+## 里面有什么
+
+```filestree
+my_novel_game/
+├── manifest.json
+├── scenes/
+│   ├── my_novel_town.json      城镇入口，游戏从这里开始
+│   ├── my_novel_bar.json       酒吧，带自己的环境音
+│   └── my_novel_home.json      住宅门厅
+├── scenarios/
+│   ├── my_novel_town.scenario
+│   ├── my_novel_bar.scenario
+│   └── my_novel_home.scenario
+└── locale/
+    ├── en.properties           模组名称和描述
+    └── scenarios_<lang>.properties   剧本各行的翻译
+```
+
+图片和酒吧的环境音都不在这个模组里：它们来自 **Town Pack**，这样模板才保持小巧，也示范了游戏如何复用共享内容。音乐来自 **Music Pack**；引擎模组是 2D 外壳、对话引擎和音频引擎。
+
+## 故事的流向
+
+小镇是枢纽。每次到访都显示同样的选择；酒吧和住宅各自通向返回的路。
+
+```text
+            ┌────────────────────┐
+            │   my_novel_town    │  （起点）
+            │     “去哪儿？”      │
+            └──┬──────────────┬──┘
+       走进酒吧              回家
+               ▼              ▼
+     ┌──────────────┐  ┌──────────────┐
+     │ my_novel_bar │  │ my_novel_home│
+     └──────┬───────┘  └──────┬───────┘
+            └─ 回到小镇 ─┘
+```
+
+![My Novel 的城镇入口，也就是第一幕，配文“傍晚的小镇。路灯已经亮起，一阵凉风沿着石板路吹过。”.](assets/town.jpg)
+
+场景文件写明背景和环境音：
+
+```json
+{
+  "name": "my_novel_bar",
+  "defaultBackground": "bar/bar",
+  "defaultAmbient": "bar/bar_ambient"
+}
+```
+
+与场景同名的剧本会在进入该场景时运行：
+
+```scenario
+scene: my_novel_town
+priority: 10
+---
+# The town is the hub: every visit shows the same choice.
+text "Evening town. The street lamps are already lit and a cool draught runs along the cobbles." key=my_novel/town/intro
+select "Where to go?" key=my_novel/town/prompt
+option "Go into the bar" key=my_novel/town/opt_bar -> :bar
+option "Go back home" key=my_novel/town/opt_home -> :home
+
+:bar
+switch_scene my_novel_bar
+end
+
+:home
+switch_scene my_novel_home
+end
+```
+
+英文文本直接写在剧本里。每个 `key=` 指向该行在 `locale/scenarios_<lang>.properties` 中的翻译，比如西班牙语：
+
+```properties
+my_novel/town/intro = La ciudad al anochecer. Las farolas ya están encendidas y una corriente fresca recorre los adoquines.
+```
+
+## 把它变成你的
+
+1. **复制并重命名模组。** 用你的游戏名加 `_game` 后缀命名，例如 `harbor_game`。把文件夹名和 `manifest.json` 里的 `id` 改成同一个值，并把 `locale/*.properties` 中的键 `mod_my_novel_game_name` / `_desc` 改成 `mod_harbor_game_name` / `_desc`。
+2. **为它建一个游戏。** 在 **Mods & Collections → 合集** 中打开 My Novel 的结构并按 **复制**，然后在“故事”分组里把 `my_novel_game` 换成你的模组。入口场景在合集中设置（`"entry": { "scene": "my_novel_town" }`）。
+3. **按需重命名场景：** 场景的 `name`、它的文件、其剧本的 `scene:` 头以及每一个通向它的 `switch_scene` 都必须一致。
+4. **保留或替换美术。** 想保留小镇，就把 `town_pack` 留在 `depends` 里；或者添加自己的 `backgrounds/` 和 `sounds/`，并让 `defaultBackground` / `defaultAmbient` 指向它们。
+
+## 第一处修改：添加一个地点
+
+这是一次真实的编辑器操作，在 My Novel 里加入 Editor Tools 模组后进行。场景编辑器创建了 `my_novel_park` 场景，再在小镇剧本里敲入一个选项和一个标签：
+
+![打开 my_novel_town.scenario 的剧本编辑器：新增一行 `option "Go to the park" -> :park` 和一个新块 `:park / switch_scene my_novel_park / end`；状态栏显示文件已保存。](assets/edit-town-scenario.jpg)
+
+```scenario
+option "Go to the park" -> :park
+
+:park
+switch_scene my_novel_park
+end
+```
+
+保存之后，小镇立刻给出新的去路，选择它就会打开新场景：
+
+![小镇的选择现在有三个选项：走进酒吧、Go to the park、回家。](assets/new-choice.jpg)
+
+想在自己的游戏里用上编辑器，可以在结构中加入 **Editor Tools** 模组，或者带着它们启动一次游戏：
+
+```text
+godot --path . -- --game=novel_template --new --with-mods=editor_tools
+```
+
+没有 `key=` 的新行在任何语言下都显示字面文本；等故事准备好翻译时，再加键和译文。
+
+## 如果不奏效
+
+1. **某个选择哪儿也到不了。** `switch_scene` 的名字必须等于目标场景的 `name`，大小写也要一致。
+2. **某个场景没有文本。** 它剧本的 `scene:` 头必须写这个场景的名字。
+3. **别的语言下文本是英文。** 这一行没有 `key=`，或者该语言的 `scenarios_<lang>.properties` 里缺这个键。
+4. **背景全黑。** 背景名字拼错了，或者拥有这张图的模组不在 `depends` 里。