Add mod documentation in seven languages

docs/ja.md

@@ -0,0 +1,84 @@
+# Characters Engine — キャラクター、そのアクション、パーティ
+
+Characters Engine は、誰が戦闘に参加するかを定義します。主人公・仲間・敵に、HP・攻撃・防御・アクションポイント、そして使えるアクションカードを持たせるものです。さらに**キャラクターアクション**パネルを表示します。ここでパーティを見ながら、どのカードを各キャラクターが戦闘に持っていくか決めます。会話の台詞のそばに出るポートレートも、この mod が供給します。
+
+Cthangover と RPG Plus の一部であり、戦闘 mod、recruiting、各エディターがこの上に作られています。
+
+## キャラクターアクションパネル
+
+ツールバーのカード・アイコンで開きます。
+
+![Cthangover のキャラクターアクションパネル: HP・AP・ATK・DEF を持つ Marao と Murakami、目標・コスト・値つきのアクションカード（基本攻撃、防御、スタン）、それぞれの空いた三つ目のスロット、右側の空のアクションプール。](assets/character-panel.jpg)
+
+- **パーティ** — パーティの全キャラクターを、ポートレート・HP（体力）・ターンごとの AP（アクションポイント）・ATK（攻撃）・DEF（防御）つきで一覧にします。
+- **スロット** — 各キャラクターにはアクションカード用のスロットが三つあります。カードには目標（敵・味方・自分）、AP コスト、値が表示されます。
+- **アクションプール** — 持っているけれどまだ割り当てていないカード。カードをスロットへドラッグするか、カードを選んでからスロットを選びます。スロット間のドラッグは入れ替えになります。検索とフィルターでプールを絞り込めます。
+- **リセット** は、各キャラクターの定義の先頭三つのアクションをスロットへ戻します。残りはプールへ移ります。
+
+## 三つの異なる絵
+
+キャラクターは三つの姿で現れ、それぞれ別の場所から来ます。
+
+![左: Marao の会話ポートレート（アバター「marao/sad」）。中央: カードに映る Marao のキャラクター画像。右: RPG Plus の主人公のマップスプライト（charset）で、これは別のシステムのもの。](assets/three-pictures.jpg)
+
+1. **会話ポートレート（アバター）** — mod の `avatars/` フォルダーに入る画像で、シナリオの行ごとに選びます。`text "…" first=marao/sad` が一つ目のポートレート位置を、`second=…` が二つ目（二人の会話）を埋めます。キャラクターの定義とは結びついていません。
+2. **キャラクター画像** — 定義の `Image`。このパネルのカードと戦闘で表示されます。
+3. **マップスプライト（charset）** — タイルマップを歩くスプライト。選ぶのは RPG mod（ゲームの**外見**設定かイベントの `Sprite`）で、この mod ではありません。
+
+## キャラクターの定義
+
+キャラクターは、mod の `characters/` フォルダーに入る kind `character` の JSON ファイルです。こちらは Cthangover の Marao。上のパネルのカードと見比べてください。
+
+```json
+{
+  "Kind": "character",
+  "Items": [
+    {
+      "Id": "Marao",
+      "Name": "characters/player/marao",
+      "Image": "characters/player/marao",
+      "Level": 1,
+      "Point": 1,
+      "Health": 16,
+      "Defence": 0,
+      "Attack": 5,
+      "Actions": ["physics/attack", "physics/defence"]
+    }
+  ]
+}
+```
+
+`Health 16` がカードの **HP 16/16**、`Point 1` が **AP 1**、`Attack 5` が **ATK 5** で、二つの `Actions` がスロットの**基本攻撃**と**防御**のカードです。
+
+その他のフィールド: `Behaviour`（敵の戦闘 AI。例は `base`）、`Exp`（倒したときの経験値）、`RecruitmentChance`、そして `Loot` — キャラクターを倒したときに落ちる `ItemId`・`MinCount`・`MaxCount`・`Probability` の一覧です。
+
+## アクションカード
+
+アクションは kind `action` の JSON ファイルです。この mod は基本的な物理アクション — **基本攻撃**・**防御**・**スタン** — を同梱しています。
+
+```json
+{
+  "Id": "physics/attack",
+  "Name": "characters/action/physics_attack/name",
+  "Description": "characters/action/physics_attack/description",
+  "Image": "characters/actions/physics_attack",
+  "Type": "ToEnemy",
+  "Values": ["RequiredPoint=1", "Attack=1.0", "AttackType=Physics"]
+}
+```
+
+`Type` が目標（敵・味方・自分）を決め、パッシブかアクティブかも定めます。`RequiredPoint` は AP コストです。ほかの値が戦闘で何をするかは、使われている戦闘 mod が決めます。
+
+## シナリオからパーティにキャラクターを加える
+
+```scenario
+action party.add id=rpg_hero
+```
+
+キャラクターはパーティと戦闘メンバーに入ります。すでに名簿にいる者はレベルと HP を保ちます。RPG Demo はこの行で、村に初めて入ったときに主人公をプレイヤーに渡します。
+
+## うまく動かないとき
+
+1. **キャラクターが名前ではなく id を表示する。** `Name` は翻訳キーです。mod の `locale` ファイルに追加してください。
+2. **台詞のそばにポートレートがない。** `first=` / `second=` の後のアバター名が、いずれかの mod の `avatars/` フォルダーにある画像と一致する必要があります。例は `marao/sad` に対する `avatars/marao/sad.png`。
+3. **カードが戦闘で使えない。** キャラクターの AP がカードの `RequiredPoint` に足りていません。