Add mod documentation in seven languages

docs/ja.md

@@ -0,0 +1,64 @@
+# Test Defaults and Patches — プロパティパッチのテストフィクスチャ
+
+この MOD はコンテンツではありません。**テストフィクスチャ**です。`property_patches` テストが読み込む小さなプロパティパッチの集まりで、他の MOD のキャラクターやアイテムへのパッチが、ゲームが約束したとおりに合成されるかを確かめます。ゲームの一部になることはなく、プレイヤーが有効にすることも想定していません。
+
+## 何をパッチするか
+
+プロパティパッチは `patches/<kind>.json` というファイルです。各エントリーは `Id` でエンティティを指名し、追加・変更するプロパティを並べます。`Id` が `*` なら**ワイルドカード**で、その種類の全エンティティに届きます。フィクスチャには種類ごとに、対象指定のパッチとワイルドカードのパッチが1つずつあります：
+
+```json
+{
+  "Items": [
+    { "Id": "Marao", "TestPatched": 42, "TestDefault": 100 },
+    { "Id": "*", "TestDefault": -20, "TestGlobalPatch": 1 }
+  ]
+}
+```
+
+```json
+{
+  "Items": [
+    { "Id": "food/ration", "Durability": 99, "SpecialProp": true },
+    { "Id": "*", "Durability": 50, "GlobalItemProp": "patched" }
+  ]
+}
+```
+
+これらのパッチが確かめる規則：
+
+- **対象指定**のパッチはワイルドカードに勝つ：Marao の `TestDefault` は -20 ではなく 100 になる；
+- **ワイルドカード**は残りすべてのエンティティに届く：他のキャラクターの `TestDefault` は -20、すべてのアイテムの `Durability` は 50 になる；
+- 片方だけが設定するキーはすべて残る：Marao にはさらに `TestGlobalPatch` 1 が、レーションには `GlobalItemProp` がつく；
+- 対象指定のキーが他のエンティティに漏れることはない；
+- エンティティ自身の型付きフィールド（レーションの名前など）は合成を生き残る。
+
+## テストの実行
+
+```text
+godot --path . res://scenes/menu/launcher.tscn -- --with-mods=test_defaults_and_patches --itest=property_patches
+dotnet run --project tests/Cthangover.TestRunner -- --test property_patches
+```
+
+フィクスチャが読み込まれるのは、`--with-mods=` が名指しするからです。実際の実行での出力：
+
+```text
+[PASS] Marao: targeted value: TestPatched=42
+[PASS] Marao: targeted beats wildcard: TestDefault=100
+[PASS] Marao: wildcard-only key: TestGlobalPatch=1
+[PASS] werewolf_girl_1: wildcard value: TestDefault=-20
+[PASS] werewolf_girl_1: no targeted key
+[PASS] ration: targeted beats wildcard: Durability=99
+[PASS] ration: targeted-only key: SpecialProp=true
+[PASS] ration: wildcard-only key: GlobalItemProp=patched
+[PASS] ration: typed field survives the merge
+[PASS] wolf_meat: wildcard value: Durability=50
+[TEST_RESULT] name=property_patches passed=14 failed=0
+```
+
+テストは MOD の一部（`src/PropertyPatchesTest.cs`）で、`--itest=property_patches` のときだけ有効になります。
+
+## なぜゲームに入らないのか
+
+マニフェストには `"fixture": true` と書かれています。フィクスチャは `--all-mods` の対象にも、ゲームの MOD セットにも決して入りません。`--with-mods=` で名指しされたときだけ読み込まれるため、そのパッチが他のテストや本番に漏れることはありません。本物のゲームで有効にすれば、Cthangover の全キャラクターと全アイテムにテスト用のプロパティを足すことになります——ワイルドカードパッチはすべてに触れるからです。依存先はパッチ対象の Cthangover MOD です（`cthangover_game`、`cthangover_murakami`、`cooking`）。
+
+同じ MOD は、ツール系テストが書き込んでも安全な場所にもなっています：`tools_windows` テストはシーンエディターでここにシーンを作り、また削除します。