Disciples: Rebirth - Инструкции по созданию карт и модов для Disciples:Перерождение

В профилях, будь то профиль юнита, эффекта или предмета, везде используются одинаковые, перечисленные ниже, тэги. Эти же теги используются в текстовых описаниях (aka $(имя)).

Базовые статы

• str - сила
• spd - скорость
• dex - сноровка
• agi - ловкость
• vit - жизнь
• def - броня (защита от оружия)
• res - защита от магии

Производные статы

В профилях (в т.ч. и профилях юнитов) указанные тэги задают значение добавляемое к значению вычисленному из базовых статов.

• hp - здоровье
• dmg - сила атаки/лечения
• crit - шанс крита
• flee - шанс уворота
• ini - очки инициативы
• mov - очки хода по арене
• movwm - очки хода по глобальной карте
• ap - очки действия на арене
• cover - очки перехвата
• leadership - лидерство
• viewradius - радиус обзора
• reserve - ячеек резерва
• vampire - сила вампиризма
• dueling - шанс вызова на дуэль
• stealing - шанс успешной кражи
• recovery - автоматическое восстановление здоровья (в %% от максимального HP) каждый ход на глобальной карте
• discount - снижение цен в магазинах (в %%)
• bonusexp - дополнительный опыт за бой (в %% от начисленного при дележе опыта между юнитами)
• res_earth - защита от магии земли
• res_air - защита от магии воздуха
• res_water - защита от магии воды
• res_fire - защита от магии огня
• res_death - защита от магии смерти
• res_mind - защита от магии разума
• res_divine - защита от божественной магии
• res_slash - защита от рубящего оружия
• res_pierce - защита от колящего оружия
• res_blunt - защита от дробящего оружия

Модификаторы статов

Модификаторы используются при расчёте основного значения производных статов из базовых. Модификаторы так же как и статы могут меняться эффектами скилами и предметами. В профилях, модификаторы задаются в процентах, целыми числами: 1 это 1% и соответствует 0.01, 100 это 100% и соответствует 1.

• dmg_str_mod
• dmg_agi_mod
• crit_dex_mod
• crit_vit_mod
• flee_agi_mod
• flee_spd_mod
• hp_vit_mod
• hp_str_mod
• ini_spd_mod
• ini_dex_mod
• mov_mod
• movwm_mod
• cover_mod
• viewradius_mod
• recovery_mod
• discount_mod
• bonusexp_mod

Вычисление статов

Результирующее значение статов юнита вычисляется из его базовых статов (b), статов надетых на него предметов (i), его активированных скилов (s) и навешанных на него эффектов (e).
Вычисление базовых статов

Базовые статы просто складываются:

• X = Xb + Xi1 + ... + XiN + Xs1 + ... + XsN + Xe1 + ... + XeN

Вычисление множителей

Результирующее значение каждого множителя вычисляется по формуле (начиная с r3250):

• M = Mb + Mi1 + ... + MiN + Ms1 + ... + MsN + Me1 + ... + MeN

Вычисление производных статов

Для каждого производного стата своя формула отличающаяся набором базовых статов. В формулах используется результирующее значение базовых статов и множителей.

• Y = F(X..,M..) + Yb + Yi1 + ... + YiN + Ys1 + ... + YsN + Ye1 + ... + YeN

F(X..,M..) это функция базовых статов и множителей, и для каждого стата она своя. Остальное - прямые добавки к стату.

• dmg - str*dmg_str_mod + agi*dmg_agi_mod
• crit - dex*crit_dex_mod + vit*crit_vit_mod
• flee - agi*flee_agi_mod + spd*flee_spd_mod
• hp - vit*hp_vit_mod + str*hp_dtr_mod
• ini - spd*ini_spd_mod + dex*ini_dex_mod + 8
• mov - (str + dex) * mov_mod
• movwm - (spd + dex) * movwm_mod
• cover - (agi + vit) * cover_mod
• viewradius - (agi + str) * viewradius_mod
• recovery - (vit + spd) * recovery_mod
• discount - (str + spd) * discount_mod
• bonusexp - (dex + agi) * bonusexp_mod

