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,41 @@
+# Characters Editor — editing a mod's characters in a form
+
+The Characters Editor edits the characters of a mod while the game runs: the name in every language of the mod, the portrait, the walking sprite for RPG maps, the battle numbers, the recruit chance and the battle actions. **Save** writes the mod's files, and the game uses the change at once.
+
+It opens from the tool box (the hammer on the toolbar) as **Characters**.
+
+## An edit and its result in the game
+
+In RPG Plus, the hero of the village is the character `rpg_hero` of the mod `rpg_demo_game`. Choose that mod at the top, pick **Hero**, type a new English name and press **Save** (Ctrl+S):
+
+![The Characters window on rpg_demo_game: the list Aldric · rpg_hero, Slime · rpg_slime, Wolf · rpg_wolf; the form of rpg_hero with the name key rpg_demo/character/hero, text (en) Aldric and the other six languages unchanged, Portrait characters/village/hero with its picture, Charset (RPG) empty, Level 1, Health 24, Attack 6, Defence 0, Action points 1, Experience 0, Recruit chance 0. 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 party member on the character panel right after:
+
+![The Character actions panel: the party member is now called Aldric (rpg_hero, HP 42/42, AP 1, ATK 12, DEF 4) with Basic attack, Defence and Power strike.](assets/panel-after.jpg)
+
+The panel shows HP 42 and ATK 12 while the file says 24 and 6: in RPG Plus the hero's class and stats (Stats Engine with Classic RPG Rules) compute the battle numbers and write them over the file's values. In a game without stats the file's numbers are the ones used.
+
+## The form
+
+- **Id** — the character's id; scenarios, parties, battles and maps find it by this id.
+- **Name** — the translation key and a line per language of the mod.
+- **Portrait** — the picture on cards and panels; **…** opens a grid to pick one.
+- **Charset (RPG)** — the walking sprite on RPG maps (3 frames × 4 facings). The RPG Map Editor offers characters with their charset for placing.
+- **Level**, **Health**, **Attack**, **Defence**, **Action points**, **Experience** — the battle numbers of the character.
+- **Recruit chance** — 0 to 100: the chance to capture the character after beating it (see Recruiting).
+- **Behaviour** and **Actions** — how the character fights and which battle actions it has.
+- **Fields of other mods** — fields other mods describe for characters in their schemas (for example Stats Engine's class, stats and traits) appear in their own section.
+- **Other fields** — the rest of the character's JSON, edited as JSON and kept as it is.
+
+The toolbar: **New** (Ctrl+N), **Copy** (Ctrl+D), **Delete**, **Undo**/**Redo** (Ctrl+Z / Ctrl+Y), **Save** — only changed files are written; texts go into the mod's locale files.
+
+## Which characters can be edited
+
+The list holds the characters in the selected mod's own files; only mods installed as folders are offered. Characters of other mods are not in the list and their files are never written. To change one of them, ship the same id in your own mod with a dependency on the owner, or add fields with a patch.
+
+## If something goes wrong
+
+1. **Changed health or attack has no effect.** The game computes the numbers from stats, as RPG Plus does for its party.
+2. **The character is missing from the RPG Map Editor's Characters tab.** The tab lists characters with combat stats; any sprite can still be placed from the Appearance tab.
+3. **The mod list is empty.** Packed mods cannot be edited.

docs/es.md

@@ -0,0 +1,41 @@
+# Characters Editor — edita los personajes de un mod en un formulario
+
+El Characters Editor edita los personajes de un mod mientras el juego está en marcha: el nombre en todos los idiomas del mod, el retrato, el sprite de paseo para los mapas RPG, las cifras de combate, la probabilidad de reclutamiento y las acciones de combate. **Guardar** escribe los archivos del mod y el juego usa el cambio al instante.
+
+Se abre desde la caja de herramientas (el martillo de la barra) como **Personajes**.
+
+## Una edición y su resultado en el juego
+
+En RPG Plus, el héroe de la aldea es el personaje `rpg_hero` del mod `rpg_demo_game`. Elige ese mod arriba, selecciona **Héroe**, escribe un nombre nuevo en inglés y pulsa **Guardar** (Ctrl+S):
+
+![La ventana Personajes sobre rpg_demo_game: la lista Aldric · rpg_hero, Limo · rpg_slime, Lobo · rpg_wolf; el formulario de rpg_hero con la clave del nombre rpg_demo/character/hero, texto (en) Aldric y los otros seis idiomas sin cambios, Retrato characters/village/hero con su imagen, Charset (RPG) vacío, Nivel 1, Salud 24, Ataque 6, Defensa 0, Puntos de acción 1, Experiencia 0, Probabilidad de reclutar 0. 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 miembro del grupo en el panel de personajes justo después:
+
+![El panel de acciones del personaje: el miembro del grupo ahora se llama Aldric (rpg_hero, HP 42/42, AP 1, ATK 12, DEF 4) con Ataque básico, Defensa y Golpe poderoso.](assets/panel-after.jpg)
+
+El panel muestra HP 42 y ATK 12 aunque el archivo dice 24 y 6: en RPG Plus la clase y los atributos del héroe (Stats Engine con Classic RPG Rules) calculan las cifras de combate y las escriben sobre los valores del archivo. En un juego sin atributos se usan los números del archivo.
+
+## El formulario
+
+- **Id** — el id del personaje; por él lo encuentran escenarios, grupos, combates y mapas.
+- **Nombre** — la clave de traducción y una línea por idioma del mod.
+- **Retrato** — la imagen en tarjetas y paneles; **…** abre una cuadrícula para elegir una.
+- **Charset (RPG)** — el sprite de paseo en los mapas RPG (3 fotogramas × 4 orientaciones). El editor de mapas RPG ofrece los personajes con su charset para colocarlos.
+- **Nivel**, **Salud**, **Ataque**, **Defensa**, **Puntos de acción**, **Experiencia** — las cifras de combate del personaje.
+- **Probabilidad de reclutar** — de 0 a 100: la probabilidad de capturar al personaje tras vencerlo (ver Recruiting).
+- **Comportamiento** y **Acciones** — cómo pelea el personaje y qué acciones de combate tiene.
+- **Campos de otros mods** — los campos que otros mods describen para los personajes en sus esquemas (por ejemplo la clase, los atributos y los rasgos de Stats Engine) aparecen en su propia sección.
+- **Otros campos** — el resto del JSON del personaje, editado como JSON y conservado tal cual.
+
+La barra: **Nueva** (Ctrl+N), **Copia** (Ctrl+D), **Borrar**, **Deshacer**/**Rehacer** (Ctrl+Z / Ctrl+Y), **Guardar** — solo se escriben los archivos cambiados; los textos van a los archivos de localización del mod.
+
+## Qué personajes se pueden editar
+
+La lista contiene los personajes de los archivos del mod seleccionado; solo se ofrecen los mods instalados como carpetas. Los personajes de otros mods no están en la lista y sus archivos nunca se escriben. Para cambiar uno de ellos, incluye el mismo id en tu propio mod con una dependencia del dueño, o añade campos con un parche.
+
+## Si algo sale mal
+
+1. **Cambiar salud o ataque no tiene efecto.** El juego calcula las cifras a partir de los atributos, como hace RPG Plus con su grupo.
+2. **El personaje no está en la pestaña Personajes del editor de mapas RPG.** La pestaña lista personajes con estadísticas de combate; cualquier sprite se puede colocar desde la pestaña Appearance.
+3. **La lista de mods está vacía.** Los mods empaquetados no se pueden editar.

docs/ja.md

@@ -0,0 +1,41 @@
+# Characters Editor — フォームで MOD のキャラクターを編集する
+
+Characters Editor は、ゲームの実行中に MOD のキャラクターを編集します: MOD の各言語での名前、肖像、RPG マップの歩行グラフィック、戦闘の数値、勧誘の確率、バトルアクション。**保存**は MOD のファイルを書き込み、ゲームはすぐに変更を使います。
+
+ツールボックス（ツールバーのハンマー）から**キャラクター**として開きます。
+
+## 編集と、ゲームの中での結果
+
+RPG Plus では、村の英雄は MOD `rpg_demo_game` のキャラクター `rpg_hero` です。上でその MOD を選び、**勇者**を選び、新しい英語名を入力して**保存**（Ctrl+S）を押します:
+
+![rpg_demo_game の「キャラクター」ウィンドウ: 一覧は Aldric · rpg_hero、スライム · rpg_slime、狼 · rpg_wolf。rpg_hero のフォーム、名前キー rpg_demo/character/hero、テキスト (en) Aldric、ほかの六言語は変更なし、肖像 characters/village/hero とその画像、キャラチップ（RPG）は空、レベル 1、体力 24、攻撃 6、防御 0、行動ポイント 1、経験値 0、勧誘の確率 0。ステータス行:「保存しました: MOD rpg_demo_game のファイル 0、テキスト 1。ゲームはデータを読み直しました」。](assets/editor-saved.jpg)
+
+変わったのは MOD の `locale/en.properties` の英語の行だけです。直後のキャラクターパネルのパーティメンバー:
+
+![キャラクターアクションパネル: パーティメンバーは今や Aldric（rpg_hero、HP 42/42、AP 1、ATK 12、DEF 4）で、基本攻撃、防御、強打を持ちます。](assets/panel-after.jpg)
+
+パネルは HP 42 と ATK 12 を示しますが、ファイルには 24 と 6 とあります: RPG Plus では勇者のクラスとステータス（Stats Engine と Classic RPG Rules）が戦闘の数値を計算し、ファイルの値の上に書きます。ステータスのないゲームではファイルの数値がそのまま使われます。
+
+## フォーム
+
+- **Id** — キャラクターの id。シナリオ、パーティ、バトル、マップがこれで見つけます。
+- **名前** — 翻訳キーと、MOD の言語ごとの行。
+- **肖像** — カードやパネルの画像。**…** で選ぶためのグリッドが開きます。
+- **キャラチップ（RPG）** — RPG マップ上の歩行グラフィック（3 コマ × 4 方向）。RPG マップエディターは、配置のときにキャラチップ付きのキャラクターを提示します。
+- **レベル**、**体力**、**攻撃**、**防御**、**行動ポイント**、**経験値** — キャラクターの戦闘の数値。
+- **勧誘の確率** — 0〜100: 倒したあとにキャラクターを迎える確率（Recruiting を参照）。
+- **行動パターン**と**アクション** — キャラクターがどう戦うか、どんなバトルアクションを持つか。
+- **他の MOD のフィールド** — 他の MOD がスキーマでキャラクターに付けるフィールド（たとえば Stats Engine のクラス、ステータス、特性）は専用セクションに現れます。
+- **その他のフィールド** — キャラクターの JSON の残り。JSON として編集され、そのまま保たれます。
+
+ツールバー: **新規**（Ctrl+N）、**コピー**（Ctrl+D）、**削除**、**元に戻す**/**やり直す**（Ctrl+Z / Ctrl+Y）、**保存** — 変更されたファイルだけが書き込まれ、テキストは MOD のローカライズファイルに入ります。
+
+## どのキャラクターを編集できるか
+
+一覧には、選んだ MOD 自身のファイルにあるキャラクターが入ります。提示されるのは、フォルダーとしてインストールされた MOD だけです。他の MOD のキャラクターは一覧になく、そのファイルが書かれることもありません。変えるには、自分の MOD で同じ id を所有者への依存関係付きで配るか、パッチでフィールドを足します。
+
+## うまくいかないとき
+
+1. **体力や攻撃を変えても効かない。** ゲームはステータスから数値を計算します。RPG Plus がパーティに対してしているように。
+2. **キャラクターが RPG マップエディターの「キャラクター」タブにいない。** このタブは戦闘ステータスのあるキャラクターを一覧します。どんなグラフィックでも「Appearance」タブから配置できます。
+3. **MOD の一覧が空。** パッケージ済みの MOD は編集できません。

docs/ko.md

@@ -0,0 +1,41 @@
+# Characters Editor — 양식으로 모드의 캐릭터 편집하기
+
+Characters Editor는 게임이 실행되는 동안 모드의 캐릭터를 편집합니다: 모드의 모든 언어로 된 이름, 초상화, RPG 맵의 걷기 스프라이트, 전투 수치, 영입 확률, 전투 액션. **저장**은 모드의 파일을 기록하고 게임은 곧바로 변경을 사용합니다.
+
+도구 상자(도구 모음의 망치)에서 **캐릭터**로 열립니다.
+
+## 편집 하나와 게임 속 결과
+
+RPG Plus에서 마을의 영웅은 모드 `rpg_demo_game`의 캐릭터 `rpg_hero`입니다. 위에서 그 모드를 고르고, **영웅**을 고르고, 새 영어 이름을 입력한 뒤 **저장**(Ctrl+S)을 누릅니다:
+
+![rpg_demo_game의 "캐릭터" 창: 목록에는 Aldric · rpg_hero, 슬라임 · rpg_slime, 늑대 · rpg_wolf. rpg_hero의 양식, 이름 키 rpg_demo/character/hero, 텍스트 (en) Aldric, 나머지 여섯 언어는 그대로, 초상화 characters/village/hero와 그 그림, 캐릭터 시트 (RPG) 비어 있음, 레벨 1, 체력 24, 공격 6, 방어 0, 행동 포인트 1, 경험치 0, 영입 확률 0. 상태 줄: "저장함: 모드 rpg_demo_game의 파일 0개, 텍스트 1개. 게임이 데이터를 다시 읽었습니다".](assets/editor-saved.jpg)
+
+바뀐 것은 모드 `locale/en.properties`의 영어 한 줄입니다. 바로 뒤 캐릭터 패널의 파티원:
+
+![캐릭터 액션 패널: 파티원은 이제 Aldric(rpg_hero, HP 42/42, AP 1, ATK 12, DEF 4)이며 기본 공격, 방어, 강타를 가집니다.](assets/panel-after.jpg)
+
+패널은 HP 42와 ATK 12를 보여 주지만 파일에는 24와 6이 있습니다: RPG Plus에서는 영웅의 클래스와 스탯(Stats Engine과 Classic RPG Rules)이 전투 수치를 계산해 파일 값 위에 씁니다. 스탯이 없는 게임에서는 파일의 숫자가 그대로 쓰입니다.
+
+## 양식
+
+- **Id** — 캐릭터의 id. 시나리오, 파티, 전투, 맵이 이것으로 찾습니다.
+- **이름** — 번역 키와 모드의 언어별 줄.
+- **초상화** — 카드와 패널의 그림. **…**를 누르면 고르는 격자가 열립니다.
+- **캐릭터 시트 (RPG)** — RPG 맵 위의 걷기 스프라이트(3프레임 × 4방향). RPG 맵 에디터는 배치할 때 캐릭터 시트와 함께 캐릭터를 제안합니다.
+- **레벨**, **체력**, **공격**, **방어**, **행동 포인트**, **경험치** — 캐릭터의 전투 수치.
+- **영입 확률** — 0~100: 쓰러뜨린 뒤 캐릭터를 들일 확률(Recruiting 참고).
+- **행동 방식**과 **액션** — 캐릭터가 어떻게 싸우는지, 어떤 전투 액션을 가지는지.
+- **다른 모드의 필드** — 다른 모드가 스키마에서 캐릭터에 붙인 필드(예: Stats Engine의 클래스, 스탯, 특성)는 별도 구역에 나타납니다.
+- **기타 필드** — 캐릭터 JSON의 나머지. JSON으로 편집되고 그대로 유지됩니다.
+
+도구 모음: **새로 만들기**(Ctrl+N), **복사**(Ctrl+D), **삭제**, **되돌리기**/**다시 실행**(Ctrl+Z / Ctrl+Y), **저장** — 바뀐 파일만 기록되고, 텍스트는 모드의 로컬라이즈 파일로 갑니다.
+
+## 어떤 캐릭터를 편집할 수 있는가
+
+목록에는 선택한 모드 자신의 파일에 있는 캐릭터가 있습니다. 폴더로 설치된 모드만 제안됩니다. 다른 모드의 캐릭터는 목록에 없고 그 파일은 결코 기록되지 않습니다. 바꾸려면 소유자에 대한 의존성과 함께 같은 id를 자기 모드에 실거나, 패치로 필드를 더하세요.
+
+## 문제가 생겼을 때
+
+1. **체력이나 공격을 바꿔도 효과가 없습니다.** 게임은 스탯에서 수치를 계산합니다. RPG Plus가 자기 파티에 하는 것처럼.
+2. **캐릭터가 RPG 맵 에디터의 "캐릭터" 탭에 없습니다.** 이 탭은 전투 스탯이 있는 캐릭터를 나열합니다. 어떤 스프라이트든 "Appearance" 탭에서 배치할 수 있습니다.
+3. **모드 목록이 비어 있습니다.** 압축된 모드는 편집할 수 없습니다.

docs/ru.md

@@ -0,0 +1,41 @@
+# Characters Editor — правка персонажей мода в форме
+
+Characters Editor правит персонажей мода, пока игра работает: имя на всех языках мода, портрет, спрайт ходьбы для RPG-карт, боевые числа, шанс вербовки и боевые действия. **Сохранить** записывает файлы мода, и игра использует изменение сразу.
+
+Открывается из набора инструментов (молоток на панели инструментов) как **Персонажи**.
+
+## Правка и её результат в игре
+
+В RPG Plus героем деревни выступает персонаж `rpg_hero` мода `rpg_demo_game`. Выберите этот мод сверху, укажите **Героя**, введите новое английское имя и нажмите **Сохранить** (Ctrl+S):
+
+![Окно «Персонажи» на rpg_demo_game: в списке Aldric · rpg_hero, Слизень · rpg_slime, Волк · rpg_wolf; форма rpg_hero с ключом имени rpg_demo/character/hero, текст (en) Aldric и шесть остальных языков без изменений, Портрет characters/village/hero с его картинкой, Чарсет (RPG) пусто, Уровень 1, Здоровье 24, Атака 6, Защита 0, Очки действий 1, Опыт 0, Шанс вербовки 0. Строка состояния: «Сохранено: файлов 0, текстов 1 в моде rpg_demo_game; игра перечитала данные».](assets/editor-saved.jpg)
+
+Изменилась только английская строка в `locale/en.properties` мода. Участник отряда на панели персонажей сразу после:
+
+![Панель действий персонажа: участник отряда теперь зовётся Aldric (rpg_hero, HP 42/42, AP 1, ATK 12, DEF 4) с обычной атакой, защитой и мощным ударом.](assets/panel-after.jpg)
+
+На панели HP 42 и ATK 12, хотя в файле 24 и 6: в RPG Plus класс и характеристики героя (Stats Engine с Classic RPG Rules) вычисляют боевые числа и записывают их поверх значений из файла. В игре без характеристик используются числа из файла.
+
+## Форма
+
+- **Id** — id персонажа; по нему находят его сценарии, отряды, бои и карты.
+- **Имя** — ключ перевода и строка на каждый язык мода.
+- **Портрет** — картинка на карточках и панелях; **…** открывает сетку для выбора.
+- **Чарсет (RPG)** — спрайт ходьбы на RPG-картах (3 кадра × 4 направления). Редактор RPG-карт предлагает персонажей вместе с их чарсетом для размещения.
+- **Уровень**, **Здоровье**, **Атака**, **Защита**, **Очки действий**, **Опыт** — боевые числа персонажа.
+- **Шанс вербовки** — от 0 до 100: вероятность забрать персонажа в отряд после победы над ним (см. Recruiting).
+- **Поведение** и **Действия** — как персонаж сражается и какие у него боевые действия.
+- **Поля других модов** — поля, которые другие моды описывают для персонажей в своих схемах (например, класс, характеристики и черты из Stats Engine), появляются отдельной секцией.
+- **Прочие поля** — остальное из JSON персонажа, правится как JSON и сохраняется как есть.
+
+Панель инструментов: **Новый** (Ctrl+N), **Копия** (Ctrl+D), **Удалить**, **Отменить**/**Повторить** (Ctrl+Z / Ctrl+Y), **Сохранить** — записываются только изменённые файлы; тексты уходят в файлы локализации мода.
+
+## Каких персонажей можно править
+
+В списке — персонажи из собственных файлов выбранного мода; предлагаются только моды, установленные папками. Персонажей чужих модов в списке нет, и их файлы никогда не записываются. Чтобы изменить такого персонажа, дайте в своём моде тот же id с зависимостью от владельца или добавьте поля патчем.
+
+## Если что-то пошло не так
+
+1. **Изменённые здоровье или атака не действуют.** Игра вычисляет числа из характеристик, как RPG Plus делает для своего отряда.
+2. **Персонажа нет на вкладке «Персонажи» редактора RPG-карт.** На вкладке — персонажи с боевыми характеристиками; спрайт для размещения можно взять на вкладке «Внешность».
+3. **Список модов пуст.** Упакованные моды не редактируются.

docs/vi.md

@@ -0,0 +1,41 @@
+# Characters Editor — sửa nhân vật của mod bằng biểu mẫu
+
+Characters Editor sửa các nhân vật của một mod khi game đang chạy: tên bằng mọi ngôn ngữ của mod, chân dung, sprite đi bộ cho bản đồ RPG, các con số chiến đấu, tỉ lệ chiêu mộ và hành động chiến đấu. **Lưu** ghi các tệp của mod và game dùng thay đổi ngay.
+
+Nó mở từ hộp công cụ (chiếc búa trên thanh công cụ) dưới tên **Nhân vật**.
+
+## Một chỉnh sửa và kết quả trong game
+
+Trong RPG Plus, anh hùng của ngôi làng là nhân vật `rpg_hero` của mod `rpg_demo_game`. Chọn mod đó ở trên, chọn **Anh hùng**, gõ một tên tiếng Anh mới rồi nhấn **Lưu** (Ctrl+S):
+
+![Cửa sổ Nhân vật trên rpg_demo_game: danh sách Aldric · rpg_hero, Slime · rpg_slime, Sói · rpg_wolf; biểu mẫu của rpg_hero với khóa tên rpg_demo/character/hero, văn bản (en) Aldric và sáu ngôn ngữ còn lại giữ nguyên, Chân dung characters/village/hero cùng hình của nó, Charset (RPG) trống, Cấp độ 1, Máu 24, Tấn công 6, Phòng thủ 0, Điểm hành động 1, Kinh nghiệm 0, Tỉ lệ chiêu mộ 0. 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. Ngay sau đó, thành viên tổ đội trên bảng nhân vật:
+
+![Bảng hành động nhân vật: thành viên tổ đội giờ tên là Aldric (rpg_hero, HP 42/42, AP 1, ATK 12, DEF 4) với Đánh cơ bản, Phòng thủ và Cú đánh mạnh.](assets/panel-after.jpg)
+
+Bảng hiện HP 42 và ATK 12 trong khi tệp ghi 24 và 6: trong RPG Plus, lớp và chỉ số của anh hùng (Stats Engine với Classic RPG Rules) tính các con số chiến đấu và ghi đè lên giá trị của tệp. Trong game không có chỉ số thì dùng đúng các con số trong tệp.
+
+## Biểu mẫu
+
+- **Id** — id của nhân vật; kịch bản, tổ đội, trận đấu và bản đồ tìm nó qua id này.
+- **Tên** — khóa dịch và một dòng cho mỗi ngôn ngữ của mod.
+- **Chân dung** — hình trên thẻ và bảng; **…** mở lưới để chọn.
+- **Charset (RPG)** — sprite đi bộ trên bản đồ RPG (3 khung × 4 hướng). Trình sửa bản đồ RPG đưa ra các nhân vật kèm charset của họ để đặt.
+- **Cấp độ**, **Máu**, **Tấn công**, **Phòng thủ**, **Điểm hành động**, **Kinh nghiệm** — các con số chiến đấu của nhân vật.
+- **Tỉ lệ chiêu mộ** — từ 0 đến 100: khả năng thu nhận nhân vật sau khi đánh bại nó (xem Recruiting).
+- **Hành vi** và **Hành động** — nhân vật đánh thế nào và có những hành động chiến đấu nào.
+- **Trường của mod khác** — các trường mà mod khác mô tả cho nhân vật trong lược đồ của họ (ví dụ lớp, chỉ số và đặc tính của Stats Engine) hiện trong mục riêng.
+- **Các trường khác** — phần còn lại của JSON nhân vật, sửa dưới dạng JSON và giữ nguyên như cũ.
+
+Thanh công cụ: **Mới** (Ctrl+N), **Sao chép** (Ctrl+D), **Xóa**, **Hoàn tác**/**Làm lại** (Ctrl+Z / Ctrl+Y), **Lưu** — chỉ những tệp thay đổi được ghi; văn bản vào các tệp bản địa hóa của mod.
+
+## Những nhân vật nào được sửa
+
+Danh sách chứa các nhân vật trong tệp của chính mod được chọn; chỉ có các mod cài dưới dạng thư mục được đưa ra. Nhân vật của mod khác không có trong danh sách và tệp của họ không bao giờ bị ghi. Muốn đổi một nhân vật như vậy, hãy mang cùng id trong mod của mình kèm phụ thuộc vào chủ sở hữu, hoặc thêm trường bằng bản vá.
+
+## Khi có trục trặc
+
+1. **Đổi máu hay tấn công không có tác dụng.** Game tính các con số từ chỉ số, như RPG Plus làm với tổ đội của nó.
+2. **Nhân vật không có ở thẻ Nhân vật của trình sửa bản đồ RPG.** Thẻ này liệt kê các nhân vật có chỉ số chiến đấu; sprite nào cũng đặt được từ thẻ Appearance.
+3. **Danh sách mod trống.** Mod đóng gói không sửa được.

docs/zh.md

@@ -0,0 +1,41 @@
+# Characters Editor — 用表单编辑模组的角色
+
+Characters Editor 在游戏运行时编辑模组的角色：各种语言的名称、立绘、RPG 地图的行走图、战斗数值、招募几率和战斗行动。**保存**会写入模组的文件，游戏立刻使用这一变化。
+
+它从工具箱（工具栏上的锤子）打开，叫**角色**。
+
+## 一次编辑及其在游戏中的结果
+
+RPG Plus 里村庄的英雄是模组 `rpg_demo_game` 的角色 `rpg_hero`。顶部选择该模组，选**英雄**，输入新的英文名称，按**保存**（Ctrl+S）：
+
+![rpg_demo_game 上的「角色」窗口：列表中有 Aldric · rpg_hero、史莱姆 · rpg_slime、狼 · rpg_wolf；rpg_hero 的表单，名称键 rpg_demo/character/hero，文本 (en) Aldric，其余六种语言未变，立绘 characters/village/hero 及其图片，行走图（RPG）为空，等级 1，生命 24，攻击 6，防御 0，行动点 1，经验 0，招募几率 0。状态行：「已保存：模组 rpg_demo_game 中 0 个文件、1 条文本；游戏已重新读取数据」。](assets/editor-saved.jpg)
+
+只有模组 `locale/en.properties` 的英文一行变了。紧接着角色面板上的队伍成员：
+
+![角色行动面板：队伍成员现在叫 Aldric（rpg_hero，HP 42/42，AP 1，ATK 12，DEF 4），带普通攻击、防御和强力一击。](assets/panel-after.jpg)
+
+面板显示 HP 42 和 ATK 12，而文件里写的是 24 和 6：在 RPG Plus 中，英雄的职业和属性（Stats Engine 与 Classic RPG Rules）会计算战斗数值并覆盖文件里的值。在没有属性的游戏里用的就是文件里的数字。
+
+## 表单
+
+- **Id** —— 角色的 id；剧本、队伍、战斗和地图都靠它找到角色。
+- **名称** —— 翻译键和模组每种语言的一行文字。
+- **立绘** —— 卡片和面板上的图片；**…** 打开网格挑选。
+- **行走图（RPG）** —— 角色在 RPG 地图上的行走图（3 帧 × 4 朝向）。RPG 地图编辑器会把带行走图的角色列为可放置对象。
+- **等级**、**生命**、**攻击**、**防御**、**行动点**、**经验** —— 角色的战斗数值。
+- **招募几率** —— 0 到 100：击败后收编该角色的几率（见 Recruiting）。
+- **行为**和**行动** —— 角色怎么打，以及有哪些战斗行动。
+- **其他模组的字段** —— 其他模组在各自模式中为角色描述的字段（例如 Stats Engine 的职业、属性和特性），会在单独区域出现。
+- **其他字段** —— 角色 JSON 的其余部分，按 JSON 编辑并原样保留。
+
+工具栏：**新建**（Ctrl+N）、**复制**（Ctrl+D）、**删除**、**撤销**/**重做**（Ctrl+Z / Ctrl+Y）、**保存** —— 只写改动的文件；文字进入模组的本地化文件。
+
+## 哪些角色可以编辑
+
+列表里是所选模组自己文件中的角色；只提供以文件夹安装的模组。其他模组的角色不在列表里，它们的文件也绝不会被写入。想改这样的角色，可以在自己的模组里带上相同的 id 并声明对属主的依赖，或者用补丁添加字段。
+
+## 出问题了怎么办
+
+1. **改了生命或攻击没有效果。** 游戏会从属性推算数值，RPG Plus 对自己的队伍就是这样做的。
+2. **角色不在 RPG 地图编辑器的「角色」标签页。** 该标签页列出带战斗属性的角色；任何行走图都可以从 Appearance 标签页放置。
+3. **模组列表是空的。** 打包模组不能编辑。

locale/ui_en.properties

@@ -1,5 +1,5 @@
-mod_characters_editor_name = Character Editor
-mod_characters_editor_desc = Editor of the game's characters — heroes, NPCs and enemies: a searchable list with portraits, the name in every language of the mod, portrait, the RPG map charset, battle stats and actions; a save shows in the game at once.
+mod_characters_editor_name = Characters Editor
+mod_characters_editor_desc = Edits a mod's characters while the game runs: names in every language, portrait, RPG walking sprite, battle numbers and actions. A save reaches the running game at once.
 tools/characters_editor/title = Characters
 tools/characters_editor/name = Name
 tools/characters_editor/image = Portrait

locale/ui_es.properties

@@ -1,5 +1,5 @@
 mod_characters_editor_name = Editor de personajes
-mod_characters_editor_desc = Editor de los personajes del juego (héroes, PNJ y enemigos): una lista con búsqueda y retratos, el nombre en cada idioma del mod, retrato, charset del mapa RPG, estadísticas y acciones de combate; al guardar se ve en el juego al momento.
+mod_characters_editor_desc = Edita los personajes de un mod con el juego en marcha: nombres en todos los idiomas, retrato, sprite de paseo para el mapa RPG, cifras de combate y acciones. Un guardado llega al juego en marcha al instante.
 tools/characters_editor/title = Personajes
 tools/characters_editor/name = Nombre
 tools/characters_editor/image = Retrato

locale/ui_ja.properties

@@ -1,5 +1,5 @@
 mod_characters_editor_name = キャラクターエディター
-mod_characters_editor_desc = ゲームのキャラクター——主人公、NPC、敵——のエディター：検索と肖像付きの一覧、MOD の各言語での名前、肖像、RPG マップのキャラチップ、戦闘能力値とアクション。保存するとすぐにゲームに反映されます。
+mod_characters_editor_desc = ゲームの実行中に MOD のキャラクターを編集します: 各言語の名前、肖像、RPG の歩行グラフィック、戦闘の数値とアクション。保存すると実行中のゲームにすぐ届きます。
 tools/characters_editor/title = キャラクター
 tools/characters_editor/name = 名前
 tools/characters_editor/image = 肖像

locale/ui_ko.properties

@@ -1,5 +1,5 @@
 mod_characters_editor_name = 캐릭터 에디터
-mod_characters_editor_desc = 게임 캐릭터 — 영웅, NPC, 적 — 에디터: 검색과 초상화가 있는 목록, 모드의 모든 언어로 된 이름, 초상화, RPG 맵 캐릭터 시트, 전투 능력치와 액션. 저장하면 게임에 바로 보입니다.
+mod_characters_editor_desc = 게임이 실행되는 동안 모드의 캐릭터를 편집합니다: 모든 언어의 이름, 초상화, RPG 걷기 스프라이트, 전투 수치와 동작. 저장하면 실행 중인 게임에 곧바로 반영됩니다.
 tools/characters_editor/title = 캐릭터
 tools/characters_editor/name = 이름
 tools/characters_editor/image = 초상화

locale/ui_ru.properties

@@ -1,5 +1,5 @@
 mod_characters_editor_name = Редактор персонажей
-mod_characters_editor_desc = Редактор персонажей игры — героев, NPC и врагов: список с поиском и портретами, имя на всех языках мода, портрет, чарсет для RPG-карты, боевые параметры и действия; сохранение сразу видно в игре.
+mod_characters_editor_desc = Правит персонажей мода прямо во время игры: имена на всех языках, портрет, чарсет для RPG-карты, боевые параметры и действия. Сохранение сразу доходит до запущенной игры.
 tools/characters_editor/title = Персонажи
 tools/characters_editor/name = Имя
 tools/characters_editor/image = Портрет

locale/ui_vi.properties

@@ -1,5 +1,5 @@
 mod_characters_editor_name = Trình sửa nhân vật
-mod_characters_editor_desc = Trình sửa nhân vật của game — anh hùng, NPC và kẻ địch: danh sách có tìm kiếm và chân dung, tên bằng mọi ngôn ngữ của mod, chân dung, charset bản đồ RPG, chỉ số và hành động chiến đấu; lưu xong là thấy ngay trong game.
+mod_characters_editor_desc = Sửa các nhân vật của mod khi game đang chạy: tên bằng mọi ngôn ngữ, chân dung, sprite đi bộ cho bản đồ RPG, chỉ số và hành động chiến đấu. Mỗi lần lưu lập tức tới với game đang chạy.
 tools/characters_editor/title = Nhân vật
 tools/characters_editor/name = Tên
 tools/characters_editor/image = Chân dung

locale/ui_zh.properties

@@ -1,5 +1,5 @@
 mod_characters_editor_name = 角色编辑器
-mod_characters_editor_desc = 游戏角色的编辑器——英雄、NPC 和敌人：带搜索和立绘的列表，模组每种语言的名称，立绘、RPG 地图行走图、战斗属性和行动；保存后游戏中立即可见。
+mod_characters_editor_desc = 在游戏运行时编辑模组的角色：各语言的名称、立绘、RPG 行走图、战斗数值和行动。保存后立刻反映到运行中的游戏。
 tools/characters_editor/title = 角色
 tools/characters_editor/name = 名称
 tools/characters_editor/image = 立绘

manifest.json

@@ -1,9 +1,9 @@
 {
   "id": "characters_editor",
-  "name": "Character Editor",
+  "name": "Characters Editor",
   "version": "1.0.0",
   "author": "ct",
-  "description": "Editor of the game's characters (characters_base, \"Kind\": \"character\") in the style of the other editor windows: heroes, NPCs and enemies of a writable mod in a searchable list with their portraits, a form with the name in every language of the mod, portrait, the RPG map charset, battle stats and the battle actions picked from the loaded ones; loot and fields of other mods stay editable as JSON. New characters, 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 characters while the game runs: names in every language, portrait, RPG walking sprite, battle numbers and actions. A save reaches the running game at once.",
   "category": "tools, editor",
   "sources": [
     "src/**/*.cs"