Update Моддинг/Советники

%D0%9C%D0%BE%D0%B4%D0%B4%D0%B8%D0%BD%D0%B3%2F%D0%A1%D0%BE%D0%B2%D0%B5%D1%82%D0%BD%D0%B8%D0%BA%D0%B8.md

@@ -1,22 +1,42 @@
-### Через файлы идей
-
-[ref](https://hoi4.paradoxwikis.com/Idea_modding)
-
-Советники хранятся в файлах `${GAME_ROOT}/common/ideas`.
-Каждый файл имеет в себе корневое пространство `ideas`. 
-
-Определение советников выполняется созданием в `ideas` пространства `political_advisor`.
-Внутри элемента `political_advisor` создаётся пространство с названием политика.
-
-Адвизор имеет следующи поля:
-
-- allowed
-- `picture` - к значению этого поля добавляется приставка `GFX_idea_` и только затем идёт поиск опредления спрайта в `${GAME_ROOT}/interface/*.gfx`
-- allowed_civil_war
-- available
-
-Пример:
-
 ### Через определение персонажей
 
+[reference](https://steamcommunity.com/sharedfiles/filedetails/?id=3008616019)
+
+В файле `${MOD_ROOT}/common/characters/*.txt`:
+
+- должен присутствовать корневой блок `characters`;
+- в блоке `characters` каждый дочерний блок определяет персонажей;
+- блок персонажа имеет следующие поля:
+  - `name` - локализуемое название персонажа;
+  - `portraits = {...}` - список портретов для вашего персонажа;
+    - `civilian = {...}` - гражданские портреты:
+       - `small` - маленький портрет, путь в файлу от `${GAME_ROOT}` или название GFX спрайта;
+       - `large` - большой портрет, путь в файлу от `${GAME_ROOT}` или название GFX спрайта;
+    - `army = {...}` - армейский портрет (элементы: см `civilian`);
+  - `advisor = {...} ... ` - роли, доступные для советника. Поддерживается множественное объявление одноимённых блоков;
+    - `slot` - ключ слота, базовый набор: `political_advisor`, `theorist`, `army_chief`, `navy_chief`, `air_chief`, `high_command`;
+    - `idea_token` - декларирует ключ персонажа для триггеров;
+    - `ledger` - ключ принадлежности вашего персонажа к слотам идей в призме взгляда разведки других государств. Бывают следующие значения:
+      - `civilian` - персонаж будет отображаться в секции с законами и министрами;
+      - `military` - во всех военных секциях;
+      - `army`/`navy`/`air` - в конкретной военной секции (армейской, морской или воздушной);
+      - `all` - во всех секциях в принципе;
+      - `hidden` - персонаж не будет виден иностранной разведке ни в одной из секций;
+    - `can_be_fired` - (опционально) 
+    - `traits` = {...} - массив ключей трейтов. (см `${GAME_ROOT}/common/country_leader/00_traits.txt`)
+    - `visible` = {...} - (опционально)
+    - `available` = {...} - (опционально)
+    - `cost` - (опционально)
+    - `removal_cost` - (опционально)
+    - `on_add` = {...} - (опционально)
+    - `on_remove` = {...} - (опционально)
+  - `country_leader = {...}`
+    - `ideology` - ключ суб-идеологии персонажа. (см `${GAME_ROOT}/common\ideologies\00_ideologies.txt`)
+    - `traits = {...}` - массив ключей трейтов. (см `${GAME_ROOT}/common/country_leader/00_traits.txt`)
+    - `expire` - строка с датой. Начало игры позже указанной даты уберёт возможность персонажа становления лидером (TODO: проверить)
+    - `id` - (опционально, устарело) можно поставить `-1` ;
+    - `desc` - (опционально) локализуемое описание персонажа;
+  - corps_commander = {...}
+    - TODO: 
+
 TODO