Для остальных производных статов F() тождественно равна 0, и их значение определяется только добавкой.
Вычисление резистов

Резисты к магии вычисляются из суммы res и res_стихия. Для брони, по аналогии, def и res_урон. Исключение: divine для неё не учитывается базовый res, только res_divine.

Эффект это некое действие осуществляемое над юнитом как результат работы скилла, спелла или используемого (но не надеваемого) предмета (зелья или руны). Таким действием может быть изменение статов или какое то специальное действие типа телепортации или воскрешения. Эффект может быть кратковременным (мгновенным), или продолжительным (в т.ч. вечным), в этом случае он после применения остаётся "висеть" на юните до окончания срока действия. Длительными может быть только изменение статов, регенерация (regen) и отравление (curse). Один эффект может производить сразу несколько различных действий, например, менять сразу несколько статов, или вылечить юнита перед телепортацией и т. п. Однако не всякая комбинация действий будет работать
Действия

В профилях эфектов могут присутствовать все те же тэги, что указаны в Статы, в этом случае эффект будет менять значение стата(ов) (пока он висит на юните). Кроме этого эффект может выполнять дополнительные действия:

• towndef N - увеличение def цели на N, но не более чем до 90
• heal N - изменение hp на N
• heal_per P - изменение hp на P*hp/100
• regen N - изменение hp на N каждый ход
• regen_pow P - изменение hp на P*dmg/100 каждый ход
• damage N - нанесение урона на N
• damage_per N - нанесение урона на N% от максимального здоровья жертвы
• attack_pow P - нанесение урона на P*dmg/100
• curse N - нанесение урона на N каждый ход
• curse_pow P - нанесение урона на P*dmg/100 каждый ход
• resurrect N - воскрешение юнита с N hp
• exp N - добавить N опыта
• openfog N - открыть туман в радиусе N
• retreat - побег
• morph - превращение
• teleport - телепортация себя
• teleport_target - телепортация другого юнита
• summon S - призыв указанного существа
• resource_gold N - дать золота
• resource_stone N - дать камня
• getskills - дать очки для изучения скилов
• c_cover N - изменить текущее кол-во очков прикрытия
• c_mov N - изменить текущее кол-во очков хода на арене
• c_movwm N - изменить текущее кол-во очков хода на карте
• c_ini N - изменить текущее кол-во очков инициативы
• c_ap N - изменить текущее кол-во очков действия
• def_per P - изменить def на P*def/100
• dmg_per P - изменить dmg на P*dmg/100
• shadowstep -
• immune_phys_damage - иммунитет к физическому урону
• ignore_def - отключает def (весь) у цели
• ignore_res - отключает res (весь) у цели
• paralize - парализует цель
• dispell - снимает эффекты
• dispell_buffs - снимает положительные эффекты
• dispell_debuffs - снимает отрицательные эффекты
• push - толкнуть врага
• delete_wall - удаление стены
• doppel - превращение в другое существо по выбору
• steal - кража
• duel - дуэль
• resurrect_mode
• resource_item
• morphed
• stop
• battleout

Все эти действия, кроме curse* и regen*, являются мгновенными (срабатывают один раз при применении эффекта), даже если duration эффекта не равен 0.
Длительность эффекта

Длительность действия эффекта задаётся одним из тэгов:

• duration_turns N - эффект действует N ходов на арене.
• duration_days N - эффект действует N ходов на глобальной карте.
• remove_immediately - эффект снимается сразу в конце хода юнита на арене.

