Add mod documentation in seven languages

.gitignore

@@ -0,0 +1,38 @@
+# Godot 4.x
+.godot/
+.idea/
+sdk/
+bin/
+obj/
+
+#ai
+.omo/
+.opencode/
+
+gen/
+obj/
+bin/
+art_sources/
+
+*.tres~
+*.tscn~
+
+# GDScript LSP
+.godot/
+
+# Export
+*.exe
+*.dmg
+*.apk
+*.aab
+*.pck
+*.zip
+*.log
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Editor
+*.import
+*.godot.uid

docs/en.md

@@ -0,0 +1,42 @@
+# Items Editor — editing a mod's items in a form
+
+The Items Editor edits the items of a mod while the game runs: names and descriptions in every language of the mod, price, picture, item types and the action used from the bag. **Save** writes the mod's files and the game shows the change at once — no restart, no reload.
+
+It opens from the tool box (the hammer on the toolbar) as **Items**.
+
+## An edit and its result in the game
+
+In RPG Plus the bag holds the village shop's elixir:
+
+![The inventory with the Elixir selected: Targeted, price 10.](assets/bag-before.jpg)
+
+In the editor: choose the mod `rpg_demo_game` at the top, pick **Elixir** in the list, type a new English name and press **Save** (Ctrl+S):
+
+![The Items window on rpg_demo_game: the list Brushwood, Stones, Forest mushroom and Dawn elixir; the form of rpg_demo/elixir with the name key rpg_demo/item/elixir/name, text (en) Dawn elixir and the other six languages unchanged, the description in seven languages, Price 10, Icon rpg_demo/healing_elixir with its picture, Types TargetUsed, Action action/heal. The status line: "Saved: 0 file(s), 1 text(s) in mod rpg_demo_game; the game re-read its data".](assets/editor-saved.jpg)
+
+Only the English line of the mod's `locale/en.properties` changed; the item file was not touched. The same elixir in the bag right after:
+
+![The inventory now shows the item as Dawn elixir, still Targeted, price 10.](assets/bag-after.jpg)
+
+## The form
+
+- **Id** — the item's id; scenarios, shops, maps and other mods find it by this id.
+- **Name** and **Description** — the translation key and a line per language of the mod. A new item gets keys made from its id; the texts go into the mod's locale files.
+- **Price** — in coins (shops can set their own prices).
+- **Icon** — a picture of the items group; **…** opens a grid to pick one.
+- **Types** — Quest, Used, TargetUsed, Food, Resource, Recipe, CantDrop; several can be on.
+- **Action** — what using the item does: `null` or one of the item actions the loaded mods register (`action/heal`, `action/equip`…).
+- **Fields of other mods** — fields that other mods describe in their schemas for items (for example Equipment's equip type, traits and allowed classes) appear in their own section with the same kind of editors.
+- **Other fields** — everything else in the item's JSON, shown and edited as JSON; it is kept as it is.
+
+The toolbar: **New** (Ctrl+N) adds `<mod>/new_item` — a resource worth one coin with no action; **Copy** (Ctrl+D), **Delete**, **Undo**/**Redo** (Ctrl+Z / Ctrl+Y). Save writes only the files whose text changed; a new item goes to `items/<mod>.json`.
+
+## Which items can be edited
+
+The list shows the items of one mod — those in its own files. Only mods installed as folders are in the mod list. To change another mod's item without editing that mod, ship the same id in your mod and declare a dependency on the owner; the Items Editor itself edits the files of the selected mod only.
+
+## If something goes wrong
+
+1. **The mod list is empty.** No mod can be written to; packed mods cannot be edited.
+2. **The bag still shows the old name.** The item was saved in another language than the game's; check the line of the game's language.
+3. **The action list lacks an action.** The mod that registers it is not loaded in this game.

docs/es.md

@@ -0,0 +1,42 @@
+# Items Editor — edita los objetos de un mod en un formulario
+
+El Items Editor edita los objetos de un mod mientras el juego está en marcha: nombres y descripciones en todos los idiomas del mod, precio, imagen, tipos de objeto y la acción al usarlos desde el inventario. **Guardar** escribe los archivos del mod y el juego muestra el cambio al instante — sin reiniciar ni recargar.
+
+Se abre desde la caja de herramientas (el martillo de la barra) como **Objetos**.
+
+## Una edición y su resultado en el juego
+
+En RPG Plus el inventario guarda el elixir de la tienda de la aldea:
+
+![El inventario con Elixir seleccionado: Targeted, precio 10.](assets/bag-before.jpg)
+
+En el editor: elige el mod `rpg_demo_game` arriba, selecciona **Elixir** en la lista, escribe un nombre nuevo en inglés y pulsa **Guardar** (Ctrl+S):
+
+![La ventana Objetos sobre rpg_demo_game: la lista Leña, Piedras, Seta del bosque y Dawn elixir; el formulario de rpg_demo/elixir con la clave del nombre rpg_demo/item/elixir/name, texto (en) Dawn elixir y los otros seis idiomas sin cambios, la descripción en siete idiomas, Price 10, Icon rpg_demo/healing_elixir con su imagen, Types TargetUsed, Action action/heal. La línea de estado: «Guardado: 0 archivo(s), 1 texto(s) en el mod rpg_demo_game; el juego releyó sus datos».](assets/editor-saved.jpg)
+
+Solo cambió la línea en inglés del `locale/en.properties` del mod; el archivo del objeto no se tocó. El mismo elixir en el inventario justo después:
+
+![El inventario muestra ahora el objeto como Dawn elixir, sigue Targeted, precio 10.](assets/bag-after.jpg)
+
+## El formulario
+
+- **Id** — el id del objeto; por él lo encuentran escenarios, tiendas, mapas y otros mods.
+- **Name** y **Description** — la clave de traducción y una línea por idioma del mod. Un objeto nuevo recibe claves hechas a partir de su id; los textos van a los archivos de localización del mod.
+- **Price** — en monedas (las tiendas pueden poner sus propios precios).
+- **Icon** — una imagen del grupo de objetos; **…** abre una cuadrícula para elegir una.
+- **Types** — Quest, Used, TargetUsed, Food, Resource, Recipe, CantDrop; puede haber varios activados.
+- **Action** — qué hace usar el objeto: `null` o una de las acciones de objeto que registran los mods cargados (`action/heal`, `action/equip`…).
+- **Campos de otros mods** — los campos que otros mods describen en sus esquemas para los objetos (por ejemplo el tipo de equipo, los rasgos y las clases permitidas de Equipment) aparecen en su propia sección con el mismo tipo de editores.
+- **Otros campos** — todo lo demás del JSON del objeto, mostrado y editado como JSON; se conserva tal cual.
+
+La barra: **Nueva** (Ctrl+N) añade `<mod>/new_item` — un recurso que vale una moneda y sin acción; **Copia** (Ctrl+D), **Borrar**, **Deshacer**/**Rehacer** (Ctrl+Z / Ctrl+Y). Guardar escribe solo los archivos cuyo texto cambió; un objeto nuevo va a `items/<mod>.json`.
+
+## Qué objetos se pueden editar
+
+La lista muestra los objetos de un mod — los que están en sus propios archivos. En la lista de mods solo están los instalados como carpetas. Para cambiar el objeto de otro mod sin editarlo, incluye el mismo id en tu mod y declara dependencia del dueño; el propio Items Editor edita solo los archivos del mod seleccionado.
+
+## Si algo sale mal
+
+1. **La lista de mods está vacía.** No hay ningún mod en el que escribir; los mods empaquetados no se pueden editar.
+2. **El inventario sigue mostrando el nombre viejo.** El objeto se guardó en otro idioma distinto al del juego; revisa la línea del idioma del juego.
+3. **Falta una acción en la lista de acciones.** El mod que la registra no está cargado en este juego.

docs/ja.md

@@ -0,0 +1,42 @@
+# Items Editor — フォームで MOD のアイテムを編集する
+
+Items Editor は、ゲームの実行中に MOD のアイテムを編集します: MOD の各言語での名前と説明、価格、画像、アイテムの種類、インベントリから使うときのアクション。**保存**は MOD のファイルを書き込み、ゲームは変更をすぐに表示します——再起動も再読み込みも不要です。
+
+ツールボックス（ツールバーのハンマー）から**アイテム**として開きます。
+
+## 編集と、ゲームの中での結果
+
+RPG Plus のインベントリには村の店のエリクサーがあります:
+
+![エリクサーを選んだインベントリ: Targeted、価格 10。](assets/bag-before.jpg)
+
+エディターでは: 上で MOD `rpg_demo_game` を選び、一覧から**エリクサー**を選び、新しい英語名を入力して**保存**（Ctrl+S）を押します:
+
+![rpg_demo_game の「アイテム」ウィンドウ: 一覧は柴、石、森のキノコ、Dawn elixir。rpg_demo/elixir のフォーム、名前キー rpg_demo/item/elixir/name、テキスト (en) Dawn elixir、ほかの六言語は変更なし、説明は七言語、価格 10、アイコン rpg_demo/healing_elixir とその画像、種類 TargetUsed、アクション action/heal。ステータス行:「保存しました: MOD rpg_demo_game のファイル 0、テキスト 1。ゲームはデータを読み直しました」。](assets/editor-saved.jpg)
+
+変わったのは MOD の `locale/en.properties` の英語の行だけです。アイテムのファイルには触れていません。直後のインベントリの同じエリクサー:
+
+![インベントリはこのアイテムを Dawn elixir と表示します。変わらず Targeted、価格 10。](assets/bag-after.jpg)
+
+## フォーム
+
+- **Id** — アイテムの id。シナリオ、ショップ、マップ、他の MOD がこれでアイテムを見つけます。
+- **名前**と**説明** — 翻訳キーと、MOD の言語ごとの行。新しいアイテムには id から作ったキーが付き、テキストは MOD のローカライズファイルに入ります。
+- **価格** — コイン単位（ショップは独自の価格を設定できます）。
+- **アイコン** — アイテムグループの画像。**…** で選ぶためのグリッドが開きます。
+- **種類** — Quest、Used、TargetUsed、Food、Resource、Recipe、CantDrop。複数付けられます。
+- **アクション** — アイテムを使うと何が起こるか: `null` か、読み込まれた MOD が登録するアイテムアクションの一つ（`action/heal`、`action/equip`…）。
+- **他の MOD のフィールド** — 他の MOD がスキーマでアイテムに付けるフィールド（たとえば Equipment の装備タイプ、特性、装備できるクラス）は、同じ種類のエディターとともに専用セクションに現れます。
+- **その他のフィールド** — アイテムの JSON の残り全部。JSON のまま表示・編集され、そのまま保たれます。
+
+ツールバー: **新規**（Ctrl+N）は `<mod>/new_item`——アクションなし、価値 1 コインのリソース——を追加します。**コピー**（Ctrl+D）、**削除**、**元に戻す**/**やり直す**（Ctrl+Z / Ctrl+Y）。保存はテキストが変わったファイルだけを書き込み、新しいアイテムは `items/<mod>.json` に入ります。
+
+## どのアイテムを編集できるか
+
+一覧に現れるのは一つの MOD のアイテム——その MOD 自身のファイルにあるものです。MOD の一覧には、フォルダーとしてインストールされた MOD だけが並びます。その MOD を編集せずに別 MOD のアイテムを変えるには、自分の MOD で同じ id を配り、所有者への依存関係を宣言します。Items Editor 自体は選んだ MOD のファイルだけを編集します。
+
+## うまくいかないとき
+
+1. **MOD の一覧が空。** 書き込める MOD がありません。パッケージ済みの MOD は編集できません。
+2. **インベントリに古い名前が出る。** アイテムがゲームの言語とは別の言語で保存されました。ゲームの言語の行を確認してください。
+3. **アクションの一覧にアクションがない。** それを登録する MOD がこのゲームに読み込まれていません。

docs/ko.md

@@ -0,0 +1,42 @@
+# Items Editor — 양식으로 모드의 아이템 편집하기
+
+Items Editor는 게임이 실행되는 동안 모드의 아이템을 편집합니다: 모드의 모든 언어로 된 이름과 설명, 가격, 그림, 아이템 유형, 인벤토리에서 쓸 때의 동작. **저장**은 모드의 파일을 기록하고 게임은 변경을 곧바로 보여 줍니다 — 재시작도 다시 불러오기도 없이.
+
+도구 상자(도구 모음의 망치)에서 **아이템**으로 열립니다.
+
+## 편집 하나와 게임 속 결과
+
+RPG Plus의 인벤토리에는 마을 상점의 엘릭서가 있습니다:
+
+![엘릭서를 고른 인벤토리: Targeted, 가격 10.](assets/bag-before.jpg)
+
+에디터에서는: 위에서 모드 `rpg_demo_game`을 고르고, 목록에서 **엘릭서**를 고르고, 새 영어 이름을 입력한 뒤 **저장**(Ctrl+S)을 누릅니다:
+
+![rpg_demo_game의 "아이템" 창: 목록에는 땔감, 돌, 숲 버섯, Dawn elixir. rpg_demo/elixir의 양식, 이름 키 rpg_demo/item/elixir/name, 텍스트 (en) Dawn elixir, 나머지 여섯 언어는 그대로, 일곱 언어의 설명, 가격 10, 아이콘 rpg_demo/healing_elixir와 그 그림, 유형 TargetUsed, 동작 action/heal. 상태 줄: "저장함: 모드 rpg_demo_game의 파일 0개, 텍스트 1개. 게임이 데이터를 다시 읽었습니다".](assets/editor-saved.jpg)
+
+바뀐 것은 모드 `locale/en.properties`의 영어 한 줄뿐입니다. 아이템 파일은 그대로입니다. 바로 뒤의 인벤토리 속 같은 엘릭서:
+
+![인벤토리는 이제 이 아이템을 Dawn elixir로 보여 줍니다. 여전히 Targeted, 가격 10.](assets/bag-after.jpg)
+
+## 양식
+
+- **Id** — 아이템의 id. 시나리오, 상점, 맵, 다른 모드가 이것으로 아이템을 찾습니다.
+- **이름**과 **설명** — 번역 키와 모드의 언어별 줄. 새 아이템은 id에서 만든 키를 받고, 텍스트는 모드의 로컬라이즈 파일로 갑니다.
+- **가격** — 코인 단위(상점은 자기 가격을 정할 수 있습니다).
+- **아이콘** — 아이템 그룹의 그림. **…**를 누르면 고르는 격자가 열립니다.
+- **유형** — Quest, Used, TargetUsed, Food, Resource, Recipe, CantDrop. 여러 개를 켤 수 있습니다.
+- **동작** — 아이템을 쓰면 무엇이 일어나는가: `null`이거나 불러온 모드가 등록한 아이템 동작 중 하나(`action/heal`, `action/equip`…).
+- **다른 모드의 필드** — 다른 모드가 스키마에서 아이템에 붙인 필드(예: Equipment의 장비 유형, 특성, 착용 가능 클래스)는 같은 종류의 편집기와 함께 별도 구역에 나타납니다.
+- **기타 필드** — 아이템 JSON의 나머지 전부. JSON으로 보이고 편집되며, 그대로 유지됩니다.
+
+도구 모음: **새로 만들기**(Ctrl+N)는 `<mod>/new_item` — 동작 없는, 가치 1코인짜리 자원 — 을 더합니다. **복사**(Ctrl+D), **삭제**, **되돌리기**/**다시 실행**(Ctrl+Z / Ctrl+Y). 저장은 텍스트가 바뀐 파일만 기록하고, 새 아이템은 `items/<mod>.json`으로 갑니다.
+
+## 어떤 아이템을 편집할 수 있는가
+
+목록에는 한 모드의 아이템 — 그 모드 자신의 파일에 있는 것들 — 이 보입니다. 모드 목록에는 폴더로 설치된 모드만 있습니다. 그 모드를 고치지 않고 남의 아이템을 바꾸려면, 자기 모드에 같은 id를 실고 소유자에 대한 의존성을 선언하세요. Items Editor 자체는 선택한 모드의 파일만 편집합니다.
+
+## 문제가 생겼을 때
+
+1. **모드 목록이 비어 있습니다.** 쓸 수 있는 모드가 없습니다. 압축된 모드는 편집할 수 없습니다.
+2. **인벤토리에 아직 옛 이름이 보입니다.** 아이템이 게임 언어가 아닌 다른 언어로 저장되었습니다. 게임 언어의 줄을 확인하세요.
+3. **동작 목록에 동작이 없습니다.** 그것을 등록하는 모드가 이 게임에 불러와지지 않았습니다.

docs/ru.md

@@ -0,0 +1,42 @@
+# Items Editor — правка предметов мода в форме
+
+Items Editor правит предметы мода, пока игра работает: названия и описания на всех языках мода, цену, картинку, типы предмета и действие при использовании из инвентаря. **Сохранить** записывает файлы мода, и игра показывает изменение сразу — без перезапуска и перезагрузки.
+
+Открывается из набора инструментов (молоток на панели инструментов) как **Предметы**.
+
+## Правка и её результат в игре
+
+В RPG Plus в инвентаре лежит эликсир из деревенской лавки:
+
+![Инвентарь с выбранным Эликсиром: Targeted, цена 10.](assets/bag-before.jpg)
+
+В редакторе: выберите мод `rpg_demo_game` сверху, укажите **Эликсир** в списке, введите новое английское название и нажмите **Сохранить** (Ctrl+S):
+
+![Окно «Предметы» на rpg_demo_game: в списке Хворост, Камни, Лесной гриб и Dawn elixir; форма rpg_demo/elixir с ключом названия rpg_demo/item/elixir/name, текст (en) Dawn elixir и шесть остальных языков без изменений, описание на семи языках, Цена 10, Иконка rpg_demo/healing_elixir с её картинкой, Типы TargetUsed, Действие action/heal. Строка состояния: «Сохранено: файлов 0, текстов 1 в моде rpg_demo_game; игра перечитала данные».](assets/editor-saved.jpg)
+
+Изменилась только английская строка в `locale/en.properties` мода; файл предмета не тронут. Тот же эликсир в инвентаре сразу после:
+
+![Инвентарь показывает предмет как Dawn elixir, по-прежнему Targeted, цена 10.](assets/bag-after.jpg)
+
+## Форма
+
+- **Id** — id предмета; по нему находят его сценарии, магазины, карты и другие моды.
+- **Название** и **Описание** — ключ перевода и строка на каждый язык мода. Новый предмет получает ключи, составленные из его id; тексты уходят в файлы локализации мода.
+- **Цена** — в монетах (магазины могут ставить свои цены).
+- **Иконка** — картинка из группы предметов; **…** открывает сетку для выбора.
+- **Типы** — Quest, Used, TargetUsed, Food, Resource, Recipe, CantDrop; можно включить несколько.
+- **Действие** — что делает использование предмета: `null` или одно из действий предмета, которые регистрируют загруженные моды (`action/heal`, `action/equip`…).
+- **Поля других модов** — поля, которые другие моды описывают в своих схемах для предметов (например, тип экипировки, черты и доступные классы из Equipment), появляются отдельной секцией с такими же редакторами.
+- **Прочие поля** — всё остальное из JSON предмета, показывается и правится как JSON; сохраняется как есть.
+
+Панель инструментов: **Новый** (Ctrl+N) добавляет `<mod>/new_item` — ресурс ценой в одну монету без действия; **Копия** (Ctrl+D), **Удалить**, **Отменить**/**Повторить** (Ctrl+Z / Ctrl+Y). Сохранение пишет только файлы, где изменился текст; новый предмет попадает в `items/<mod>.json`.
+
+## Какие предметы можно править
+
+В списке — предметы одного мода, те, что лежат в его собственных файлах. В списке модов — только моды, установленные папками. Чтобы изменить предмет чужого мода, не трогая его, дайте в своём моде тот же id и объявите зависимость от владельца; сам Items Editor правит файлы только выбранного мода.
+
+## Если что-то пошло не так
+
+1. **Список модов пуст.** Ни в один мод нельзя писать; упакованные моды не редактируются.
+2. **В инвентаре всё ещё старое название.** Предмет сохранён на другом языке, а не на языке игры; проверьте строку языка игры.
+3. **В списке действий нет действия.** Мод, который его регистрирует, в эту игру не загружен.

docs/vi.md

@@ -0,0 +1,42 @@
+# Items Editor — sửa vật phẩm của mod bằng biểu mẫu
+
+Items Editor sửa các vật phẩm của một mod khi game đang chạy: tên và mô tả bằng mọi ngôn ngữ của mod, giá, hình ảnh, loại vật phẩm và hành động khi dùng từ túi đồ. **Lưu** ghi các tệp của mod và game hiện thay đổi ngay — không cần khởi động lại, không cần tải lại.
+
+Nó mở từ hộp công cụ (chiếc búa trên thanh công cụ) dưới tên **Vật phẩm**.
+
+## Một chỉnh sửa và kết quả trong game
+
+Trong RPG Plus, túi đồ có thuốc tiên của cửa hàng trong làng:
+
+![Túi đồ với Thuốc tiên được chọn: Targeted, giá 10.](assets/bag-before.jpg)
+
+Trong trình sửa: chọn mod `rpg_demo_game` ở trên, chọn **Thuốc tiên** trong danh sách, gõ một tên tiếng Anh mới rồi nhấn **Lưu** (Ctrl+S):
+
+![Cửa sổ Vật phẩm trên rpg_demo_game: danh sách Củi khô, Đá, Nấm rừng và Dawn elixir; biểu mẫu của rpg_demo/elixir với khóa tên rpg_demo/item/elixir/name, văn bản (en) Dawn elixir và sáu ngôn ngữ còn lại giữ nguyên, mô tả bằng bảy ngôn ngữ, Giá 10, Biểu tượng rpg_demo/healing_elixir cùng hình của nó, Kiểu TargetUsed, Hành động action/heal. Dòng trạng thái: "Đã lưu: 0 tệp, 1 văn bản trong mod rpg_demo_game; game đã đọc lại dữ liệu".](assets/editor-saved.jpg)
+
+Chỉ dòng tiếng Anh trong `locale/en.properties` của mod thay đổi; tệp vật phẩm không bị đụng tới. Cùng chai thuốc tiên trong túi đồ ngay sau đó:
+
+![Túi đồ giờ hiện vật phẩm là Dawn elixir, vẫn Targeted, giá 10.](assets/bag-after.jpg)
+
+## Biểu mẫu
+
+- **Id** — id của vật phẩm; kịch bản, cửa hàng, bản đồ và mod khác tìm nó qua id này.
+- **Tên** và **Mô tả** — khóa dịch và một dòng cho mỗi ngôn ngữ của mod. Vật phẩm mới nhận các khóa tạo từ id của nó; văn bản được ghi vào tệp bản địa hóa của mod.
+- **Giá** — tính bằng đồng xu (cửa hàng có thể tự đặt giá).
+- **Biểu tượng** — một hình trong nhóm vật phẩm; **…** mở lưới để chọn.
+- **Kiểu** — Quest, Used, TargetUsed, Food, Resource, Recipe, CantDrop; có thể bật nhiều cái.
+- **Hành động** — dùng vật phẩm thì chuyện gì xảy ra: `null` hoặc một trong các hành động vật phẩm mà các mod đã tải đăng ký (`action/heal`, `action/equip`…).
+- **Trường của mod khác** — những trường mà mod khác mô tả trong lược đồ của họ cho vật phẩm (ví dụ kiểu trang bị, đặc tính và lớp được phép của Equipment) hiện trong mục riêng với cùng loại trình sửa.
+- **Các trường khác** — mọi thứ còn lại trong JSON của vật phẩm, hiện và sửa dưới dạng JSON; được giữ nguyên như cũ.
+
+Thanh công cụ: **Mới** (Ctrl+N) thêm `<mod>/new_item` — một tài nguyên giá một đồng xu, không có hành động; **Sao chép** (Ctrl+D), **Xóa**, **Hoàn tác**/**Làm lại** (Ctrl+Z / Ctrl+Y). Lưu chỉ ghi những tệp có văn bản thay đổi; vật phẩm mới vào `items/<mod>.json`.
+
+## Những vật phẩm nào được sửa
+
+Danh sách hiện các vật phẩm của một mod — những vật phẩm trong tệp của chính mod đó. Danh sách mod chỉ có các mod cài dưới dạng thư mục. Muốn đổi vật phẩm của mod khác mà không sửa mod đó, hãy mang cùng id trong mod của bạn và khai báo phụ thuộc vào chủ sở hữu; chính Items Editor chỉ sửa tệp của mod được chọn.
+
+## Khi có trục trặc
+
+1. **Danh sách mod trống.** Không có mod nào ghi được; mod đóng gói không sửa được.
+2. **Túi đồ vẫn hiện tên cũ.** Vật phẩm được lưu bằng ngôn ngữ khác ngôn ngữ của game; hãy kiểm tra dòng của ngôn ngữ game.
+3. **Danh sách hành động thiếu một hành động.** Mod đăng ký nó chưa được tải trong game này.

docs/zh.md

@@ -0,0 +1,42 @@
+# Items Editor — 用表单编辑模组的物品
+
+Items Editor 在游戏运行时编辑模组的物品：各种语言的名称和描述、价格、图片、物品类型，以及从背包使用时的动作。**保存**会写入模组的文件，游戏立刻显示变化——无需重启，无需重新加载。
+
+它从工具箱（工具栏上的锤子）打开，叫**物品**。
+
+## 一次编辑及其在游戏中的结果
+
+RPG Plus 的背包里有村里商店卖的药水：
+
+![背包中选中药剂：Targeted，价格 10。](assets/bag-before.jpg)
+
+在编辑器里：顶部选择模组 `rpg_demo_game`，在列表中选**药剂**，输入新的英文名称，按**保存**（Ctrl+S）：
+
+![rpg_demo_game 上的「物品」窗口：列表中有 柴火、石头、森林蘑菇 和 Dawn elixir；rpg_demo/elixir 的表单，名称键为 rpg_demo/item/elixir/name，文本 (en) Dawn elixir，其余六种语言未变，描述有七种语言，价格 10，图标 rpg_demo/healing_elixir 及其图片，类型 TargetUsed，动作 action/heal。状态行：「已保存：模组 rpg_demo_game 中 0 个文件、1 条文本；游戏已重新读取数据」。](assets/editor-saved.jpg)
+
+只有模组 `locale/en.properties` 的英文一行变了；物品文件没有动。紧接着背包里的同一瓶药水：
+
+![背包现在把该物品显示为 Dawn elixir，仍是 Targeted，价格 10。](assets/bag-after.jpg)
+
+## 表单
+
+- **Id** —— 物品的 id；剧本、商店、地图和其他模组都靠它找到物品。
+- **名称**和**描述** —— 翻译键和模组每种语言的一行文字。新物品会得到由 id 组成的键；文字写入模组的本地化文件。
+- **价格** —— 以金币计（商店可以自己定价）。
+- **图标** —— 物品组的一张图片；**…** 打开网格挑选。
+- **类型** —— Quest、Used、TargetUsed、Food、Resource、Recipe、CantDrop；可以同时勾选多个。
+- **动作** —— 使用物品时做什么：`null` 或已加载模组注册的某个物品动作（`action/heal`、`action/equip`…）。
+- **其他模组的字段** —— 其他模组在各自模式中为物品描述的字段（例如 Equipment 的装备类型、特性和可用职业），会在单独区域以同样的编辑器出现。
+- **其他字段** —— 物品 JSON 里的其余内容，按 JSON 显示和编辑；原样保留。
+
+工具栏：**新建**（Ctrl+N）添加 `<mod>/new_item`——一个价值一枚金币、没有动作的资源；**复制**（Ctrl+D）、**删除**、**撤销**/**重做**（Ctrl+Z / Ctrl+Y）。保存只写文字有变化的文件；新物品进入 `items/<mod>.json`。
+
+## 哪些物品可以编辑
+
+列表显示一个模组的物品——即它自己文件里的那些。模组列表里只有以文件夹安装的模组。想不改那个模组就改它的物品，可以在你的模组里带上相同的 id 并声明对属主的依赖；Items Editor 本身只编辑所选模组的文件。
+
+## 出问题了怎么办
+
+1. **模组列表是空的。** 没有可写的模组；打包模组不能编辑。
+2. **背包里还是旧名字。** 物品保存所用语言与游戏语言不同；检查游戏语言那一行。
+3. **动作列表里缺一个动作。** 注册它的模组没有在这个游戏里加载。

locale/ui_en.properties

@@ -1,5 +1,5 @@
-mod_items_editor_name = Item Editor
-mod_items_editor_desc = Editor of the game's items: a searchable list with pictures, name and description in every language of the mod, price, icon, types and the use action; a save shows in the game at once.
+mod_items_editor_name = Items Editor
+mod_items_editor_desc = Edits a mod's items while the game runs: names and descriptions in every language, price, picture, types and the use action. The game shows a save at once.
 tools/items_editor/title = Items
 tools/items_editor/name = Name
 tools/items_editor/description = Description

locale/ui_es.properties

@@ -1,5 +1,5 @@
 mod_items_editor_name = Editor de objetos
-mod_items_editor_desc = Editor de los objetos del juego: una lista con búsqueda e imágenes, nombre y descripción en cada idioma del mod, precio, icono, tipos y la acción de uso; al guardar se ve en el juego al momento.
+mod_items_editor_desc = Edita los objetos de un mod con el juego en marcha: nombres y descripciones en todos los idiomas, precio, imagen, tipos y la acción de uso. El juego muestra el guardado al instante.
 tools/items_editor/title = Objetos
 tools/items_editor/name = Nombre
 tools/items_editor/description = Descripción

locale/ui_ja.properties

@@ -1,5 +1,5 @@
 mod_items_editor_name = アイテムエディター
-mod_items_editor_desc = ゲームのアイテムのエディター：検索と画像付きの一覧、MOD の各言語での名前と説明、価格、アイコン、種類、使用時のアクション。保存するとすぐにゲームに反映されます。
+mod_items_editor_desc = ゲームの実行中に MOD のアイテムを編集します: 各言語の名前と説明、価格、画像、種類、使用時のアクション。保存するとゲームはすぐに反映します。
 tools/items_editor/title = アイテム
 tools/items_editor/name = 名前
 tools/items_editor/description = 説明

locale/ui_ko.properties

@@ -1,5 +1,5 @@
 mod_items_editor_name = 아이템 에디터
-mod_items_editor_desc = 게임 아이템 에디터: 검색과 그림이 있는 목록, 모드의 모든 언어로 된 이름과 설명, 가격, 아이콘, 유형, 사용 액션. 저장하면 게임에 바로 보입니다.
+mod_items_editor_desc = 게임이 실행되는 동안 모드의 아이템을 편집합니다: 모든 언어의 이름과 설명, 가격, 그림, 유형, 사용 동작. 저장하면 게임에 곧바로 나타납니다.
 tools/items_editor/title = 아이템
 tools/items_editor/name = 이름
 tools/items_editor/description = 설명

locale/ui_ru.properties

@@ -1,5 +1,5 @@
 mod_items_editor_name = Редактор предметов
-mod_items_editor_desc = Редактор предметов игры: список с поиском и картинками, название и описание на всех языках мода, цена, иконка, типы и действие при использовании; сохранение сразу видно в игре.
+mod_items_editor_desc = Правит предметы мода прямо во время игры: названия и описания на всех языках, цена, картинка, типы и действие при использовании. Сохранение игра показывает сразу.
 tools/items_editor/title = Предметы
 tools/items_editor/name = Название
 tools/items_editor/description = Описание

locale/ui_vi.properties

@@ -1,5 +1,5 @@
 mod_items_editor_name = Trình sửa vật phẩm
-mod_items_editor_desc = Trình sửa vật phẩm của game: danh sách có tìm kiếm và hình ảnh, tên và mô tả bằng mọi ngôn ngữ của mod, giá, biểu tượng, loại và hành động khi dùng; lưu xong là thấy ngay trong game.
+mod_items_editor_desc = Sửa các vật phẩm của mod khi game đang chạy: tên và mô tả bằng mọi ngôn ngữ, giá, hình ảnh, loại và hành động khi dùng. Game hiển thị thay đổi ngay khi lưu.
 tools/items_editor/title = Vật phẩm
 tools/items_editor/name = Tên
 tools/items_editor/description = Mô tả

locale/ui_zh.properties

@@ -1,5 +1,5 @@
 mod_items_editor_name = 物品编辑器
-mod_items_editor_desc = 游戏物品的编辑器：带搜索和图片的列表，模组每种语言的名称和描述，价格、图标、类型和使用动作；保存后游戏中立即可见。
+mod_items_editor_desc = 在游戏运行时编辑模组的物品：各语言的名称和描述、价格、图片、类型和使用动作。保存后游戏立刻显示变化。
 tools/items_editor/title = 物品
 tools/items_editor/name = 名称
 tools/items_editor/description = 描述

manifest.json

@@ -1,9 +1,9 @@
 {
   "id": "items_editor",
-  "name": "Item Editor",
+  "name": "Items Editor",
   "version": "1.0.0",
   "author": "ct",
-  "description": "Editor of the game's items (items_base, \"Kind\": \"item\") in the style of the other editor windows: the items of a writable mod in a searchable list with their pictures, a form with the name and the description in every language of the mod, price, picture picked from the items folders, item types and the use action; fields of other mods stay editable as JSON. New items, copies, deletion, undo, and a save the running game sees at once. Opens from the main menu tools and the in-game toolbar.",
+  "description": "Edits a mod's items while the game runs: names and descriptions in every language, price, picture, types and the use action. The game shows a save at once.",
   "category": "tools, editor",
   "sources": [
     "src/**/*.cs"