Add mod documentation in seven languages

docs/zh.md

@@ -0,0 +1,81 @@
+# Quests Engine — 任务、任务步骤与日志
+
+Quests Engine 替玩家记账。每个任务都有名称和编号的步骤列表；剧本负责开启任务、推进到下一步、打上标记并完成任务。**日志**面板显示玩家已领取的任务，游戏会保存它们的状态。
+
+Cthangover（序章的苏醒和旧宅）与 RPG Plus（森林任务）都用到了它。
+
+## 日志
+
+用工具栏上的日志图标打开。玩家还没领取任何任务时，日志是空的：
+
+![RPG Plus 开局时的日志：「进行中」和「已完成」两个页签，两页都写着「暂无任务」。](assets/journal-before.jpg)
+
+在 RPG Plus 里，村庄的长老给出第一个任务。向他问问去哪里找：
+
+![长老的家：主角站在长老面前，右侧有两个选项——「狼会熄灯吗？」和「去哪儿找它？」。](assets/elder-choice.jpg)
+
+回答之后，任务就出现在日志里：
+
+![对话后的日志：「账簿上的一盏灯」出现在进行中列表；右侧是「第 II 条，共 V 条」，第一步已划掉，当前步骤为「击退东部森林洞窟旁的狼。找到琥珀之心」。](assets/journal-after.jpg)
+
+- **进行中**列出正在做的任务，**已完成**列出做完的。还没开始的任务永远不会出现。
+- 右页显示选中的任务：已完成的步骤划掉，当前步骤做了标记，后续步骤保持隐藏——日志不会剧透后面的故事。
+- 任务获得的标记会以小小的金色标签显示在条目下方。
+
+## 任务的定义
+
+任务是 mod 的 `quests/` 文件夹里类型为 `quest` 的 JSON 文件。这就是截图中的任务（来自 RPG Plus）：
+
+```json
+{
+  "Kind": "quest",
+  "Items": [
+    {
+      "Id": "woodland_ward",
+      "Name": "rpg_plus/quest/ward/name",
+      "StatusToDescription": {
+        "0": "rpg_plus/quest/ward/0",
+        "1": "rpg_plus/quest/ward/1",
+        "2": "rpg_plus/quest/ward/2",
+        "3": "rpg_plus/quest/ward/3",
+        "4": "rpg_plus/quest/ward/4"
+      }
+    }
+  ]
+}
+```
+
+`Name` 和每个步骤都是翻译键。数字就是任务的**步骤**：在第 1 步时，`1` 的文本显示为当前步骤，`0` 则划掉——即截图中的「第 II 条，共 V 条」。
+
+## 从剧本推进任务
+
+RPG Plus 中长老的回答会开启任务并把它放到第 1 步：
+
+```scenario
+action quest.set_status quest_id=woodland_ward status=Progress
+action quest.set_data_status quest_id=woodland_ward level=1
+```
+
+- `quest.set_status` — 任务的状态：`NotStarted`、`Progress`（进行中）或 `End`（已完成）。
+- `quest.set_data_status` — 当前步骤，`level` 是它的编号。
+- `quest.add_tag` / `quest.remove_tag` 配合 `tag=…` — 记下发生过的事，比如玩家先拿了哪个物品。
+- `quest.send_notification` — 向玩家弹出任务通知；改变任务本身不会触发通知。
+
+## 检查任务
+
+凡是游戏接受条件的地方都能用任务检查：`when`、选项条件、场景条件和地图事件。
+
+```scenario
+when "woodland_ward.DataStatus >= 2" -> :lantern
+```
+
+- `<quest>.IsActive` — 任务正在进行；
+- `<quest>.Status` — `0` 未开始，`1` 进行中，`2` 已完成；
+- `<quest>.DataStatus` — 当前步骤；
+- `<quest>.hasTag("tag")`、`<quest>.notHasTag("tag")` — Cthangover 用它们决定场景播放哪段剧本，例如 `AwakeningQuest.hasTag("book_taken")`。
+
+## 出问题时
+
+1. **任务不在日志里。** 它的状态必须是 `Progress`（或在「已完成」页签显示则用 `End`）；只设置步骤是不够的。
+2. **日志显示的是键而不是文本。** 把步骤的键加进 mod 的 `locale` 文件。
+3. **条件永远为假。** 写的任务 id 与任务文件里的 `Id` 不一致；日志会警告存在未知任务。