Вместо N можно указать слово permanent (или -1), означающее что эффект должен длится неограниченное число ходов.
Если задан duration_days, то эффект может накладываться как на глобальной карте так и на арене. Если эффект не мгновенный, то будучи наложенным на юнита, на арене он будет длится весь бой. При выходе с арены он не снимается, и будет висеть на юните оставшееся кол-во ходов. Если задан permanent, то это вечный эффект, который может быть снять только disspel'ом.
Если задан duration_turns, то эффект должен накладываться только на арене. Если указано permanent, то эффект будет действовать до конца боя. Зелья с эффектом duration_turns 0, являются мгновенными, как и duration_days 0, но использоваться могут только на арене. Все эффекты с duration_turns снимаются в конце боя.
Если ни какой duration_* не задан, то это эквивалентно duration_days 0
Stackable

По умолчанию, эффект может висеть на юните только в одном экземпляре. При попытке повесить ещё один такой же эффект, старый экземпляр удаляется. Для того чтобы указать, что эффект можно вешать на юнита неограниченное кол-во раз нужно в его профиле написать:

• stackable 1;

Невидимые эффекты

Если на юнита повесить эффект у которого не задана иконка, то он не будет отображаться в инфе о юните и не будут показываться значки баффа/дебаффа.

Don't Dispell

Флаг dontdispell в профиле эффекта указывает на то, что данный эффект не будет сниматься при применении эффектов dispell.
Добавление скилов

Накладываемый эффект может добавлять юниту скилл, для чего предназначен тэг:

• add_skill "имя скила"

Скилл будет у юнита всё время пока на нём висит эффект добавивший скилл (поэтому делать у такого эффекта duration 0 бессмысленно).
Для добавляемого скила можно задавать кол-во зарядов (использований) тэгом:

• add_skill_uses N

По умолчанию, кол-во использований бесконечно. Добавленный эффектом скилл, если эффект длиться больше одного боя, перезаряжается в начале боя как и "врождённый" скилл.
Таким образом можно делать банки добавляющие скилы и даже скилы добавляющие скилы (себе или другому юниту). Так же можно делать надеваемые предметы которые добавляют скилл, но это делается уже через профиль предмета, а не эффекта.

Предметы делятся на три типа: надеваемые (одежда, оружие, модные стильные аксессуары), используемые (зелья и руны) и бесполезные (драгоценности).

Действие используемого предмета осуществляется через эффект который указывается тэгом game_effect. Использовать предмет можно на любом юните в отряде.

Действием надеваемого предмета может быть изменение статов, добавление скила или установка флага на арене. Изменяемые статы указываются непосредственно в профиле предмета тэгами аналогичными для статов. Действие надеваемого предмета заканчивается как только предмет снимается. Действие надеваемых предметов, в общем, ни как не привязано к классу, за исключением banner'ов которые всегда ставят флаги/тотемы на арене. Надевать предметы может только лидер.

Тэги

Профили предметов лежат в папке Resources/Profiles/items.

• id - Уникальный идентификатор.
• nameid strid - названия
• effectdescid strid - описания действия и параметров. Если не задано, описание будет сгенерёно автоматически.
• descid strid - художественного описания (в нём НЕ описываются параметры и характеристики предмета).
• class - Класс предмета.
• icon - Иконка предмета для инвентаря.
• replace - Заменяемая часть модели при надевании
• proxy - Это волшебный proxy предмет при подборе заменяемый на случаный того же класса и уровня, что сам прокси.
• gold_cost - Базовая стоимость предмета.
• story - Это сюжетный предмет.
• unic - Это уникальный предмет.
• target - Для рун и банок указывает цель на которую предмет должен применяться.
• level - Уровень предмета для выборки.
• game_effect - Эффект накладываемый на цель при использовании предмета.
• require_skill - Скилл юнита требуемый для использования.
• banner_profile - Имя профиля флага/тотема
• add_skill - Скилл дающийся юниту при надевании предмета.
• add_skill_uses - Кол-во зарядов для add_skill. Если не задано, то бесконечно.
• race - Раса. Используется только в редакторе карт для группировки предметов в списках.

