Add mod documentation in seven languages

docs/zh.md

@@ -0,0 +1,71 @@
+# UI — 所有游戏共用的界面
+
+UI 是所有游戏共用的界面层：右上角的工具栏、游戏内菜单、存档指示器、左上角的通知，以及背景画面和面板、按钮、列表的统一外观。它自己没有剧情，也不定规则。几乎所有其他模组都构建在它之上，所以每个游戏里都有它，大量模组也把它列为依赖。
+
+![Cthangover 中午时分的一幕：左上角是时钟，右上角是工具栏，右侧是场景选项。](assets/scene-hud.jpg)
+
+## 工具栏
+
+每个图标都会打开一个面板。按钮并非固定不变：游戏中的每个模组都会加上自己的按钮，因此没有物品系统的小说游戏不会有背包，而带 Scenario Studio 的游戏则多出一个图标。
+
+![Cthangover 的工具栏：工具、地图、背包、角色、招募者、技能、菜单（齿轮）和日志。](assets/toolbar.png)
+
+在 Cthangover 中，从左到右依次是：
+
+1. **工具** — 开发者工具菜单（仅当游戏包含编辑器时出现）。
+2. **地图** — 世界地图（Map Engine）。
+3. **背包** — 物品栏（Items）。
+4. **角色** — 队伍和角色（Characters）。
+5. **招募者** — 已招募的角色（Recruiting）。
+6. **技能** — 技能（Skills）。
+7. **菜单** — 下文介绍的游戏内菜单（本模组）。
+8. **日志** — 任务（Quests）。
+
+其他游戏显示的按钮不同：例如 RPG Plus 会多出**角色面板**。
+
+## 游戏内菜单
+
+齿轮图标打开菜单：**继续**、**保存**、**读取**、**设置**、**主菜单**和**退出**。在不允许存档的场景中，“保存”会变灰，如图所示。“读取”“保存”和“设置”打开的窗口与主菜单中相同。
+
+![场景上方的游戏内菜单：Menu, Resume, Save, Load, Settings, Main menu, Exit。](assets/game-menu.jpg)
+
+## 通知
+
+左上角会出现简短消息：日志新增条目、剧情给出的提示等。同屏最多显示四条，每条停留约十秒，其余依次排队。
+
+![时钟下方的通知：“看看四周。巷子里躺着什么东西。”——Cthangover 序章中的一条提示。](assets/notification.png)
+
+## 给模组作者
+
+**添加工具栏按钮及其面板**：在 manifest.json 里写一个 `ui` 条目。Items 就是这样添加背包的：
+
+```json
+"ui": [
+  {
+    "id": "inventory",
+    "kind": "panel",
+    "slot": "ModBeforeUIPanel",
+    "scene_path": "scenes/ui/inventory_panel.tscn",
+    "button": { "icon": "bag", "locale": "ui/inventory/title", "index": 20 },
+    "priority": 10
+  }
+]
+```
+
+- `button.index` 决定图标顺序（地图 10、背包 20、角色 30、技能 40、菜单 50、日志 60、工作室 90）；
+- `button.icon` 是图标名，`button.locale` 是提示文字的翻译键；
+- 不带 `button` 的条目是游戏自行打开的面板或覆盖层：Crafting 以 `"kind": "overlay"` 把工作台放进 `ModLastPanel` 槽位，并从剧本中打开它。
+
+**从剧本打开面板**用 `ui.toggle_panel` 动作，**显示通知**用 `notify` 命令：
+
+```scenario
+notify "新的日志条目。"
+```
+
+**使用统一外观。** 用代码构建的面板会从组件库（`UiKit`）及其颜色、尺寸令牌中获取边框、文字、标签和按钮，因此新面板自然融入游戏整体风格并跟随主题变化。
+
+## 出现问题时
+
+1. **工具栏上少了按钮。** 添加它的模组不属于当前游戏；请在**模组与合集**中查看游戏的构成。
+2. **“保存”是灰色的。** 当前场景不允许存档；换到别的地方再试。作者在场景任一剧本的头部写上 `save_allowed: true` 即可允许存档。
+3. **面板打开了却是空的。** 对应模组在当前游戏中暂时没有内容可显示——例如还没有任务开始。