Update characters_editor implementation, assets and documentation

docs/ru.md

@@ -6,9 +6,9 @@ Characters Editor правит персонажей мода, пока игра
 
 ## Правка и её результат в игре
 
-В RPG Plus героем деревни выступает персонаж `rpg_hero` мода `rpg_demo_game`. Выберите этот мод сверху, укажите **Героя**, введите новое английское имя и нажмите **Сохранить** (Ctrl+S):
+В RPG Plus героем деревни выступает персонаж `rpg_hero` мода `rpg_plus_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)
+![Окно «Персонажи» на rpg_plus_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_plus_game; игра перечитала данные».](assets/editor-saved.jpg)
 
 Изменилась только английская строка в `locale/en.properties` мода. Участник отряда на панели персонажей сразу после:
 
@@ -21,7 +21,7 @@ Characters Editor правит персонажей мода, пока игра
 - **Id** — id персонажа; по нему находят его сценарии, отряды, бои и карты.
 - **Имя** — ключ перевода и строка на каждый язык мода.
 - **Портрет** — картинка на карточках и панелях; **…** открывает сетку для выбора.
-- **Чарсет (RPG)** — спрайт ходьбы на RPG-картах (3 кадра × 4 направления). Редактор RPG-карт предлагает персонажей вместе с их чарсетом для размещения.
+- **Чарсет (RPG)** — спрайт ходьбы на RPG-картах (3 кадра × 4 направления).
 - **Уровень**, **Здоровье**, **Атака**, **Защита**, **Очки действий**, **Опыт** — боевые числа персонажа.
 - **Шанс вербовки** — от 0 до 100: вероятность забрать персонажа в отряд после победы над ним (см. Recruiting).
 - **Поведение** и **Действия** — как персонаж сражается и какие у него боевые действия.
@@ -30,12 +30,20 @@ Characters Editor правит персонажей мода, пока игра
 
 Панель инструментов: **Новый** (Ctrl+N), **Копия** (Ctrl+D), **Удалить**, **Отменить**/**Повторить** (Ctrl+Z / Ctrl+Y), **Сохранить** — записываются только изменённые файлы; тексты уходят в файлы локализации мода.
 
-## Каких персонажей можно править
+## Персонажи других модов
 
-В списке — персонажи из собственных файлов выбранного мода; предлагаются только моды, установленные папками. Персонажей чужих модов в списке нет, и их файлы никогда не записываются. Чтобы изменить такого персонажа, дайте в своём моде тот же id с зависимостью от владельца или добавьте поля патчем.
+Список показывает персонажей выбранного мода. Отметьте **Entries of other mods**, чтобы добавить персонажей его зависимостей; они помечены `↗ владелец`. Правка такого персонажа записывается патчем в ваш мод (`patches/character/<ваш мод>.json`) только с изменёнными значениями; файл владельца остаётся побайтно прежним. **Reset to inherited** убирает патч, а **↺** рядом с полем убирает ваше значение этого поля. Писать можно только в моды, установленные папкой.
+
+## Блок «Партия»
+
+Под полями блок «Партия» показывает два пункта:
+
+- **Лидер партии** — персонаж, с листом которого игрок ходит по RPG-картам. Лидер — тот, кого называет `stats.player` игры; если его нет, первый персонаж боевого состава. Блок пишет «Party leader» или «Not the party leader» для открытого персонажа. Назначить нового лидера кнопкой пока нельзя: это настройка коллекции, её меняют через менеджер модов.
+- **Вычисленные боевые числа** — если у персонажа есть `Stats`, значения статов и боевые числа. Подсказка говорит, что здоровье, атака и защита берутся из статов, поэтому правьте статы, а не эти поля. У персонажа со `Stats` поля **Health**, **Attack** и **Defence** только для чтения. Без `Stats` блок так и пишет, а боевые числа — это поля выше.
+- **Присоединяется к отряду при разговоре** — отметьте, чтобы записать сценарий присоединения `scenarios/<ваш мод>/party/<id>.scenario`: он ставит флаг `<id>_joined` в 1 и добавляет персонажа в отряд (`action party.add`). Снятие отметки сразу удаляет файл. Лидер не присоединяется: флажок для него выключен. Чтобы персонаж стал напарником на карте, поставьте его во вкладке «Персонажи» редактора RPG-карт: разговор с поставленным актёром присоединяет его, актёр уходит с клетки, а напарник идёт за героем.
 
 ## Если что-то пошло не так
 
 1. **Изменённые здоровье или атака не действуют.** Игра вычисляет числа из характеристик, как RPG Plus делает для своего отряда.
-2. **Персонажа нет на вкладке «Персонажи» редактора RPG-карт.** На вкладке — персонажи с боевыми характеристиками; спрайт для размещения можно взять на вкладке «Внешность».
+2. **Персонажа нет в палитре редактора RPG-карт.** Вкладка «Персонажи» показывает только персонажей с ходячим спрайтом (**Charset**); без него персонажа не поставить. Вкладка «Актёры» показывает объекты `rpg_object`, а не персонажей игры.
 3. **Список модов пуст.** Упакованные моды не редактируются.