Кроме того, для надеваемых предметов можно (и нужно) использовать все теги статов.

Классы

От класса зависит является ли предмет надеваемым (шмотка) или используемым (банка,руна), а так же куда именно он должен надеваться. Класс предмета задётся тэгом

class "класс"

• weapon Оружие. Надевается.
• head Шлем. Надевается.
• body Доспехи. Надевается.
• accessory Наручи вместе с перчатками. Надевается.
• footgears Штаны и ботинки. Надевается.
• ring Кольцо. Надевается.
• talisman Талисман. Надевается.
• book Книга. Надевается.
• banner Флаг/тотем. Надевается.
• potion Банка. Используется на глобальной карте и арене.
• rune Руна. Используется на арене.
• gem Драгоценность. Предмет для продажи.

Изменение модели юнита

Для указания, что и как должно меняться на модели юнита при надевании предмета предназначен тэг replace. Если надо заменить часть юнита на модель из его же сета (описанного в char-файле), синтаксис такой:

replace "" set
Если же часть юнита надо заменить на уникальную модель не записанную в сете, то запись примет вид:
replace "" scene ""
Можно задавать несколько replace в одном предмете. Параметр body_part ни как не завязан на класс предмета и может быть любым из возможных. Если на юнита надето несколько предметов меняющих один и тот же body_part, но разных сетов, то в результате будет отображаться часть от высшего сета. Если же в одном из предметов задана уникальная модель, то она будет иметь наивысший приоритет. Результат экипировки двух предметов, меняющих часть юнита на уникальную модель, не определён, так что лучше подобных предметов не делать. Ограничение использования.

Можно ограничить возможность надевать/использовать предмет только юнитами имеющими определённый скилл (скил должен быть выучен). Для указания требуемого скила существует тэг require_skill:

• require_skill "" Добавление скилов

Надеваемый предмет может добавлять юниту скилл (при надевании), для чего предназначен тэг:

add_skill "id_скила" Скилл будет у юнита всё время пока на нём надет предмет его добавивший.
Для добавляемого скила можно задавать кол-во зарядов (использований) тэгом:

add_skill_uses N Добавленный скилл перезаряжается в начале боя как и "врождённый".
Proxy

Если в профиле предмета указан волшебный тэг proxy, и такой предмет положен в сундук, то, когда юнит откроет этот сундук, он получит вместо этого прокси некий рандомный предмет заданного в прокси класса и уровня. Proxy может использоваться не только с сундуками, но и добавлятся в профиль магазина, в этом случае превращение proxy в нормальный предмет произойдёт при старте игры.
Примеры

Описание сетов Ламберта в story_lambert.char:

• set 1 { weapon "resourcesCharactersstorylambertweaponstory_lambert_set1_weapon.scene"; feet "resourcesCharactersstorylambertfeetstory_lambert_set1_feet.scene"; body "resourcesCharactersstorylambertbodystory_lambert_set1_body.scene"; head "resourcesCharactersstorylambertheadstory_lambert_set1_head.scene"; legs "resourcesCharactersstorylambertlegsstory_lambert_set1_legs.scene"; arms "resourcesCharactersstorylambertarmsstory_lambert_set1_arms.scene"; hands "resourcesCharactersstorylamberthandsstory_lambert_set1_hands.scene"; } set 2 { weapon "resourcesCharactersstorylambertweaponstory_lambert_set2_weapon.scene"; feet "resourcesCharactersstorylambertfeetstory_lambert_set2_feet.scene"; body "resourcesCharactersstorylambertbodystory_lambert_set2_body.scene"; head "resourcesCharactersstorylambertheadstory_lambert_set2_head.scene"; legs "resourcesCharactersstorylambertlegsstory_lambert_set2_legs.scene"; arms "resourcesCharactersstorylambertarmsstory_lambert_set2_arms.scene"; hands "resourcesCharactersstorylamberthandsstory_lambert_set2_hands.scene"; } set 3 { weapon "resourcesCharactersstorylambertweaponstory_lambert_set3_weapon.scene"; feet "resourcesCharactersstorylambertfeetstory_lambert_set3_feet.scene"; body "resourcesCharactersstorylambertbodystory_lambert_set3_body.scene"; head "resourcesCharactersstorylambertheadstory_lambert_set3_head.scene"; legs "resourcesCharactersstorylambertlegsstory_lambert_set3_legs.scene"; arms "resourcesCharactersstorylambertarmsstory_lambert_set3_arms.scene"; hands "resourcesCharactersstorylamberthandsstory_lambert_set3_hands.scene"; } Сетовое оружие:
• id "singing_and_dansing_sword"; name "Меч Песни и Пляски"; level 1; dex 1; str 1; gold_cost 250;icon "ResourcesCharactersElvesLeader-ForestliegeWeaponelves_leader-forestliege_set2_weapon.t"; class "weapon"; replace "weapon" set 2;

