Add mod documentation in seven languages

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. **Список модов пуст.** Упакованные моды не редактируются.