Add mod documentation in seven languages

docs/ja.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/` フォルダーに入る kind `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` と違います。ログには未知のクエストの警告が出ます。