mod_characters_editor/docs/ru.md

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