При экипировке на Ламберта, модель его меча изменится на меч прописанный в его 2-ом сете. При экипировке на эльфийского Незрячего стража, аналогично, модель его лука заменится на модель лука из его 2-ого сета. Уникальный меч:

• id "pisec_dubina"; name "Писец-Дубина"; level 1; str 1; gold_cost 250; icon "ResourcesCharactersDemonsLeader-DukeWeapondemons_leader-duke_set2_weapon.t"; class "weapon"; replace "weapon" scene "ResourcesCharactersDemonsLeader-DukeWeapondemons_Leader-Duke_set2_weapon.scene"; require_skill "n_skill_dex"

Этот предмет у любого юнита меняет модель оружия на указанную в самом предмете, а не в сете юнита. Но при этом, надевать его могут, только те у кого изучен скил n_skill_dex.

Флаги описываются в профиле предмета в секции banner_profile (см. профили itemsbanner_*.item).
В секции указывается сцена флага banner_scene, сцена аналогична сцене юнита, должна иметь две анимации Idle (обычное колыхание) и Attack (колыхание в момент хода флага). Анимация Attack должна иметь событие FxStrike где-то в середине-конце, по которому и будет происходить атака. С начала анимации до этого события камера показывает флаг, после события - возвращается общий вид арены. FX который должен проиграться на самом флаге во время атаки задаётся тэгом fxcast.
В секции могут быть указаны свойства флага, идентификаторы:


Также в секции могут быть указаны действия флага:


Действий на ходе может быть несколько, тогда они будут выполняться одновременно.
После идентификатора действия указывается в кавычках цель и параметры действия, их кол-во и назначение зависит от цели.

Цели:

После таких целей указывается имя эффекта, накладываемого на юнита, например:

• "field_center" - центр поля 4х3,
• "field_random" - случайные 9 гексов

После таких целей указывается имя эффекта, накладываемого на юнита, если он находится в гексе, и имя сцены спецэффекта, который проигрывается при атаке гекса. В спецэффекте должно быть событие Damage по которому и будет накладываться эффект. Например:
turn_action "field_random" "BannerCastField" "ResourcesFXArena_spellsdemonsModeusfx_demons_modeus_spell.scene"

"summon_wall" - создание стены из юнитов, после указывается имя профиля юнита и имя сцены спецэффекта, который проигрывается при создании, например:

"teleport" - телепорт всех юнитов на арене, после - имя сцены спецэффекта, который проигрывается при перемещении юнита, например:

Флаги располагаются либо в углах сетки гексов, либо в специально указанных гексах с атрибутами "player_banner" и "npc_banner" в объекте "hexinfo" (аналогично местам юнитов с атрибутами "player" и "npc").
Для подсветки гексов для "Жаровня Подземных Миров" и "Алтарь Шторма" используется объект "Banner" сцены

• ResourcesFXLandFXarena_grid_cell.scene.