S.T.A.L.K.E.R. Inside Wiki - Вклад участника [ru]

Настройка логики. Часть 3

2017-01-06T09:11:03Z

Losiara: /* Пример достаточно сложной логики */

{{Шаблон:Настройка логики}}

=Скрипт logic=

Скрипт '''''logic''''' управляет переключением схем. 
В '''''custom_data''''' любого персонажа (кроме свободных) должна присутствовать секция '''''[logic]'''''. 

Функции, на которые ссылается секция '''''[logic]''''' должны находится в файлах ''gamedata\scripts\xr_effects.script'' или ''gamedata\scripts\xr_conditions.script''. 

В секции должно присутствовать одно из полей: 
:*'''''active = <название_схемы>''''' - активная схема, запускающаяся первой. 
:*'''''cfg = <имя_ltx_файла_с_настройками>''''' - способ задавать логику персонажа, вынося её во внешний файл (путь учитывается относительно папки ''gamedata\config\scripts''). 

Пример. Настройки простого '''''walker''''':<ini>[logic]
active = walker

[walker]
path_walk = walk1
path_look = look1</ini>

Переключение схем выполняется с помощью дополнительных условий схемы '''''logic''''', которые прописываются в секции текущей активной схемы. Существуют следующие условия переключения: 
:*'''''on_actor_dist_le = <number>|<название_схемы>''''' - если дистанция в метрах до игрока меньше либо равно '''''number'''''. 
:*'''''on_actor_dist_le_nvis = <number>|<название_схемы>''''' - если дистанция в метрах до игрока меньше либо равно '''''number''''' без проверки на видимость. 
:*'''''on_actor_dist_ge = <number>|<название_схемы>''''' - если дистанция в метрах до игрока больше '''''number'''''. 
:*'''''on_actor_dist_ge_nvis = <number>|<название_схемы>''''' - если дистанция в метрах до игрока больше '''''number''''' без проверки на видимость. 
:*'''''on_signal = <имя_сигнала>|<название_схемы>''''' - срабатывает по приходу сигнала '''''имя_сигнала''''' от текущей активной схемы. 
:*'''''on_info = <название_схемы>''''' - срабатывает всегда. 
:*'''''on_timer = <number>|<название_схемы>''''' - срабатывает через '''''number''''' миллисекунд после включения схемы. 
:*'''''on_game_timer = <number>|<название_схемы>''''' – срабатывает через '''''number''''' секунд игрового времени, после включения схемы. 
:*'''''on_actor_in_zone = <имя_зоны>|<название_схемы>''''' – если актер в находится в указанной зоне (указывается имя рестриктора). 
:*'''''on_actor_not_in_zone = <имя_зоны>|<название_схемы>''''' – если актер не в указанной зоне (указывается имя рестриктора). 
:*'''''on_npc_in_zone = <number>|<имя_зоны>|<название_схемы>''''' – если NPC со '''''story_id''''' равному '''''number''''', в указанной зоне. 
:*'''''on_npc_not_in_zone = <number>|<имя_зоны>|<название_схемы>''''' - если NPC со '''''story_id''''' равному '''''number''''', не в указанной зоне. 
:*'''''on_actor_inside = <название_схемы>''''' - зона проверяет, находится ли игрок внутри нее (используется со '''''space_restrictor'''''). 
:*'''''on_actor_outside = <название_схемы>''''' - зона проверяет, находится ли игрок за ее пределами (используется со '''''space_restrictor'''''). 

'''''Примечание''''': если происходит переключение между несколькими одноименными схемами (например несколькими '''''walker'''''), то их можно нумеровать: '''''walker1''''', '''''walker2''''', хотя предпочтительнее через символ ''''@'''<nowiki>'</nowiki> давать более информативные названия: '''''walker@day''''', '''''walker@alarm''''' и т.д. 

C любыми из вышеперечисленных параметров можно работать следующим образом: 
'''''on_info = {…} %…%''''' 
'''''on_info2 = {…} %…%''''' 
'''''on_info3 = {…} %…%''''' 
и так далее до посинения 

А также условия для переключения на описанные выше секции. 
'''''combat_ignore_cond = ''''' 
'''''on_hit =''''' 
'''''on_death =''''' 
'''''on_combat =''''' 
'''''on_use =''''' 

==Синтаксис скрипта Logic==

Для того, чтобы персонаж ходил по пути '''''walk1''''', а при приближении игрока на дистанцию 5 метров, переключался на путь '''''walk2''''' (но только при условии, что он видит игрока), нужно написать следующее: <ini>[logic]
active = walker@first

[walker@first]
path_walk = walk1
path_look = look1
on_actor_dist_le = 5 | walker@second

[walker@second]
path_walk = walk2
path_look = look2</ini>
Выше рассмотрено безусловное переключение секций. 
Перед именем секции в фигурных скобках '''''{}''''' можно задавать дополнительные '''''условия''''', а после имени секции - так называемые "'''''эффекты'''''", которые заключить в знаки процента '''''%%'''''. Эффекты будут применены только в случае выполнения условий, если таковых нет то эффект выполнится безусловно. 
Можно не задавать переход на другую схему указывая её имя, а задать только условия и/или эффекты. Тогда активной останется действующая схема, но условия и эффекты будут все равно обработаны. Если все условия в фигурных скобках не выполняются, схема активирована не будет. 

'''''Пример''''':<ini>on_actor_dist_le = 5 | {условие} walker@second %эффекты%</ini>
Условия могут быть следующими: 
:*'''''+infoportion''''' - требуется присутствие инфопорции "'''''infoportion'''''" у актора; 
:*'''''-infoportion''''' - требуется отсутствие инфопорции "'''''infoportion'''''" у актора; 
:*'''''=function''''' - требуется, чтобы функция "'''''function'''''" вернула '''''true'''''; 
:*'''''!function''''' - требуется, чтобы функция "'''''function'''''" вернулся '''''false'''''; 
:*'''''~number''''' - вероятность выполнения условия. 

Эффекты могут быть следующими: 
:*'''''+infoportion''''' - в случае включения секции у актора будет установлен инфопорция "'''''infoportion'''''"; 
:*'''''-infoportion''''' - в случае включения секции у актора будет убрана инфопорция "'''''infoportion'''''"; 
:*'''''=function''''' - в случае включения секции стартует функция "'''''function'''''". 

'''''Примечание''''': для условия переключения схемы '''''{~number}''''' определён следующий расчёт: 

:'''''number''''' сравнивается со случайным числом в диапазоне от 1 до 100, если '''''number''''' больше, то считается, что условие вернуло истину, например:
:<ini>on_actor_in_zone = restrictor_name | {~30} walker@second</ini>
:Если условий несколько, например:
:<ini>on_actor_dist_le = 5 | {~20} walker@second, {~55} walker@third, walker@fourth</ini>
:В таком случае, переход на схему '''''walker@second''''' произойдёт с вероятностью 20%, на схему '''''walker@third''''' с вероятностью 55-20=35% и на схему '''''walker@fourth''''' с оставшейся вероятностью 100-55=45%. 
:Условия в данном случае необходимо выставлять исключительно в порядке возрастания. 
:Неудачный пример:
:<ini>on_actor_dist_le = 5 | {~40} walker@second, {~25} walker@third, walker@fourth</ini>
:Здесь переход на схему '''''walker@third''''' никогда не будет определён, а вероятность перехода на схему '''''walker@fourth''''' составит 60%. 

'''''Примечание''''': несколько условия или эффектов разделяются пробелами:<ini>on_actor_dist_le = 5 | {+info_1 -info_2 +info_3} walker@second %+info_4 =func%</ini>

Можно задавать сразу несколько секций, разделенных запятыми. Порядок обхода при этом - слева направо. После срабатывания первого из условий, обход прекращается. В примере ниже, если установлен '''''info_1''''', будет включена схема '''''walker@second''''', иначе, если установлен '''''info_2''''', будет включена схема '''''walker@third''''', иначе будет включен '''''walker@fourth''''':<ini>on_actor_dist_le = 5 | {+info_1} walker@second, {+info_2} walker@third, walker@fourth</ini>

В описанном выше поле '''''active''''' секции '''''logic''''', можно также задавать условия, например:<ini>[logic]
active = {=actor_friend} walker@friendly, walker@enemy</ini>

В логических условиях теперь принимается ключевое слово '''''never''''', которое означает, что условие ложно. Например:<ini>
combat_ignore_cond = {=actor_enemy =actor_has_suit} always, {=actor_enemy} never %=gar_dm_bandits_fight%</ini>
Вышеприведенная конструкция включает игнорирование боя, если у NPC враг игрок в костюме, но отключит его, если врагом является игрок, но без костюма, при этом сработают эффекты (%%) секции '''''never'''''. Таким образом, выбор секции '''''never''''' равносилен отсутствию секции (несрабатыванию условия), но эффекты в знаках процента при этом срабатывают. 

Пример работы с секцией '''''nil'''''.
Секция '''''nil''''' выводит из-под скриптовых схем персонажа, монстра или объект и отпускает его под управление движка. Это надо если какое-либо условие выполнившись один раз больше не нуждается в проверке, при этом экономятся ресурсы машины, которые на каждом апдейте проверяют это условие. Например:<ini>[logic]
active = sr_idle

[sr_idle]
on_actor_inside = nil %+esc_actor_inside%</ini>
То есть, при входе актера в рестриктор выдается инфопорция и рестриктор уходит в секцию '''''nil''''', больше не проверяя наличие игрока. 

'''''Примечание''''': обратно из секции '''''nil''''' под скрипты объект вернуть уже невозможно! Учитывайте это, используя ее.

==Пример достаточно сложной логики==
<ini>[logic]
active = walker
combat_ignore = combat_ignore
on_hit = hit
on_death = death

[hit]
on_info = %+alert%

[death]
on_info = %+alert +trup3%

[walker]
path_walk = walk_svoboda3
path_look = look_svoboda3
combat_ignore_cond = {-alert}
on_timer = 25000 | remark

[remark]
anim = idle
snd = stalker_talk_kampfire
no_move = true
no_rotate = true
combat_ignore_cond = {-alert}

[combat_ignore]</ini>
Рассмотрим ее пошагово. 
Вначале сталкер работает по схеме '''''walker'''''. При этом он игнорирует бой, пока не будет поставлен инфопоршн '''''alert''''. Он ждет 25 секунд, после чего переходит в схему '''''remark'''''. В ремарке он проигрывает анимацию '''''idle''''', говорит на указанные темы, не поворачивается и не двигается и точно также игнорирует бой. Если по нему попадут ('''''on_hit''''') или убьют ('''''on_death'''''), будет поставлен инфопоршн '''''alert''''' и он перестанет игнорировать бой (понятно, что если он будет трупом, то это ему не поможет, но их в сценке трое, и тогда сорвутся в бой все остальные). Если его убьют, то также будет поставлен инфопоршн '''''trup3''''' который сообщит о том, что этот NPC убит. 

А вот логика его противника:<ini>[logic]
active = walker
combat_ignore = combat_ignore

[walker]
path_walk = soldier_walk1
path_look = soldier_look1
combat_ignore_cond = always
team = assault_group
on_signal = assault | camper

[camper]
path_walk = soldier_walk1_2
path_look = soldier_look1_2
radius = 5
on_info = {+trup1 +trup2 +trup3} walker2

[walker2]
path_walk = soldier_walk1_3
path_look = soldier_look1_3

[combat_ignore]</ini>

Он идет в схеме '''''walker''''', игнорируя бой (причем игнорируя в любой ситуации). Идет в составе группы '''''assault_group'''''. Когда он приходит в конечную точку маршрута (там он синхронизируется с остальными из группы, это приписано в путях) и получает сигнал '''''assault''''', то переходит в схему '''''camper'''''. В этой схеме у него не прописан '''''combat_ignore''''', поэтому он начинает стрелять по противнику. После того, как все трое противников будут убиты, каждый из них, умирая ставит инфопоршн '''''trup1''''', '''''trup2''''' или '''''trup3''''' и когда все трое будут убиты, то он переключится на схему '''''walker2''''' (подойдет к костру). 

=Схемы логики space_restrictor=

'''''Общее замечание''''': Чтобы исключить ситуацию, когда актёр проскакивает через рестриктор и тот не успевает сработать, старайтесь ставить рестриктор так, чтоб минимальная ширина была больше 2 метров.

==Схема sr_idle==
Предназначение данной схемы – включить другую схему при срабатывании одного из стандартных условий логической схемы. 
Сама по себе схема ничего не делает. 

'''[sr_idle]''' 
'''''on_actor_inside = nil %+esc_actor_inside%''''' 

Обратите внимание, что после срабатывания проверки активная схема переключается в '''''nil''''', чтобы не продолжать бесполезную проверку на каждом апдейте. Можно не задавать '''''nil'''''. 
Часто эта схема работает вместе со спавнером, рестриктор выдает инфопоршн, при входе в зону, а спавнер по нему уже кого-то спавнит. 

'''''Пример использования схемы''''':<ini>[logic]
active = sr_idle

[sr_idle]
on_actor_inside = {+val_raid_start -esc_return -esc_trader_speak} nil %=esc_return_dv +esc_return +esc_trader_speak%</ini>

файл ''gamedata\scripts\sr_idle.script''

==Схема sr_no_weapon==
Данная схема убирает оружие у игрока при входе в зону. 

'''[sr_no_weapon]''' 

'''''Пример использования схемы''''':<ini>[logic]
active = sr_no_weapon

[sr_no_weapon]</ini>

файл ''gamedata\scripts\sr_no_weapon.script''

==Схема sr_sound==

Схема предназначена для отыгрывание звука при входе актора в '''''space_restrictor'''''. 

'''[sr_sound]''' 
'''''snd = <путь_звукового_файла>''''' - перечень имён звуков разделенных запятыми (путь учитывается относительно папки ''gamedata\sounds''). 
'''''type = <параметр>''''' - типы звуков через запятые. Для удобства введены типы наборов звуков в таблице '''''sound_types''''' управляющего файла. Всего их три: 
:*'''''floor_wooden'''''; 
:*'''''rats_panic'''''; 
:*'''''random'''''. 
'''''delay = <number>''''' - задержка перед проигрыванием звука в секундах реального времени, по умолчанию 0. 
'''''idle = <number>''''' - длина периода игнорирования входа в зону после начала последнего проигранного звука.
:Чтоб, например, "завывание" было не чаще, чем раз в несколько минут. Указывается в секундах игрового времени. По умолчанию 0. 
'''''rnd = <number>''''' - вероятность (в процентах) того, что звук отыграется. По умолчанию 100. 
'''''position = <имя_пути>''''' - задает имя пути, в вершинах которого может отыграться звук.
:Есть зарезервированное значение '''''random'''''. Оно означает случайное место в радиусе от 15 до 50 метров от игрока. Если этот параметр не задан, то подразумевается позиция игрока. 
'''''slide_velocity = <number>''''' - скорость (м/с) передвижения звука по точкам патрульного пути. По умолчанию - 3. 
'''''slide_sound_once = true\false''''' - в случае значения '''''true''''' - проиграть звук один раз, даже если он не дошел до последней точки пути,
:иначе если '''''false''''' – и если звук закончился, а до последней точки пути не дошел, запустить его ещё раз. По умолчанию '''''false'''''. 
'''''play_at_actor = true/false''''' - заставляет звук играться от позиции актера постоянно.
:Если он будет равен '''''true''''' и будет задан путь перемещения звука (или рандом), то мы тупо вылетим. 

Поддерживается сигнал '''''sound_end'''''. 

Обязательно нужно задать либо '''''snd''''', либо '''''type'''''. Можно их задать вместе. На базе этих параметров составляется список звуков. При входе актора в рестриктор отыгрывается случайный звук из этого списка. 

'''''Пример использования схемы''''':<ini>[logic]
active = sr_idle

[sr_idle]
on_actor_inside = sr_sound@shooting

[sr_sound@shooting]
snd = characters_voice\scenario\garbage\grey_grey_1
play_at_actor = true
on_signal = sound_end| nil
on_timer = 20000| nil</ini>

Есть возможность сделать «скользящий звук». Необходим патрульный путь. Звук начинает отыгрываться с начала пути и перемещается от одной точки пути к другой (по мере их установки на патрульном пути) со скоростью '''''slide_velocity'''''. Пример:<ini>[logic]
active = sr_sound

[sr_sound]
type = random
position = way
slide_velocity = 8
slide_sound_once = true</ini>

Файл ''gamedata\scripts\sr_sound.script''

==Схема sr_tip==
Предназначение данной схемы – давать игроку сообщение (подсказку) при входе в рестриктор. 

'''[sr_tip]''' 
'''''name = <имя_текса>''''' - строка с '''''id''''' текста зарегистрированного в папке ''gamedata\config\text''. 
'''''type = news/tips''''' - параметр рудиментарный и не на что не влияет. 
'''''sender = <параметр>''''' - задаёт условный строковый идентификатор иконки персонажа, от которого якобы пришло сообщение.
:По умолчанию это иконка торговца. Возможны следующие значения: '''''default, trader, dolg, freedom, ecolog, arena, stalker, krot, barman, wolf, o_soznanie, monolith, saharov, prizrak, killer'''''. 
'''''cond = {+info -info =func !func ~number}''''' - необходимые логические условия, при которых подсказка сработает. По дефолту, сработает при входе в зону. 
'''''single = true/false''''' - если параметр в '''''true''''', то типс будет выдан только один раз. По умолчанию '''''false'''''. 
'''''timeout = <number>''''' - задержка вывода сообщения в секундах. По умолчанию - 0. 
'''''showtime = <number>''''' - время показа сообщения на экране. Задаётся в милисекундах. По умолчанию - 5000. 

Поддерживается сигнал '''''tip_sended''''', только в случае установленного параметра '''''single'''''. 

'''''Пример использования схемы''''':<ini>[logic]
active = sr_idle

[sr_idle]
on_actor_inside = sr_tip

[sr_tip]
name = rad_barman_spam
type = tips
cond = {+bar_deactivate_radar_done}
sender = barman
on_actor_inside = nil
showtime = 25000</ini>

файл ''gamedata\scripts\sr_tip.script''

==Схема sr_light==
Зона, управляющая вкл\откл фонариков NPC.

'''[sr_light]''' 
'''''light_on = true/false''''' - свет включен/выключен. 

'''''Пример использования схемы''''':<ini>[logic]
active = sr_light

[sr_light]
light_on = true</ini>

Файл: ''gamedata\scripts\sr_light.script''

==Схема sr_territory==

Занимается эта схема тем, что отлавливает всякие события, происходящие внутри рестриктора.
Пока что она отлавливает только хиты и смерть NPC. 

'''[sr_territory]''' 
'''''territory_hit = {+info -info =func !func ~number} %+info -info =func%''''' - эффекты, которые произойдут при нанесении хита от актора, будучи в этой зоне. 
'''''territory_death = {+info -info =func !func ~number} %+info -info =func%''''' - эффекты, которые произойдут при смерти от "рук" актора, будучи в этой зоне. 

Поскольку схема работает только с игроком – то хиты и смерть засчитываются только от игрока. 

'''''Пример использования схемы''''':<ini>[logic]
active = sr_territory@1

[sr_territory@1]
territory_death = sr_idle@1 %+bar_arena_territory_death%</ini>

Файл: ''gamedata\scripts\sr_territory.script''

==Схема sr_mapspot==
При входе в рестриктор он сам себя подсвечивает на карте. 

'''[sr_mapspot]''' 
'''''hint = <имя_текса>''''' - строка с '''''id''''' текста зарегистрированного в папке ''gamedata\config\text''. 
'''''location = <имя_метки>''''' - имя типа метки, зарегистрированное в файле ''config\ui\map_spots.xml'' и всех, что в него включены инклюдами. По умолчанию - '''''crlc_small'''''. 

'''''Пример использования схемы''''':<ini>[logic]
active = sr_idle

[sr_idle]
on_actor_inside = sr_mapspot

[sr_mapspot]
hint = gar_swamp
location = crcl_big</ini>

Файл: ''gamedata\scripts\sr_mapspot.script''

==Схема sr_particle==
Данная система отыгрывает партиклы, как статичные, так и движущиеся, в указанном месте и в указанное время. 

'''[sr_particle]''' 
'''''name = <имя_партикла>''''' - путь до партикла относительно файла ''particles.xr''. 
'''''path = <имя_пути>''''' - точки движения партикла. Возможны два случая:
:#Когда указывается путь анимации камеры (путь учитывается относительно папки ''gamedata\anims''); 
:#Когда указывается имя патрульного пути. 
'''''mode = <параметр>''''' - параметр обязательный и имеет два значения:
:* 1 - устанавливается в случае указания анимации камеры для параметра '''''path'''''; 
:* 2 - устанавливается в случае указания патрульного пути для параметра '''''path'''''. 
'''''looped = true/false''''' - флаг зацикленности партиклов. 

'''''Примечание''''': для пути движения партикла, когда установлена анимация движения камеры, для имени файла необходимо ставить расширение '''''.anm''''' (например ''arena.anm''). 

Поддерживается сигнал '''''particle_end'''''.

В вейпоинтах патрульного пути можно задавать флаги: 
:*'''''s=<название_звуковой_темы>''''' - звук проигрываемый во время движения; 
:*'''''d=<number>''''' - время задержки перед проигрыванием, задается в миллисекундах. По умолчанию - 0. 

При '''''looped = true''''', по окончании проигрывания партиклов, они будут запускаться сначала, но уже без задержек. Сигнал '''''particle_end''''' выдаваться не будет. 
При '''''looped = false''''' сигнал будет выдан, когда все источники партиклов отыграют. 

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

'''''Пример использования схемы''''':<ini>[logic]
active = sr_idle

[sr_idle]
on_info = {+sar_mon_poltergeist_1_spawn} sr_particle

[sr_particle]
name = anomaly2\gravity_blast_03
path = sar_poltergeist_1_way
mode = 2
looped = false
on_signal = particle_end | sr_idle@2</ini>

Файл: ''gamedata\scripts\sr_particle.script''

==Схема sr_sound_act==
Схема играет звук в голове актера. Всякие там переговоры по ПДА и прочие фейки.

'''[sr_sound_act]''' 
'''''snd = <путь_звукового_файла>''''' - имя звукового файла относительно папки ''gamedata\sounds''. 
'''''delay = <number>''''' - задержка перед проигрыванием. По умолчанию - 0. 
'''''delay_max = <number>''''' - между проигрыванием звука будет взят случайный промежуток между '''''delay''''' и '''''delay_max'''''. 
'''''theme = <название_звуковой_темы>''''' - имя темы из файла ''sound_theme.script''. 
'''''stereo = true/false''''' - при установке этого параметра к файлу, который задан параметром '''''snd''''' или в звуковой теме,
:автоматически будут добавляться суффиксы '''''_r''''' и '''''_l''''' для загрузки левого и правого каналов и, соответственно, всё это будет проигрываться. 

Поддерживается сигнал '''''sound_end'''''.

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

'''''Пример использования схемы''''':<ini>[logic]
active = sr_idle

[sr_idle]
on_actor_inside = sr_sound_act

[sr_sound_act]
theme = sar_monolith_call
delay = 10000
delay_max = 15000
stereo = true
on_info = {+sar2_monolith_miracle} sr_idle@end</ini>

Файл: ''gamedata\scripts\sr_sound2d.script''

==Схема sr_timer==
Схема использовать для производства каких либо действий в зависимости от состояния таймера.

'''[sr_timer]''' 
'''''type = dec/inc''''' - тип счётчика.
:*'''''dec''''' - декриментирующий, т.е. обратный отсчёт; 
:*'''''inc''''' - инрементирующий, т.е. отчёт по возрастанию. 
'''''start_value = <number>''''' - начальное значение счетчика в реальных миллисекундах.
:Для декриментирующих счетчиков задавать обязательно. Для инкриментирующих, если не задано, то считается с 0. 
'''''on_value = <number>|%+info -info =func% <название_схемы>''''' - производит действие в зависимости от состояния счётчика. 
'''''string = <имя_текса>''''' - строка с '''''id''''' текста зарегистрированного в папке ''gamedata\config\text''.

'''''Пример использования схемы''''':<ini>[logic]
active = sr_idle

[sr_idle]
on_actor_inside = sr_timer@1

[sr_timer@1]
type = dec
start_value = 1000000
on_value = 5 | %=play_snd(characters_voice\scenario\radar\rad_hat_2)% | 0 | nil %=aes_kill_actor%
on_actor_outside = sr_idle
on_info = {+bar_deactivate_radar_done} nil
string = st_helmet_countdown</ini>

Файл: ''gamedata\scripts\sr_timer.script''

==Схема sr_psy_antenna==
Зоны с такой секцией позволяют управлять эффектами от пси-воздействия (на Янтаре и Радаре). Сейчас можно управлять интенсивностью излучения и интенсивностью получения повреждений. 

'''[sr_psy_antenna]''' 
'''''eff_intensity = <number>''''' - увеличение/уменьшение в процентах от базового значения интенсивности излучения. 
'''''hit_intensity = <nymber>''''' - увеличение/уменьшение в процентах от базового значения наносимого повреждения. 
'''''phantom_prob = <nymber>''''' - вероятность проявления фантомов в процентах. По умолчанию - 0. 
'''''postprocess = <имя_постэффекта>''''' - файл постэффекта, относительно папки ''gamedata\anims''. Расширение ставить обязательно! По умолчанию - ''psy_antenna.ppe''. 
'''''mute_sound_threshold = <number>''''' - предел до которого можно занижать звук уровня. 0 - глушит полностью, стоит по умолчанию. 

'''''Пример использования схемы''''':<ini>[logic]
active = sr_psy_antenna@good_helmet

[sr_psy_antenna@good_helmet]
eff_intensity = -10
hit_intensity = 0
phantom_prob = 45</ini>

Файл: ''gamedata\scripts\sr_psy_antenna.script''

==Схема sr_teleport==
Схема позволяет телепортировать актора в пределах локации.

'''[sr_teleport]''' 

'''''point = <имя_пути>''''' - патрульный путь из одной точки, куда переместится актор. 
'''''look = <имя_пути>''''' - патрульный путь из одной точки, куда будет смотреть актор после перемещения. 
'''''prob = <number>''''' - вероятность перемещения в заданную точку. По умолчанию - 100. 
'''''timeout = <number>''''' - задержка срабатывания телепорта в миллисекундах. По умолчанию - 900. 

Телепорты желательно ставить совместно с особой аномальной зоной (партиклом). Зона добавит визуализацию и создаст эффект втягивания. 

'''''Пример использования схемы''''':<ini>[logic]
active = sr_teleport

[sr_teleport]
point1 = aes2_teleport_walk_exit1
look1 = aes2_teleport_look_exit1
prob1 = 10
point2 = aes2_teleport_walk_exit2
look2 = aes2_teleport_look_exit2
prob2 = 20
timeout = 0</ini>

Файл: ''gamedata\scripts\sr_teleport.script''

==Схема sr_sleep==
Появилась возможность задавать зоны сна. 

'''[sr_sleep]''' 
'''''cond = {+info -info =func !func ~number}''''' - условия, при выполнении которых сон будет возможен. 
'''''type = nightmare/normal/happy/all''''' - задает тип сна разрешенный в данной зоне (по умолчанию '''''all'''''). Влияет (группирует) только на не сценарные сны.
'''''dream_prob = <number>''''' - вероятность просмотра не сценарных сновидений в данной зоне (по умолчанию 80). В противном случае будет только черный экран.

Необязательное поле '''''cond''''' задает условие(я), при котором в этой зоне можно спать. Сейчас производится индикация зон, где разрешен сон. В левом нижнем углу отображается маленькая иконка легких при входе в такую зону. Вероятно, позже будет изменена на другую. 
Сновидения теперь делятся на сценарные и обычные. Сценарные сновидения отыгрываются один раз при выполнении необходимых условий. Обычные сновидения проигрываются, если нет сценарных или ни одно условие выполнения сценарных не сработало. Можно задавать вероятность отыгрывания обычных сновидений в целом, а также задавать вероятность срабатывания каждого конкретного сновидения в отдельности. Обычным сновидениям можно задавать тип и потом ограничивать по нему сны воспроизводимые в управляемом файле. 

В файле ''misc\dream.ltx'' задаются настройки снов. 

Секция '''''videos'''''. 
Полями задаются пути к видео файлам со снами. 

Секция '''''dreams'''''. Поля: 
'''''regular_probability = <number>''''' - вероятность проигрывания обычных сновидений в целом; 
'''''regular = <секции>''''' - список секций с настройками для обычных сновидений; 
'''''scene = <секции>''''' - список секций с настройками для сценарных сновидений. 

Настройки обычных сновидений: 
'''''dream = <название>''''' - имя поля из секции '''''videos'''''; 
'''''probability = <number>''''' - чем больше, тем больше вероятность проигрывания сна; 
'''''type = nightmare/normal/happy''''' - тип сна. 

Настройки сценарных сновидений: 
'''''dream = <название>''''' - имя поля из секции '''''videos'''''; 
'''''cond = {+info -info =func !func ~number} - условия срабатывания; 
'''''to_regular = <number>,<тип>''''' - необязательное поле. Дает возможность переводить сценарный сон после первого отыгрыша в разряд обычных. <'''''number'''''>, <'''''тип'''''> аналогичны '''''probability''''' и '''''type''''' из настроек обычных сновидений соответственно. 

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

Файл: ''gamedata\scripts\sr_sleep.script''

==Схема sr_cutscene==

Эта схема предназначена для проведения анимации камеры c некоторым эффектом ('''''pp_effector'''''). Последовательность действий, осуществляемых схемой, состоит из мгновенного перемещения игрока в начало пути '''''point''''' и ориентации его взгляда на начало пути '''''look''''', потери управления игроком и начала анимации камеры '''''cam_effector''''' по завершении которой игрок вновь получает управление. 

'''[sr_cutscene]''' 
'''''point = <имя_пути>''''' - путь в первую точку которого переносится игрок. 
'''''look = <имя_пути>''''' - путь в первую точку которого смотрит игрок. 
'''''pp_effector = <имя_постэффекта>''''' - файл, расположенный в папке ''gamedata\anims\'' и содержащий эффект (имя файла пишется без расширения). 
'''''cam_effector = <имя_анимации_камеры>''''' - файл, расположенный в папке ''gamedata\anims\camera_effects\'' и содержащий анимацию камеры (имя файла пишется без расширения). 

Поддерживается сигнал '''''cameff_end'''''. 

'''''Пример использования схемы''''':<ini>[logic]
active = sr_idle

[sr_idle]
on_actor_inside = sr_cutscene

[sr_cutscene]
point = agr_cutscene_walk
look = agr_cutscene_look
cam_effector = agroprom_demo
on_signal = cameff_end | nil</ini>

Файл: ''gamedata\scripts\sr_cutscene.script''

----

[[Часть 4]]

[[Категория:A-Life]][[Категория:Скрипты]]

Настройка логики. Часть 3

2017-01-06T09:09:32Z

Losiara: /* Пример достаточно сложной логики */

{{Шаблон:Настройка логики}}

=Скрипт logic=

Скрипт '''''logic''''' управляет переключением схем. 
В '''''custom_data''''' любого персонажа (кроме свободных) должна присутствовать секция '''''[logic]'''''. 

Функции, на которые ссылается секция '''''[logic]''''' должны находится в файлах ''gamedata\scripts\xr_effects.script'' или ''gamedata\scripts\xr_conditions.script''. 

В секции должно присутствовать одно из полей: 
:*'''''active = <название_схемы>''''' - активная схема, запускающаяся первой. 
:*'''''cfg = <имя_ltx_файла_с_настройками>''''' - способ задавать логику персонажа, вынося её во внешний файл (путь учитывается относительно папки ''gamedata\config\scripts''). 

Пример. Настройки простого '''''walker''''':<ini>[logic]
active = walker

[walker]
path_walk = walk1
path_look = look1</ini>

Переключение схем выполняется с помощью дополнительных условий схемы '''''logic''''', которые прописываются в секции текущей активной схемы. Существуют следующие условия переключения: 
:*'''''on_actor_dist_le = <number>|<название_схемы>''''' - если дистанция в метрах до игрока меньше либо равно '''''number'''''. 
:*'''''on_actor_dist_le_nvis = <number>|<название_схемы>''''' - если дистанция в метрах до игрока меньше либо равно '''''number''''' без проверки на видимость. 
:*'''''on_actor_dist_ge = <number>|<название_схемы>''''' - если дистанция в метрах до игрока больше '''''number'''''. 
:*'''''on_actor_dist_ge_nvis = <number>|<название_схемы>''''' - если дистанция в метрах до игрока больше '''''number''''' без проверки на видимость. 
:*'''''on_signal = <имя_сигнала>|<название_схемы>''''' - срабатывает по приходу сигнала '''''имя_сигнала''''' от текущей активной схемы. 
:*'''''on_info = <название_схемы>''''' - срабатывает всегда. 
:*'''''on_timer = <number>|<название_схемы>''''' - срабатывает через '''''number''''' миллисекунд после включения схемы. 
:*'''''on_game_timer = <number>|<название_схемы>''''' – срабатывает через '''''number''''' секунд игрового времени, после включения схемы. 
:*'''''on_actor_in_zone = <имя_зоны>|<название_схемы>''''' – если актер в находится в указанной зоне (указывается имя рестриктора). 
:*'''''on_actor_not_in_zone = <имя_зоны>|<название_схемы>''''' – если актер не в указанной зоне (указывается имя рестриктора). 
:*'''''on_npc_in_zone = <number>|<имя_зоны>|<название_схемы>''''' – если NPC со '''''story_id''''' равному '''''number''''', в указанной зоне. 
:*'''''on_npc_not_in_zone = <number>|<имя_зоны>|<название_схемы>''''' - если NPC со '''''story_id''''' равному '''''number''''', не в указанной зоне. 
:*'''''on_actor_inside = <название_схемы>''''' - зона проверяет, находится ли игрок внутри нее (используется со '''''space_restrictor'''''). 
:*'''''on_actor_outside = <название_схемы>''''' - зона проверяет, находится ли игрок за ее пределами (используется со '''''space_restrictor'''''). 

'''''Примечание''''': если происходит переключение между несколькими одноименными схемами (например несколькими '''''walker'''''), то их можно нумеровать: '''''walker1''''', '''''walker2''''', хотя предпочтительнее через символ ''''@'''<nowiki>'</nowiki> давать более информативные названия: '''''walker@day''''', '''''walker@alarm''''' и т.д. 

C любыми из вышеперечисленных параметров можно работать следующим образом: 
'''''on_info = {…} %…%''''' 
'''''on_info2 = {…} %…%''''' 
'''''on_info3 = {…} %…%''''' 
и так далее до посинения 

А также условия для переключения на описанные выше секции. 
'''''combat_ignore_cond = ''''' 
'''''on_hit =''''' 
'''''on_death =''''' 
'''''on_combat =''''' 
'''''on_use =''''' 

==Синтаксис скрипта Logic==

Для того, чтобы персонаж ходил по пути '''''walk1''''', а при приближении игрока на дистанцию 5 метров, переключался на путь '''''walk2''''' (но только при условии, что он видит игрока), нужно написать следующее: <ini>[logic]
active = walker@first

[walker@first]
path_walk = walk1
path_look = look1
on_actor_dist_le = 5 | walker@second

[walker@second]
path_walk = walk2
path_look = look2</ini>
Выше рассмотрено безусловное переключение секций. 
Перед именем секции в фигурных скобках '''''{}''''' можно задавать дополнительные '''''условия''''', а после имени секции - так называемые "'''''эффекты'''''", которые заключить в знаки процента '''''%%'''''. Эффекты будут применены только в случае выполнения условий, если таковых нет то эффект выполнится безусловно. 
Можно не задавать переход на другую схему указывая её имя, а задать только условия и/или эффекты. Тогда активной останется действующая схема, но условия и эффекты будут все равно обработаны. Если все условия в фигурных скобках не выполняются, схема активирована не будет. 

'''''Пример''''':<ini>on_actor_dist_le = 5 | {условие} walker@second %эффекты%</ini>
Условия могут быть следующими: 
:*'''''+infoportion''''' - требуется присутствие инфопорции "'''''infoportion'''''" у актора; 
:*'''''-infoportion''''' - требуется отсутствие инфопорции "'''''infoportion'''''" у актора; 
:*'''''=function''''' - требуется, чтобы функция "'''''function'''''" вернула '''''true'''''; 
:*'''''!function''''' - требуется, чтобы функция "'''''function'''''" вернулся '''''false'''''; 
:*'''''~number''''' - вероятность выполнения условия. 

Эффекты могут быть следующими: 
:*'''''+infoportion''''' - в случае включения секции у актора будет установлен инфопорция "'''''infoportion'''''"; 
:*'''''-infoportion''''' - в случае включения секции у актора будет убрана инфопорция "'''''infoportion'''''"; 
:*'''''=function''''' - в случае включения секции стартует функция "'''''function'''''". 

'''''Примечание''''': для условия переключения схемы '''''{~number}''''' определён следующий расчёт: 

:'''''number''''' сравнивается со случайным числом в диапазоне от 1 до 100, если '''''number''''' больше, то считается, что условие вернуло истину, например:
:<ini>on_actor_in_zone = restrictor_name | {~30} walker@second</ini>
:Если условий несколько, например:
:<ini>on_actor_dist_le = 5 | {~20} walker@second, {~55} walker@third, walker@fourth</ini>
:В таком случае, переход на схему '''''walker@second''''' произойдёт с вероятностью 20%, на схему '''''walker@third''''' с вероятностью 55-20=35% и на схему '''''walker@fourth''''' с оставшейся вероятностью 100-55=45%. 
:Условия в данном случае необходимо выставлять исключительно в порядке возрастания. 
:Неудачный пример:
:<ini>on_actor_dist_le = 5 | {~40} walker@second, {~25} walker@third, walker@fourth</ini>
:Здесь переход на схему '''''walker@third''''' никогда не будет определён, а вероятность перехода на схему '''''walker@fourth''''' составит 60%. 

'''''Примечание''''': несколько условия или эффектов разделяются пробелами:<ini>on_actor_dist_le = 5 | {+info_1 -info_2 +info_3} walker@second %+info_4 =func%</ini>

Можно задавать сразу несколько секций, разделенных запятыми. Порядок обхода при этом - слева направо. После срабатывания первого из условий, обход прекращается. В примере ниже, если установлен '''''info_1''''', будет включена схема '''''walker@second''''', иначе, если установлен '''''info_2''''', будет включена схема '''''walker@third''''', иначе будет включен '''''walker@fourth''''':<ini>on_actor_dist_le = 5 | {+info_1} walker@second, {+info_2} walker@third, walker@fourth</ini>

В описанном выше поле '''''active''''' секции '''''logic''''', можно также задавать условия, например:<ini>[logic]
active = {=actor_friend} walker@friendly, walker@enemy</ini>

В логических условиях теперь принимается ключевое слово '''''never''''', которое означает, что условие ложно. Например:<ini>
combat_ignore_cond = {=actor_enemy =actor_has_suit} always, {=actor_enemy} never %=gar_dm_bandits_fight%</ini>
Вышеприведенная конструкция включает игнорирование боя, если у NPC враг игрок в костюме, но отключит его, если врагом является игрок, но без костюма, при этом сработают эффекты (%%) секции '''''never'''''. Таким образом, выбор секции '''''never''''' равносилен отсутствию секции (несрабатыванию условия), но эффекты в знаках процента при этом срабатывают. 

Пример работы с секцией '''''nil'''''.
Секция '''''nil''''' выводит из-под скриптовых схем персонажа, монстра или объект и отпускает его под управление движка. Это надо если какое-либо условие выполнившись один раз больше не нуждается в проверке, при этом экономятся ресурсы машины, которые на каждом апдейте проверяют это условие. Например:<ini>[logic]
active = sr_idle

[sr_idle]
on_actor_inside = nil %+esc_actor_inside%</ini>
То есть, при входе актера в рестриктор выдается инфопорция и рестриктор уходит в секцию '''''nil''''', больше не проверяя наличие игрока. 

'''''Примечание''''': обратно из секции '''''nil''''' под скрипты объект вернуть уже невозможно! Учитывайте это, используя ее.

==Пример достаточно сложной логики==
<ini>[logic]
active = walker
combat_ignore = combat_ignore
on_hit = hit
on_death = death

[hit]
on_info = %+alert%

[death]
on_info = %+alert +trup3%

[walker]
path_walk = walk_svoboda3
path_look = look_svoboda3
combat_ignore_cond = {-alert}
on_timer = 25000 | remark

[remark]
anim = idle
snd = stalker_talk_kampfire
no_move = true
no_rotate = true
combat_ignore_cond = {-alert}

[combat_ignore]</ini>
Рассмотрим ее пошагово. 
Вначале сталкер работает по схеме '''''walker'''''. При этом он игнорирует бой, пока не будет поставлен инфопоршн '''''alert''''. Он ждет 25 секунд, после чего переходит в схему '''''remark'''''. В ремарке он проигрывает анимацию '''''idle''''', говорит на указанные темы, не поворачивается и не двигается и точно также игнорирует бой. Если по нему попадут ('''''on_hit''''') или убьют ('''''on_death'''''), будет поставлен инфопоршн '''''alert''''' и он перестанет игнорировать бой (понятно, что если он будет трупом, то это ему не поможет, но их в сценке трое, и тогда сорвутся в бой все остальные). Если его убьют, то также будет поставлен инфопоршн '''''trup3''''' который сообщит о том, что этот NPC убит. 

А вот логика его противника:<ini>[logic]
active = walker
combat_ignore = combat_ignore

[walker]
path_walk = soldier_walk1
path_look = soldier_look1
combat_ignore_cond = always
team = assault_group
on_signal = assault | camper

[camper]
path_walk = soldier_walk1_2
path_look = soldier_look1_2
radius = 5 
on_info = {+trup1 +trup2 +trup3} walker2

[walker2]
path_walk = soldier_walk1_3
path_look = soldier_look1_3

[combat_ignore]</ini>

Он идет в схеме '''''walker''''', игнорируя бой (причем игнорируя в любой ситуации). Идет в составе группы '''''assault_group'''''. Когда он приходит в конечную точку маршрута (там он синхронизируется с остальными из группы, это приписано в путях) и получает сигнал '''''assault''''', то переходит в схему '''''camper'''''. В этой схеме у него не прописан '''''combat_ignore''''', поэтому он начинает стрелять по противнику. После того, как все трое противников будут убиты, каждый из них, умирая ставит инфопоршн '''''trup1''''', '''''trup2''''' или '''''trup3''''' и когда все трое будут убиты, то он переключится на схему '''''walker2''''' (подойдет к костру). 

=Схемы логики space_restrictor=

'''''Общее замечание''''': Чтобы исключить ситуацию, когда актёр проскакивает через рестриктор и тот не успевает сработать, старайтесь ставить рестриктор так, чтоб минимальная ширина была больше 2 метров.

==Схема sr_idle==
Предназначение данной схемы – включить другую схему при срабатывании одного из стандартных условий логической схемы. 
Сама по себе схема ничего не делает. 

'''[sr_idle]''' 
'''''on_actor_inside = nil %+esc_actor_inside%''''' 

Обратите внимание, что после срабатывания проверки активная схема переключается в '''''nil''''', чтобы не продолжать бесполезную проверку на каждом апдейте. Можно не задавать '''''nil'''''. 
Часто эта схема работает вместе со спавнером, рестриктор выдает инфопоршн, при входе в зону, а спавнер по нему уже кого-то спавнит. 

'''''Пример использования схемы''''':<ini>[logic]
active = sr_idle

[sr_idle]
on_actor_inside = {+val_raid_start -esc_return -esc_trader_speak} nil %=esc_return_dv +esc_return +esc_trader_speak%</ini>

файл ''gamedata\scripts\sr_idle.script''

==Схема sr_no_weapon==
Данная схема убирает оружие у игрока при входе в зону. 

'''[sr_no_weapon]''' 

'''''Пример использования схемы''''':<ini>[logic]
active = sr_no_weapon

[sr_no_weapon]</ini>

файл ''gamedata\scripts\sr_no_weapon.script''

==Схема sr_sound==

Схема предназначена для отыгрывание звука при входе актора в '''''space_restrictor'''''. 

'''[sr_sound]''' 
'''''snd = <путь_звукового_файла>''''' - перечень имён звуков разделенных запятыми (путь учитывается относительно папки ''gamedata\sounds''). 
'''''type = <параметр>''''' - типы звуков через запятые. Для удобства введены типы наборов звуков в таблице '''''sound_types''''' управляющего файла. Всего их три: 
:*'''''floor_wooden'''''; 
:*'''''rats_panic'''''; 
:*'''''random'''''. 
'''''delay = <number>''''' - задержка перед проигрыванием звука в секундах реального времени, по умолчанию 0. 
'''''idle = <number>''''' - длина периода игнорирования входа в зону после начала последнего проигранного звука.
:Чтоб, например, "завывание" было не чаще, чем раз в несколько минут. Указывается в секундах игрового времени. По умолчанию 0. 
'''''rnd = <number>''''' - вероятность (в процентах) того, что звук отыграется. По умолчанию 100. 
'''''position = <имя_пути>''''' - задает имя пути, в вершинах которого может отыграться звук.
:Есть зарезервированное значение '''''random'''''. Оно означает случайное место в радиусе от 15 до 50 метров от игрока. Если этот параметр не задан, то подразумевается позиция игрока. 
'''''slide_velocity = <number>''''' - скорость (м/с) передвижения звука по точкам патрульного пути. По умолчанию - 3. 
'''''slide_sound_once = true\false''''' - в случае значения '''''true''''' - проиграть звук один раз, даже если он не дошел до последней точки пути,
:иначе если '''''false''''' – и если звук закончился, а до последней точки пути не дошел, запустить его ещё раз. По умолчанию '''''false'''''. 
'''''play_at_actor = true/false''''' - заставляет звук играться от позиции актера постоянно.
:Если он будет равен '''''true''''' и будет задан путь перемещения звука (или рандом), то мы тупо вылетим. 

Поддерживается сигнал '''''sound_end'''''. 

Обязательно нужно задать либо '''''snd''''', либо '''''type'''''. Можно их задать вместе. На базе этих параметров составляется список звуков. При входе актора в рестриктор отыгрывается случайный звук из этого списка. 

'''''Пример использования схемы''''':<ini>[logic]
active = sr_idle

[sr_idle]
on_actor_inside = sr_sound@shooting

[sr_sound@shooting]
snd = characters_voice\scenario\garbage\grey_grey_1
play_at_actor = true
on_signal = sound_end| nil
on_timer = 20000| nil</ini>

Есть возможность сделать «скользящий звук». Необходим патрульный путь. Звук начинает отыгрываться с начала пути и перемещается от одной точки пути к другой (по мере их установки на патрульном пути) со скоростью '''''slide_velocity'''''. Пример:<ini>[logic]
active = sr_sound

[sr_sound]
type = random
position = way
slide_velocity = 8
slide_sound_once = true</ini>

Файл ''gamedata\scripts\sr_sound.script''

==Схема sr_tip==
Предназначение данной схемы – давать игроку сообщение (подсказку) при входе в рестриктор. 

'''[sr_tip]''' 
'''''name = <имя_текса>''''' - строка с '''''id''''' текста зарегистрированного в папке ''gamedata\config\text''. 
'''''type = news/tips''''' - параметр рудиментарный и не на что не влияет. 
'''''sender = <параметр>''''' - задаёт условный строковый идентификатор иконки персонажа, от которого якобы пришло сообщение.
:По умолчанию это иконка торговца. Возможны следующие значения: '''''default, trader, dolg, freedom, ecolog, arena, stalker, krot, barman, wolf, o_soznanie, monolith, saharov, prizrak, killer'''''. 
'''''cond = {+info -info =func !func ~number}''''' - необходимые логические условия, при которых подсказка сработает. По дефолту, сработает при входе в зону. 
'''''single = true/false''''' - если параметр в '''''true''''', то типс будет выдан только один раз. По умолчанию '''''false'''''. 
'''''timeout = <number>''''' - задержка вывода сообщения в секундах. По умолчанию - 0. 
'''''showtime = <number>''''' - время показа сообщения на экране. Задаётся в милисекундах. По умолчанию - 5000. 

Поддерживается сигнал '''''tip_sended''''', только в случае установленного параметра '''''single'''''. 

'''''Пример использования схемы''''':<ini>[logic]
active = sr_idle

[sr_idle]
on_actor_inside = sr_tip

[sr_tip]
name = rad_barman_spam
type = tips
cond = {+bar_deactivate_radar_done}
sender = barman
on_actor_inside = nil
showtime = 25000</ini>

файл ''gamedata\scripts\sr_tip.script''

==Схема sr_light==
Зона, управляющая вкл\откл фонариков NPC.

'''[sr_light]''' 
'''''light_on = true/false''''' - свет включен/выключен. 

'''''Пример использования схемы''''':<ini>[logic]
active = sr_light

[sr_light]
light_on = true</ini>

Файл: ''gamedata\scripts\sr_light.script''

==Схема sr_territory==

Занимается эта схема тем, что отлавливает всякие события, происходящие внутри рестриктора.
Пока что она отлавливает только хиты и смерть NPC. 

'''[sr_territory]''' 
'''''territory_hit = {+info -info =func !func ~number} %+info -info =func%''''' - эффекты, которые произойдут при нанесении хита от актора, будучи в этой зоне. 
'''''territory_death = {+info -info =func !func ~number} %+info -info =func%''''' - эффекты, которые произойдут при смерти от "рук" актора, будучи в этой зоне. 

Поскольку схема работает только с игроком – то хиты и смерть засчитываются только от игрока. 

'''''Пример использования схемы''''':<ini>[logic]
active = sr_territory@1

[sr_territory@1]
territory_death = sr_idle@1 %+bar_arena_territory_death%</ini>

Файл: ''gamedata\scripts\sr_territory.script''

==Схема sr_mapspot==
При входе в рестриктор он сам себя подсвечивает на карте. 

'''[sr_mapspot]''' 
'''''hint = <имя_текса>''''' - строка с '''''id''''' текста зарегистрированного в папке ''gamedata\config\text''. 
'''''location = <имя_метки>''''' - имя типа метки, зарегистрированное в файле ''config\ui\map_spots.xml'' и всех, что в него включены инклюдами. По умолчанию - '''''crlc_small'''''. 

'''''Пример использования схемы''''':<ini>[logic]
active = sr_idle

[sr_idle]
on_actor_inside = sr_mapspot

[sr_mapspot]
hint = gar_swamp
location = crcl_big</ini>

Файл: ''gamedata\scripts\sr_mapspot.script''

==Схема sr_particle==
Данная система отыгрывает партиклы, как статичные, так и движущиеся, в указанном месте и в указанное время. 

'''[sr_particle]''' 
'''''name = <имя_партикла>''''' - путь до партикла относительно файла ''particles.xr''. 
'''''path = <имя_пути>''''' - точки движения партикла. Возможны два случая:
:#Когда указывается путь анимации камеры (путь учитывается относительно папки ''gamedata\anims''); 
:#Когда указывается имя патрульного пути. 
'''''mode = <параметр>''''' - параметр обязательный и имеет два значения:
:* 1 - устанавливается в случае указания анимации камеры для параметра '''''path'''''; 
:* 2 - устанавливается в случае указания патрульного пути для параметра '''''path'''''. 
'''''looped = true/false''''' - флаг зацикленности партиклов. 

'''''Примечание''''': для пути движения партикла, когда установлена анимация движения камеры, для имени файла необходимо ставить расширение '''''.anm''''' (например ''arena.anm''). 

Поддерживается сигнал '''''particle_end'''''.

В вейпоинтах патрульного пути можно задавать флаги: 
:*'''''s=<название_звуковой_темы>''''' - звук проигрываемый во время движения; 
:*'''''d=<number>''''' - время задержки перед проигрыванием, задается в миллисекундах. По умолчанию - 0. 

При '''''looped = true''''', по окончании проигрывания партиклов, они будут запускаться сначала, но уже без задержек. Сигнал '''''particle_end''''' выдаваться не будет. 
При '''''looped = false''''' сигнал будет выдан, когда все источники партиклов отыграют. 

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

'''''Пример использования схемы''''':<ini>[logic]
active = sr_idle

[sr_idle]
on_info = {+sar_mon_poltergeist_1_spawn} sr_particle

[sr_particle]
name = anomaly2\gravity_blast_03
path = sar_poltergeist_1_way
mode = 2
looped = false
on_signal = particle_end | sr_idle@2</ini>

Файл: ''gamedata\scripts\sr_particle.script''

==Схема sr_sound_act==
Схема играет звук в голове актера. Всякие там переговоры по ПДА и прочие фейки.

'''[sr_sound_act]''' 
'''''snd = <путь_звукового_файла>''''' - имя звукового файла относительно папки ''gamedata\sounds''. 
'''''delay = <number>''''' - задержка перед проигрыванием. По умолчанию - 0. 
'''''delay_max = <number>''''' - между проигрыванием звука будет взят случайный промежуток между '''''delay''''' и '''''delay_max'''''. 
'''''theme = <название_звуковой_темы>''''' - имя темы из файла ''sound_theme.script''. 
'''''stereo = true/false''''' - при установке этого параметра к файлу, который задан параметром '''''snd''''' или в звуковой теме,
:автоматически будут добавляться суффиксы '''''_r''''' и '''''_l''''' для загрузки левого и правого каналов и, соответственно, всё это будет проигрываться. 

Поддерживается сигнал '''''sound_end'''''.

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

'''''Пример использования схемы''''':<ini>[logic]
active = sr_idle

[sr_idle]
on_actor_inside = sr_sound_act

[sr_sound_act]
theme = sar_monolith_call
delay = 10000
delay_max = 15000
stereo = true
on_info = {+sar2_monolith_miracle} sr_idle@end</ini>

Файл: ''gamedata\scripts\sr_sound2d.script''

==Схема sr_timer==
Схема использовать для производства каких либо действий в зависимости от состояния таймера.

'''[sr_timer]''' 
'''''type = dec/inc''''' - тип счётчика.
:*'''''dec''''' - декриментирующий, т.е. обратный отсчёт; 
:*'''''inc''''' - инрементирующий, т.е. отчёт по возрастанию. 
'''''start_value = <number>''''' - начальное значение счетчика в реальных миллисекундах.
:Для декриментирующих счетчиков задавать обязательно. Для инкриментирующих, если не задано, то считается с 0. 
'''''on_value = <number>|%+info -info =func% <название_схемы>''''' - производит действие в зависимости от состояния счётчика. 
'''''string = <имя_текса>''''' - строка с '''''id''''' текста зарегистрированного в папке ''gamedata\config\text''.

'''''Пример использования схемы''''':<ini>[logic]
active = sr_idle

[sr_idle]
on_actor_inside = sr_timer@1

[sr_timer@1]
type = dec
start_value = 1000000
on_value = 5 | %=play_snd(characters_voice\scenario\radar\rad_hat_2)% | 0 | nil %=aes_kill_actor%
on_actor_outside = sr_idle
on_info = {+bar_deactivate_radar_done} nil
string = st_helmet_countdown</ini>

Файл: ''gamedata\scripts\sr_timer.script''

==Схема sr_psy_antenna==
Зоны с такой секцией позволяют управлять эффектами от пси-воздействия (на Янтаре и Радаре). Сейчас можно управлять интенсивностью излучения и интенсивностью получения повреждений. 

'''[sr_psy_antenna]''' 
'''''eff_intensity = <number>''''' - увеличение/уменьшение в процентах от базового значения интенсивности излучения. 
'''''hit_intensity = <nymber>''''' - увеличение/уменьшение в процентах от базового значения наносимого повреждения. 
'''''phantom_prob = <nymber>''''' - вероятность проявления фантомов в процентах. По умолчанию - 0. 
'''''postprocess = <имя_постэффекта>''''' - файл постэффекта, относительно папки ''gamedata\anims''. Расширение ставить обязательно! По умолчанию - ''psy_antenna.ppe''. 
'''''mute_sound_threshold = <number>''''' - предел до которого можно занижать звук уровня. 0 - глушит полностью, стоит по умолчанию. 

'''''Пример использования схемы''''':<ini>[logic]
active = sr_psy_antenna@good_helmet

[sr_psy_antenna@good_helmet]
eff_intensity = -10
hit_intensity = 0
phantom_prob = 45</ini>

Файл: ''gamedata\scripts\sr_psy_antenna.script''

==Схема sr_teleport==
Схема позволяет телепортировать актора в пределах локации.

'''[sr_teleport]''' 

'''''point = <имя_пути>''''' - патрульный путь из одной точки, куда переместится актор. 
'''''look = <имя_пути>''''' - патрульный путь из одной точки, куда будет смотреть актор после перемещения. 
'''''prob = <number>''''' - вероятность перемещения в заданную точку. По умолчанию - 100. 
'''''timeout = <number>''''' - задержка срабатывания телепорта в миллисекундах. По умолчанию - 900. 

Телепорты желательно ставить совместно с особой аномальной зоной (партиклом). Зона добавит визуализацию и создаст эффект втягивания. 

'''''Пример использования схемы''''':<ini>[logic]
active = sr_teleport

[sr_teleport]
point1 = aes2_teleport_walk_exit1
look1 = aes2_teleport_look_exit1
prob1 = 10
point2 = aes2_teleport_walk_exit2
look2 = aes2_teleport_look_exit2
prob2 = 20
timeout = 0</ini>

Файл: ''gamedata\scripts\sr_teleport.script''

==Схема sr_sleep==
Появилась возможность задавать зоны сна. 

'''[sr_sleep]''' 
'''''cond = {+info -info =func !func ~number}''''' - условия, при выполнении которых сон будет возможен. 
'''''type = nightmare/normal/happy/all''''' - задает тип сна разрешенный в данной зоне (по умолчанию '''''all'''''). Влияет (группирует) только на не сценарные сны.
'''''dream_prob = <number>''''' - вероятность просмотра не сценарных сновидений в данной зоне (по умолчанию 80). В противном случае будет только черный экран.

Необязательное поле '''''cond''''' задает условие(я), при котором в этой зоне можно спать. Сейчас производится индикация зон, где разрешен сон. В левом нижнем углу отображается маленькая иконка легких при входе в такую зону. Вероятно, позже будет изменена на другую. 
Сновидения теперь делятся на сценарные и обычные. Сценарные сновидения отыгрываются один раз при выполнении необходимых условий. Обычные сновидения проигрываются, если нет сценарных или ни одно условие выполнения сценарных не сработало. Можно задавать вероятность отыгрывания обычных сновидений в целом, а также задавать вероятность срабатывания каждого конкретного сновидения в отдельности. Обычным сновидениям можно задавать тип и потом ограничивать по нему сны воспроизводимые в управляемом файле. 

В файле ''misc\dream.ltx'' задаются настройки снов. 

Секция '''''videos'''''. 
Полями задаются пути к видео файлам со снами. 

Секция '''''dreams'''''. Поля: 
'''''regular_probability = <number>''''' - вероятность проигрывания обычных сновидений в целом; 
'''''regular = <секции>''''' - список секций с настройками для обычных сновидений; 
'''''scene = <секции>''''' - список секций с настройками для сценарных сновидений. 

Настройки обычных сновидений: 
'''''dream = <название>''''' - имя поля из секции '''''videos'''''; 
'''''probability = <number>''''' - чем больше, тем больше вероятность проигрывания сна; 
'''''type = nightmare/normal/happy''''' - тип сна. 

Настройки сценарных сновидений: 
'''''dream = <название>''''' - имя поля из секции '''''videos'''''; 
'''''cond = {+info -info =func !func ~number} - условия срабатывания; 
'''''to_regular = <number>,<тип>''''' - необязательное поле. Дает возможность переводить сценарный сон после первого отыгрыша в разряд обычных. <'''''number'''''>, <'''''тип'''''> аналогичны '''''probability''''' и '''''type''''' из настроек обычных сновидений соответственно. 

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

Файл: ''gamedata\scripts\sr_sleep.script''

==Схема sr_cutscene==

Эта схема предназначена для проведения анимации камеры c некоторым эффектом ('''''pp_effector'''''). Последовательность действий, осуществляемых схемой, состоит из мгновенного перемещения игрока в начало пути '''''point''''' и ориентации его взгляда на начало пути '''''look''''', потери управления игроком и начала анимации камеры '''''cam_effector''''' по завершении которой игрок вновь получает управление. 

'''[sr_cutscene]''' 
'''''point = <имя_пути>''''' - путь в первую точку которого переносится игрок. 
'''''look = <имя_пути>''''' - путь в первую точку которого смотрит игрок. 
'''''pp_effector = <имя_постэффекта>''''' - файл, расположенный в папке ''gamedata\anims\'' и содержащий эффект (имя файла пишется без расширения). 
'''''cam_effector = <имя_анимации_камеры>''''' - файл, расположенный в папке ''gamedata\anims\camera_effects\'' и содержащий анимацию камеры (имя файла пишется без расширения). 

Поддерживается сигнал '''''cameff_end'''''. 

'''''Пример использования схемы''''':<ini>[logic]
active = sr_idle

[sr_idle]
on_actor_inside = sr_cutscene

[sr_cutscene]
point = agr_cutscene_walk
look = agr_cutscene_look
cam_effector = agroprom_demo
on_signal = cameff_end | nil</ini>

Файл: ''gamedata\scripts\sr_cutscene.script''

----

[[Часть 4]]

[[Категория:A-Life]][[Категория:Скрипты]]

Настройка логики. Часть 3

2017-01-06T09:06:09Z

Losiara: /* Пример достаточно сложной логики */

{{Шаблон:Настройка логики}}

=Скрипт logic=

Скрипт '''''logic''''' управляет переключением схем. 
В '''''custom_data''''' любого персонажа (кроме свободных) должна присутствовать секция '''''[logic]'''''. 

Функции, на которые ссылается секция '''''[logic]''''' должны находится в файлах ''gamedata\scripts\xr_effects.script'' или ''gamedata\scripts\xr_conditions.script''. 

В секции должно присутствовать одно из полей: 
:*'''''active = <название_схемы>''''' - активная схема, запускающаяся первой. 
:*'''''cfg = <имя_ltx_файла_с_настройками>''''' - способ задавать логику персонажа, вынося её во внешний файл (путь учитывается относительно папки ''gamedata\config\scripts''). 

Пример. Настройки простого '''''walker''''':<ini>[logic]
active = walker

[walker]
path_walk = walk1
path_look = look1</ini>

Переключение схем выполняется с помощью дополнительных условий схемы '''''logic''''', которые прописываются в секции текущей активной схемы. Существуют следующие условия переключения: 
:*'''''on_actor_dist_le = <number>|<название_схемы>''''' - если дистанция в метрах до игрока меньше либо равно '''''number'''''. 
:*'''''on_actor_dist_le_nvis = <number>|<название_схемы>''''' - если дистанция в метрах до игрока меньше либо равно '''''number''''' без проверки на видимость. 
:*'''''on_actor_dist_ge = <number>|<название_схемы>''''' - если дистанция в метрах до игрока больше '''''number'''''. 
:*'''''on_actor_dist_ge_nvis = <number>|<название_схемы>''''' - если дистанция в метрах до игрока больше '''''number''''' без проверки на видимость. 
:*'''''on_signal = <имя_сигнала>|<название_схемы>''''' - срабатывает по приходу сигнала '''''имя_сигнала''''' от текущей активной схемы. 
:*'''''on_info = <название_схемы>''''' - срабатывает всегда. 
:*'''''on_timer = <number>|<название_схемы>''''' - срабатывает через '''''number''''' миллисекунд после включения схемы. 
:*'''''on_game_timer = <number>|<название_схемы>''''' – срабатывает через '''''number''''' секунд игрового времени, после включения схемы. 
:*'''''on_actor_in_zone = <имя_зоны>|<название_схемы>''''' – если актер в находится в указанной зоне (указывается имя рестриктора). 
:*'''''on_actor_not_in_zone = <имя_зоны>|<название_схемы>''''' – если актер не в указанной зоне (указывается имя рестриктора). 
:*'''''on_npc_in_zone = <number>|<имя_зоны>|<название_схемы>''''' – если NPC со '''''story_id''''' равному '''''number''''', в указанной зоне. 
:*'''''on_npc_not_in_zone = <number>|<имя_зоны>|<название_схемы>''''' - если NPC со '''''story_id''''' равному '''''number''''', не в указанной зоне. 
:*'''''on_actor_inside = <название_схемы>''''' - зона проверяет, находится ли игрок внутри нее (используется со '''''space_restrictor'''''). 
:*'''''on_actor_outside = <название_схемы>''''' - зона проверяет, находится ли игрок за ее пределами (используется со '''''space_restrictor'''''). 

'''''Примечание''''': если происходит переключение между несколькими одноименными схемами (например несколькими '''''walker'''''), то их можно нумеровать: '''''walker1''''', '''''walker2''''', хотя предпочтительнее через символ ''''@'''<nowiki>'</nowiki> давать более информативные названия: '''''walker@day''''', '''''walker@alarm''''' и т.д. 

C любыми из вышеперечисленных параметров можно работать следующим образом: 
'''''on_info = {…} %…%''''' 
'''''on_info2 = {…} %…%''''' 
'''''on_info3 = {…} %…%''''' 
и так далее до посинения 

А также условия для переключения на описанные выше секции. 
'''''combat_ignore_cond = ''''' 
'''''on_hit =''''' 
'''''on_death =''''' 
'''''on_combat =''''' 
'''''on_use =''''' 

==Синтаксис скрипта Logic==

Для того, чтобы персонаж ходил по пути '''''walk1''''', а при приближении игрока на дистанцию 5 метров, переключался на путь '''''walk2''''' (но только при условии, что он видит игрока), нужно написать следующее: <ini>[logic]
active = walker@first

[walker@first]
path_walk = walk1
path_look = look1
on_actor_dist_le = 5 | walker@second

[walker@second]
path_walk = walk2
path_look = look2</ini>
Выше рассмотрено безусловное переключение секций. 
Перед именем секции в фигурных скобках '''''{}''''' можно задавать дополнительные '''''условия''''', а после имени секции - так называемые "'''''эффекты'''''", которые заключить в знаки процента '''''%%'''''. Эффекты будут применены только в случае выполнения условий, если таковых нет то эффект выполнится безусловно. 
Можно не задавать переход на другую схему указывая её имя, а задать только условия и/или эффекты. Тогда активной останется действующая схема, но условия и эффекты будут все равно обработаны. Если все условия в фигурных скобках не выполняются, схема активирована не будет. 

'''''Пример''''':<ini>on_actor_dist_le = 5 | {условие} walker@second %эффекты%</ini>
Условия могут быть следующими: 
:*'''''+infoportion''''' - требуется присутствие инфопорции "'''''infoportion'''''" у актора; 
:*'''''-infoportion''''' - требуется отсутствие инфопорции "'''''infoportion'''''" у актора; 
:*'''''=function''''' - требуется, чтобы функция "'''''function'''''" вернула '''''true'''''; 
:*'''''!function''''' - требуется, чтобы функция "'''''function'''''" вернулся '''''false'''''; 
:*'''''~number''''' - вероятность выполнения условия. 

Эффекты могут быть следующими: 
:*'''''+infoportion''''' - в случае включения секции у актора будет установлен инфопорция "'''''infoportion'''''"; 
:*'''''-infoportion''''' - в случае включения секции у актора будет убрана инфопорция "'''''infoportion'''''"; 
:*'''''=function''''' - в случае включения секции стартует функция "'''''function'''''". 

'''''Примечание''''': для условия переключения схемы '''''{~number}''''' определён следующий расчёт: 

:'''''number''''' сравнивается со случайным числом в диапазоне от 1 до 100, если '''''number''''' больше, то считается, что условие вернуло истину, например:
:<ini>on_actor_in_zone = restrictor_name | {~30} walker@second</ini>
:Если условий несколько, например:
:<ini>on_actor_dist_le = 5 | {~20} walker@second, {~55} walker@third, walker@fourth</ini>
:В таком случае, переход на схему '''''walker@second''''' произойдёт с вероятностью 20%, на схему '''''walker@third''''' с вероятностью 55-20=35% и на схему '''''walker@fourth''''' с оставшейся вероятностью 100-55=45%. 
:Условия в данном случае необходимо выставлять исключительно в порядке возрастания. 
:Неудачный пример:
:<ini>on_actor_dist_le = 5 | {~40} walker@second, {~25} walker@third, walker@fourth</ini>
:Здесь переход на схему '''''walker@third''''' никогда не будет определён, а вероятность перехода на схему '''''walker@fourth''''' составит 60%. 

'''''Примечание''''': несколько условия или эффектов разделяются пробелами:<ini>on_actor_dist_le = 5 | {+info_1 -info_2 +info_3} walker@second %+info_4 =func%</ini>

Можно задавать сразу несколько секций, разделенных запятыми. Порядок обхода при этом - слева направо. После срабатывания первого из условий, обход прекращается. В примере ниже, если установлен '''''info_1''''', будет включена схема '''''walker@second''''', иначе, если установлен '''''info_2''''', будет включена схема '''''walker@third''''', иначе будет включен '''''walker@fourth''''':<ini>on_actor_dist_le = 5 | {+info_1} walker@second, {+info_2} walker@third, walker@fourth</ini>

В описанном выше поле '''''active''''' секции '''''logic''''', можно также задавать условия, например:<ini>[logic]
active = {=actor_friend} walker@friendly, walker@enemy</ini>

В логических условиях теперь принимается ключевое слово '''''never''''', которое означает, что условие ложно. Например:<ini>
combat_ignore_cond = {=actor_enemy =actor_has_suit} always, {=actor_enemy} never %=gar_dm_bandits_fight%</ini>
Вышеприведенная конструкция включает игнорирование боя, если у NPC враг игрок в костюме, но отключит его, если врагом является игрок, но без костюма, при этом сработают эффекты (%%) секции '''''never'''''. Таким образом, выбор секции '''''never''''' равносилен отсутствию секции (несрабатыванию условия), но эффекты в знаках процента при этом срабатывают. 

Пример работы с секцией '''''nil'''''.
Секция '''''nil''''' выводит из-под скриптовых схем персонажа, монстра или объект и отпускает его под управление движка. Это надо если какое-либо условие выполнившись один раз больше не нуждается в проверке, при этом экономятся ресурсы машины, которые на каждом апдейте проверяют это условие. Например:<ini>[logic]
active = sr_idle

[sr_idle]
on_actor_inside = nil %+esc_actor_inside%</ini>
То есть, при входе актера в рестриктор выдается инфопорция и рестриктор уходит в секцию '''''nil''''', больше не проверяя наличие игрока. 

'''''Примечание''''': обратно из секции '''''nil''''' под скрипты объект вернуть уже невозможно! Учитывайте это, используя ее.

==Пример достаточно сложной логики==
<ini>[logic]
active = walker
combat_ignore = combat_ignore
on_hit = hit
on_death = death

[hit]
on_info = %+alert%

[death]
on_info = %+alert +trup3%

[walker]
path_walk = walk_svoboda3
path_look = look_svoboda3
combat_ignore_cond = {-alert}
on_timer = 25000 | remark

[remark]
anim = idle
snd = stalker_talk_kampfire
no_move = true
no_rotate = true
combat_ignore_cond = {-alert}

[combat_ignore]</ini>
Рассмотрим ее пошагово. 
Вначале сталкер работает по схеме '''''walker'''''. При этом он игнорирует бой, пока не будет поставлен инфопоршн '''''alert''''. Он ждет 25 секунд, после чего переходит в схему '''''remark'''''. В ремарке он проигрывает анимацию '''''idle''''', говорит на указанные темы, не поворачивается и не двигается и точно также игнорирует бой. Если по нему попадут ('''''on_hit''''') или убьют ('''''on_death'''''), будет поставлен инфопоршн '''''alert''''' и он перестанет игнорировать бой (понятно, что если он будет трупом, то это ему не поможет, но их в сценке трое, и тогда сорвутся в бой все остальные). Если его убьют, то также будет поставлен инфопоршн '''''trup3''''' который сообщит о том, что этот NPC убит. 

А вот логика его противника:<ini>[logic]
active = walker
combat_ignore = combat_ignore

[walker]
path_walk = soldier_walk1
path_look = soldier_look1
combat_ignore_cond = always
team = assault_group
on_signal = assault | camper

[camper]
path_walk = soldier_walk1_2
path_look = soldier_look1_2
radius = 5 
on_info = {+trup1 +trup2 +trup3} walker2

[walker2] 
path_walk = soldier_walk1_3
path_look = soldier_look1_3

[combat_ignore]</ini>

Он идет в схеме '''''walker''''', игнорируя бой (причем игнорируя в любой ситуации). Идет в составе группы '''''assault_group'''''. Когда он приходит в конечную точку маршрута (там он синхронизируется с остальными из группы, это приписано в путях) и получает сигнал '''''assault''''', то переходит в схему '''''camper'''''. В этой схеме у него не прописан '''''combat_ignore''''', поэтому он начинает стрелять по противнику. После того, как все трое противников будут убиты, каждый из них, умирая ставит инфопоршн '''''trup1''''', '''''trup2''''' или '''''trup3''''' и когда все трое будут убиты, то он переключится на схему '''''walker2''''' (подойдет к костру). 

=Схемы логики space_restrictor=

'''''Общее замечание''''': Чтобы исключить ситуацию, когда актёр проскакивает через рестриктор и тот не успевает сработать, старайтесь ставить рестриктор так, чтоб минимальная ширина была больше 2 метров.

==Схема sr_idle==
Предназначение данной схемы – включить другую схему при срабатывании одного из стандартных условий логической схемы. 
Сама по себе схема ничего не делает. 

'''[sr_idle]''' 
'''''on_actor_inside = nil %+esc_actor_inside%''''' 

Обратите внимание, что после срабатывания проверки активная схема переключается в '''''nil''''', чтобы не продолжать бесполезную проверку на каждом апдейте. Можно не задавать '''''nil'''''. 
Часто эта схема работает вместе со спавнером, рестриктор выдает инфопоршн, при входе в зону, а спавнер по нему уже кого-то спавнит. 

'''''Пример использования схемы''''':<ini>[logic]
active = sr_idle

[sr_idle]
on_actor_inside = {+val_raid_start -esc_return -esc_trader_speak} nil %=esc_return_dv +esc_return +esc_trader_speak%</ini>

файл ''gamedata\scripts\sr_idle.script''

==Схема sr_no_weapon==
Данная схема убирает оружие у игрока при входе в зону. 

'''[sr_no_weapon]''' 

'''''Пример использования схемы''''':<ini>[logic]
active = sr_no_weapon

[sr_no_weapon]</ini>

файл ''gamedata\scripts\sr_no_weapon.script''

==Схема sr_sound==

Схема предназначена для отыгрывание звука при входе актора в '''''space_restrictor'''''. 

'''[sr_sound]''' 
'''''snd = <путь_звукового_файла>''''' - перечень имён звуков разделенных запятыми (путь учитывается относительно папки ''gamedata\sounds''). 
'''''type = <параметр>''''' - типы звуков через запятые. Для удобства введены типы наборов звуков в таблице '''''sound_types''''' управляющего файла. Всего их три: 
:*'''''floor_wooden'''''; 
:*'''''rats_panic'''''; 
:*'''''random'''''. 
'''''delay = <number>''''' - задержка перед проигрыванием звука в секундах реального времени, по умолчанию 0. 
'''''idle = <number>''''' - длина периода игнорирования входа в зону после начала последнего проигранного звука.
:Чтоб, например, "завывание" было не чаще, чем раз в несколько минут. Указывается в секундах игрового времени. По умолчанию 0. 
'''''rnd = <number>''''' - вероятность (в процентах) того, что звук отыграется. По умолчанию 100. 
'''''position = <имя_пути>''''' - задает имя пути, в вершинах которого может отыграться звук.
:Есть зарезервированное значение '''''random'''''. Оно означает случайное место в радиусе от 15 до 50 метров от игрока. Если этот параметр не задан, то подразумевается позиция игрока. 
'''''slide_velocity = <number>''''' - скорость (м/с) передвижения звука по точкам патрульного пути. По умолчанию - 3. 
'''''slide_sound_once = true\false''''' - в случае значения '''''true''''' - проиграть звук один раз, даже если он не дошел до последней точки пути,
:иначе если '''''false''''' – и если звук закончился, а до последней точки пути не дошел, запустить его ещё раз. По умолчанию '''''false'''''. 
'''''play_at_actor = true/false''''' - заставляет звук играться от позиции актера постоянно.
:Если он будет равен '''''true''''' и будет задан путь перемещения звука (или рандом), то мы тупо вылетим. 

Поддерживается сигнал '''''sound_end'''''. 

Обязательно нужно задать либо '''''snd''''', либо '''''type'''''. Можно их задать вместе. На базе этих параметров составляется список звуков. При входе актора в рестриктор отыгрывается случайный звук из этого списка. 

'''''Пример использования схемы''''':<ini>[logic]
active = sr_idle

[sr_idle]
on_actor_inside = sr_sound@shooting

[sr_sound@shooting]
snd = characters_voice\scenario\garbage\grey_grey_1
play_at_actor = true
on_signal = sound_end| nil
on_timer = 20000| nil</ini>

Есть возможность сделать «скользящий звук». Необходим патрульный путь. Звук начинает отыгрываться с начала пути и перемещается от одной точки пути к другой (по мере их установки на патрульном пути) со скоростью '''''slide_velocity'''''. Пример:<ini>[logic]
active = sr_sound

[sr_sound]
type = random
position = way
slide_velocity = 8
slide_sound_once = true</ini>

Файл ''gamedata\scripts\sr_sound.script''

==Схема sr_tip==
Предназначение данной схемы – давать игроку сообщение (подсказку) при входе в рестриктор. 

'''[sr_tip]''' 
'''''name = <имя_текса>''''' - строка с '''''id''''' текста зарегистрированного в папке ''gamedata\config\text''. 
'''''type = news/tips''''' - параметр рудиментарный и не на что не влияет. 
'''''sender = <параметр>''''' - задаёт условный строковый идентификатор иконки персонажа, от которого якобы пришло сообщение.
:По умолчанию это иконка торговца. Возможны следующие значения: '''''default, trader, dolg, freedom, ecolog, arena, stalker, krot, barman, wolf, o_soznanie, monolith, saharov, prizrak, killer'''''. 
'''''cond = {+info -info =func !func ~number}''''' - необходимые логические условия, при которых подсказка сработает. По дефолту, сработает при входе в зону. 
'''''single = true/false''''' - если параметр в '''''true''''', то типс будет выдан только один раз. По умолчанию '''''false'''''. 
'''''timeout = <number>''''' - задержка вывода сообщения в секундах. По умолчанию - 0. 
'''''showtime = <number>''''' - время показа сообщения на экране. Задаётся в милисекундах. По умолчанию - 5000. 

Поддерживается сигнал '''''tip_sended''''', только в случае установленного параметра '''''single'''''. 

'''''Пример использования схемы''''':<ini>[logic]
active = sr_idle

[sr_idle]
on_actor_inside = sr_tip

[sr_tip]
name = rad_barman_spam
type = tips
cond = {+bar_deactivate_radar_done}
sender = barman
on_actor_inside = nil
showtime = 25000</ini>

файл ''gamedata\scripts\sr_tip.script''

==Схема sr_light==
Зона, управляющая вкл\откл фонариков NPC.

'''[sr_light]''' 
'''''light_on = true/false''''' - свет включен/выключен. 

'''''Пример использования схемы''''':<ini>[logic]
active = sr_light

[sr_light]
light_on = true</ini>

Файл: ''gamedata\scripts\sr_light.script''

==Схема sr_territory==

Занимается эта схема тем, что отлавливает всякие события, происходящие внутри рестриктора.
Пока что она отлавливает только хиты и смерть NPC. 

'''[sr_territory]''' 
'''''territory_hit = {+info -info =func !func ~number} %+info -info =func%''''' - эффекты, которые произойдут при нанесении хита от актора, будучи в этой зоне. 
'''''territory_death = {+info -info =func !func ~number} %+info -info =func%''''' - эффекты, которые произойдут при смерти от "рук" актора, будучи в этой зоне. 

Поскольку схема работает только с игроком – то хиты и смерть засчитываются только от игрока. 

'''''Пример использования схемы''''':<ini>[logic]
active = sr_territory@1

[sr_territory@1]
territory_death = sr_idle@1 %+bar_arena_territory_death%</ini>

Файл: ''gamedata\scripts\sr_territory.script''

==Схема sr_mapspot==
При входе в рестриктор он сам себя подсвечивает на карте. 

'''[sr_mapspot]''' 
'''''hint = <имя_текса>''''' - строка с '''''id''''' текста зарегистрированного в папке ''gamedata\config\text''. 
'''''location = <имя_метки>''''' - имя типа метки, зарегистрированное в файле ''config\ui\map_spots.xml'' и всех, что в него включены инклюдами. По умолчанию - '''''crlc_small'''''. 

'''''Пример использования схемы''''':<ini>[logic]
active = sr_idle

[sr_idle]
on_actor_inside = sr_mapspot

[sr_mapspot]
hint = gar_swamp
location = crcl_big</ini>

Файл: ''gamedata\scripts\sr_mapspot.script''

==Схема sr_particle==
Данная система отыгрывает партиклы, как статичные, так и движущиеся, в указанном месте и в указанное время. 

'''[sr_particle]''' 
'''''name = <имя_партикла>''''' - путь до партикла относительно файла ''particles.xr''. 
'''''path = <имя_пути>''''' - точки движения партикла. Возможны два случая:
:#Когда указывается путь анимации камеры (путь учитывается относительно папки ''gamedata\anims''); 
:#Когда указывается имя патрульного пути. 
'''''mode = <параметр>''''' - параметр обязательный и имеет два значения:
:* 1 - устанавливается в случае указания анимации камеры для параметра '''''path'''''; 
:* 2 - устанавливается в случае указания патрульного пути для параметра '''''path'''''. 
'''''looped = true/false''''' - флаг зацикленности партиклов. 

'''''Примечание''''': для пути движения партикла, когда установлена анимация движения камеры, для имени файла необходимо ставить расширение '''''.anm''''' (например ''arena.anm''). 

Поддерживается сигнал '''''particle_end'''''.

В вейпоинтах патрульного пути можно задавать флаги: 
:*'''''s=<название_звуковой_темы>''''' - звук проигрываемый во время движения; 
:*'''''d=<number>''''' - время задержки перед проигрыванием, задается в миллисекундах. По умолчанию - 0. 

При '''''looped = true''''', по окончании проигрывания партиклов, они будут запускаться сначала, но уже без задержек. Сигнал '''''particle_end''''' выдаваться не будет. 
При '''''looped = false''''' сигнал будет выдан, когда все источники партиклов отыграют. 

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

'''''Пример использования схемы''''':<ini>[logic]
active = sr_idle

[sr_idle]
on_info = {+sar_mon_poltergeist_1_spawn} sr_particle

[sr_particle]
name = anomaly2\gravity_blast_03
path = sar_poltergeist_1_way
mode = 2
looped = false
on_signal = particle_end | sr_idle@2</ini>

Файл: ''gamedata\scripts\sr_particle.script''

==Схема sr_sound_act==
Схема играет звук в голове актера. Всякие там переговоры по ПДА и прочие фейки.

'''[sr_sound_act]''' 
'''''snd = <путь_звукового_файла>''''' - имя звукового файла относительно папки ''gamedata\sounds''. 
'''''delay = <number>''''' - задержка перед проигрыванием. По умолчанию - 0. 
'''''delay_max = <number>''''' - между проигрыванием звука будет взят случайный промежуток между '''''delay''''' и '''''delay_max'''''. 
'''''theme = <название_звуковой_темы>''''' - имя темы из файла ''sound_theme.script''. 
'''''stereo = true/false''''' - при установке этого параметра к файлу, который задан параметром '''''snd''''' или в звуковой теме,
:автоматически будут добавляться суффиксы '''''_r''''' и '''''_l''''' для загрузки левого и правого каналов и, соответственно, всё это будет проигрываться. 

Поддерживается сигнал '''''sound_end'''''.

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

'''''Пример использования схемы''''':<ini>[logic]
active = sr_idle

[sr_idle]
on_actor_inside = sr_sound_act

[sr_sound_act]
theme = sar_monolith_call
delay = 10000
delay_max = 15000
stereo = true
on_info = {+sar2_monolith_miracle} sr_idle@end</ini>

Файл: ''gamedata\scripts\sr_sound2d.script''

==Схема sr_timer==
Схема использовать для производства каких либо действий в зависимости от состояния таймера.

'''[sr_timer]''' 
'''''type = dec/inc''''' - тип счётчика.
:*'''''dec''''' - декриментирующий, т.е. обратный отсчёт; 
:*'''''inc''''' - инрементирующий, т.е. отчёт по возрастанию. 
'''''start_value = <number>''''' - начальное значение счетчика в реальных миллисекундах.
:Для декриментирующих счетчиков задавать обязательно. Для инкриментирующих, если не задано, то считается с 0. 
'''''on_value = <number>|%+info -info =func% <название_схемы>''''' - производит действие в зависимости от состояния счётчика. 
'''''string = <имя_текса>''''' - строка с '''''id''''' текста зарегистрированного в папке ''gamedata\config\text''.

'''''Пример использования схемы''''':<ini>[logic]
active = sr_idle

[sr_idle]
on_actor_inside = sr_timer@1

[sr_timer@1]
type = dec
start_value = 1000000
on_value = 5 | %=play_snd(characters_voice\scenario\radar\rad_hat_2)% | 0 | nil %=aes_kill_actor%
on_actor_outside = sr_idle
on_info = {+bar_deactivate_radar_done} nil
string = st_helmet_countdown</ini>

Файл: ''gamedata\scripts\sr_timer.script''

==Схема sr_psy_antenna==
Зоны с такой секцией позволяют управлять эффектами от пси-воздействия (на Янтаре и Радаре). Сейчас можно управлять интенсивностью излучения и интенсивностью получения повреждений. 

'''[sr_psy_antenna]''' 
'''''eff_intensity = <number>''''' - увеличение/уменьшение в процентах от базового значения интенсивности излучения. 
'''''hit_intensity = <nymber>''''' - увеличение/уменьшение в процентах от базового значения наносимого повреждения. 
'''''phantom_prob = <nymber>''''' - вероятность проявления фантомов в процентах. По умолчанию - 0. 
'''''postprocess = <имя_постэффекта>''''' - файл постэффекта, относительно папки ''gamedata\anims''. Расширение ставить обязательно! По умолчанию - ''psy_antenna.ppe''. 
'''''mute_sound_threshold = <number>''''' - предел до которого можно занижать звук уровня. 0 - глушит полностью, стоит по умолчанию. 

'''''Пример использования схемы''''':<ini>[logic]
active = sr_psy_antenna@good_helmet

[sr_psy_antenna@good_helmet]
eff_intensity = -10
hit_intensity = 0
phantom_prob = 45</ini>

Файл: ''gamedata\scripts\sr_psy_antenna.script''

==Схема sr_teleport==
Схема позволяет телепортировать актора в пределах локации.

'''[sr_teleport]''' 

'''''point = <имя_пути>''''' - патрульный путь из одной точки, куда переместится актор. 
'''''look = <имя_пути>''''' - патрульный путь из одной точки, куда будет смотреть актор после перемещения. 
'''''prob = <number>''''' - вероятность перемещения в заданную точку. По умолчанию - 100. 
'''''timeout = <number>''''' - задержка срабатывания телепорта в миллисекундах. По умолчанию - 900. 

Телепорты желательно ставить совместно с особой аномальной зоной (партиклом). Зона добавит визуализацию и создаст эффект втягивания. 

'''''Пример использования схемы''''':<ini>[logic]
active = sr_teleport

[sr_teleport]
point1 = aes2_teleport_walk_exit1
look1 = aes2_teleport_look_exit1
prob1 = 10
point2 = aes2_teleport_walk_exit2
look2 = aes2_teleport_look_exit2
prob2 = 20
timeout = 0</ini>

Файл: ''gamedata\scripts\sr_teleport.script''

==Схема sr_sleep==
Появилась возможность задавать зоны сна. 

'''[sr_sleep]''' 
'''''cond = {+info -info =func !func ~number}''''' - условия, при выполнении которых сон будет возможен. 
'''''type = nightmare/normal/happy/all''''' - задает тип сна разрешенный в данной зоне (по умолчанию '''''all'''''). Влияет (группирует) только на не сценарные сны.
'''''dream_prob = <number>''''' - вероятность просмотра не сценарных сновидений в данной зоне (по умолчанию 80). В противном случае будет только черный экран.

Необязательное поле '''''cond''''' задает условие(я), при котором в этой зоне можно спать. Сейчас производится индикация зон, где разрешен сон. В левом нижнем углу отображается маленькая иконка легких при входе в такую зону. Вероятно, позже будет изменена на другую. 
Сновидения теперь делятся на сценарные и обычные. Сценарные сновидения отыгрываются один раз при выполнении необходимых условий. Обычные сновидения проигрываются, если нет сценарных или ни одно условие выполнения сценарных не сработало. Можно задавать вероятность отыгрывания обычных сновидений в целом, а также задавать вероятность срабатывания каждого конкретного сновидения в отдельности. Обычным сновидениям можно задавать тип и потом ограничивать по нему сны воспроизводимые в управляемом файле. 

В файле ''misc\dream.ltx'' задаются настройки снов. 

Секция '''''videos'''''. 
Полями задаются пути к видео файлам со снами. 

Секция '''''dreams'''''. Поля: 
'''''regular_probability = <number>''''' - вероятность проигрывания обычных сновидений в целом; 
'''''regular = <секции>''''' - список секций с настройками для обычных сновидений; 
'''''scene = <секции>''''' - список секций с настройками для сценарных сновидений. 

Настройки обычных сновидений: 
'''''dream = <название>''''' - имя поля из секции '''''videos'''''; 
'''''probability = <number>''''' - чем больше, тем больше вероятность проигрывания сна; 
'''''type = nightmare/normal/happy''''' - тип сна. 

Настройки сценарных сновидений: 
'''''dream = <название>''''' - имя поля из секции '''''videos'''''; 
'''''cond = {+info -info =func !func ~number} - условия срабатывания; 
'''''to_regular = <number>,<тип>''''' - необязательное поле. Дает возможность переводить сценарный сон после первого отыгрыша в разряд обычных. <'''''number'''''>, <'''''тип'''''> аналогичны '''''probability''''' и '''''type''''' из настроек обычных сновидений соответственно. 

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

Файл: ''gamedata\scripts\sr_sleep.script''

==Схема sr_cutscene==

Эта схема предназначена для проведения анимации камеры c некоторым эффектом ('''''pp_effector'''''). Последовательность действий, осуществляемых схемой, состоит из мгновенного перемещения игрока в начало пути '''''point''''' и ориентации его взгляда на начало пути '''''look''''', потери управления игроком и начала анимации камеры '''''cam_effector''''' по завершении которой игрок вновь получает управление. 

'''[sr_cutscene]''' 
'''''point = <имя_пути>''''' - путь в первую точку которого переносится игрок. 
'''''look = <имя_пути>''''' - путь в первую точку которого смотрит игрок. 
'''''pp_effector = <имя_постэффекта>''''' - файл, расположенный в папке ''gamedata\anims\'' и содержащий эффект (имя файла пишется без расширения). 
'''''cam_effector = <имя_анимации_камеры>''''' - файл, расположенный в папке ''gamedata\anims\camera_effects\'' и содержащий анимацию камеры (имя файла пишется без расширения). 

Поддерживается сигнал '''''cameff_end'''''. 

'''''Пример использования схемы''''':<ini>[logic]
active = sr_idle

[sr_idle]
on_actor_inside = sr_cutscene

[sr_cutscene]
point = agr_cutscene_walk
look = agr_cutscene_look
cam_effector = agroprom_demo
on_signal = cameff_end | nil</ini>

Файл: ''gamedata\scripts\sr_cutscene.script''

----

[[Часть 4]]

[[Категория:A-Life]][[Категория:Скрипты]]

SoC. Создание квестов

2011-09-27T10:22:54Z

Losiara: /* Создание нового квеста */

==Создание квестов и диалогов==
===Создание базового диалога===

Итак, приступим к созданию диалога, в котором нам будет выдаваться новый квест.
Участвующие лица: Сидорович (С) и Меченый (М)

'''М:''' Здравствуй, Сидорыч! Есть работенка?

'''С:''' О, неужели заглянул к нам на огонек, Меченый? Ладно... ближе к телу... эээ, к делу. У меня к тебе следующая просьба: сбегай к Волку, у него что-то намечалось.

'''М:''' Без проблем! Уже бегу.

Будем считать, определились с фразами базового диалога. Теперь необходимо добавить его в соответствующем виде, чтобы игре он был «понятен».

Создание «скелета» диалога.

Для того, чтобы добавить наш диалог, необходимо открыть для редактирования файл gamedata\config\gameplay\dialogs_escape.xml

Для тех, кто знаком с языком XML структура данного файла будет ясна с первого взгляда. Но, поподробнее об этом.

Для того, чтобы добавить в игру диалог предусмотрены так называемые тэги. В данном случае, тэгами являются такие конструкции:

'''1.''' <tt><game_dialogs></tt> и закрывающий к нему - <tt></game_dialogs></tt>

'''2.''' <tt><dialog id = ""> закрывающий - </dialog></tt>

'''3.''' <tt><phrase_list> - </phrase_list></tt>

'''4.''' <tt><phrase id = ""> - </phrase></tt>

'''5.''' <code><text> </text></code>

'''6.''' <tt><next> </next></tt>

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

Поясню, что обозначает каждый тэг в отдельности.

'''1.''' Определяет содержимое файла (в данном случае, говорит о том, что файл содержит диалоги);

'''2.''' Определяет новый диалог с <tt>id = ""</tt>. Где содержимое кавычек есть идентификатор диалога. Идентификатор диалога задается в файлах типа character_description_***.xml ;

'''3.''' Этот тэг говорит XML-парсеру игры о том, что далее следуют фразы диалога. Иными словами, между <tt><phrase_list></tt> и <tt></phrase_list></tt> содержатся фразы диалога;

'''4.''' Этот тэг определяет фразу с <tt>id = ""</tt>. Внутри кавычек содержится идентификатор фразы (ВНИМАНИЕ: идентификатором в данном случае могут быть ТОЛЬКО цифры);

'''5.''' Внутри этих двух тэгов содержится ссылка на соответствующий данной фразе текст (пример, esc_trader_talk_info_123). Сам текст берется из файлов типа stable_dialogs_*****.xml, в котором содержатся все фразы в текстовом виде. О создании текста фразы поговорим позже;

'''6.''' Внутри этого тэга содержится ссылка (в числовом формате) на следующую (или следующие) фразы.

Теперь приступим к тэгам, позволяющим производить какие-то действия во время диалога.

<tt><precondition> </precondition></tt>. Представляет собой предусловие, в случае выполнения которого (то есть предусловие вернуло ИСТИНУ) данный диалог, или фраза будут появляться в списке доступных во время игры у NPC.

<tt><action> </action></tt>. Данный тэг позволяет производить какое-либо действие во время диалога (например, передачу предметов между общающимися... так же позволяет производить более сложные действия). Внутри тэга располагается ссылка на какую-либо функцию (например, dialogs. actor_set_dolg сделает игрока членом группировки Долг).

<tt><give_info> </give_info></tt>. Позволяет выдавать игроку во время диалога так называемые info_portion'ы (кстати, инфопоршны можно выдавать так же и через <action>, только это потребует создания специальной функции). info_portion – является основой для квестов, info_portion’ы определяются в файлах типа info****.xml. Инфопоршны могут, как начинать квест, так и заканчивать (завершать) его. Так же, с помощью инфопоршнов можно отслеживать действия игрока, для того, чтобы, например, вывести в нужное время диалог.
<tt><has_info> </has_info></tt> и <tt><dont_has_info> </dont_has_info></tt> являются предусловиями для текущей фразы/диалога. Первый тэг проверяет наличие данного инфопоршна у игрока, второй – отсутствие.

Ну что, теперь мы можем создать диалог, в котором нам будет выдаваться квест. Но мы не создали самих info_portion'оф, которые позволяет активировать квест.

===Создание info_portion'ов===

Итак, открываем файл gamedata\config\gameplay\ info_l01escape.xml. Что мы там видим? Правильно, все ту же структуру XML.
В данном файле нас интересуют только два тэга:

<code>
<info_portion id = ""> </info_portion>
</code>

<code>
<task> </task>
</code>

Первый объявляет сам info_portion. Второй – объявляет задание (идентификатор задания id содержится внутри тэга <task>)

Для примера, создадим 3 info_portion, которые понадобятся нам для будущего квеста:

<code>
<info_portion id = "new_task_started">
</code>

<code>
<task>new_task</task>
</code>

<code>
</info_portion>
</code>

Это инфопоршн с именем new_task_started. Он активирует квест с именем new_task.

<code>
<info_portion id = "player_talked_with_wolf">
</info_portion>
</code>

<code>
<info_portion id = "player_complete_new_task">
</info_portion>
</code>

===Создание нового квеста===

Сами квесты содержаться в файлах типа tasks_*****.xml

Откроем файл gamedata\config\gameplay\tasks_escape.xml. Структура – все тот же XML.

Для примера исследуем уже существующий квест:

<code>
<game_task id="esc_help_wounded_from_raid" prio="485">
<title>esc_help_wounded_from_raid</title>
<objective>
<text>esc_help_wounded_from_raid_0</text>
<icon>ui_iconsTotal_esc_help_wounded_from_raid</icon>
<function_complete>escape_tasks.task_fox_complete</function_complete>
<infoportion_set_complete>garbage_meetstalker_start</infoportion_set_complete>
<article>esc_fox_help</article>
</objective>
<objective>
<text>esc_help_wounded_from_raid_1</text>
<map_location_type hint="esc_fox">green_location</map_location_type>
<object_story_id>Escape_stalker_from_raid</object_story_id>
<infoportion_complete>escape_fox_heal</infoportion_complete>
<infoportion_fail>esc_dogs_return</infoportion_fail>
</objective>
<objective>
<text>esc_help_wounded_from_raid_2</text>
<map_location_type hint="esc_fox">green_location</map_location_type>
<object_story_id>Escape_stalker_from_raid</object_story_id>
<infoportion_complete>escape_stalker_done</infoportion_complete>
</objective>
</game_task>
</code>

По кусочкам:

<code>
<game_task id="esc_help_wounded_from_raid" prio="485">
</game_task>
</code>

Задает имя (id) нового квеста. В данном случае, esc_help_wounded_from_raid. prio = "" задает приоритет задачи. Чем выше приоритет, тем больше вероятность того, что текущий маркер квеста будет переключен на ваше задание.

<code>
<title>esc_help_wounded_from_raid</title>
</code>

Задает заголовок квеста. Т. е. его название. Название можно прописать в виде текста, либо в виде ссылки. В данном случае используется ссылка на текст, который хранится в файле string_table_tasks_escape.xml.

<code>
<function_complete>escape_tasks.task_fox_complete</function_complete>
</code>
Вызывает функцию из файла escape_tasks.script под именем task_fox_complete. Tсли все условия функции соблюдаются, то при выполнении данной функции подзадача становится выполненной.
<code>
<function_call_complete>agroprom_tasks.agr_trader_documents</function_call_complete>
</code>
выполняет функцию, после завершения подзадачи.

<code>
<infoportion_complete>escape_fox_heal</infoportion_complete>
</code>
Текущее подзадание будет завершено в случае, если игроку будет дан этот info_portion.

<code>
<infoportion_fail>esc_dogs_return</infoportion_fail>
</code>
Текущее подзадание будет провалено в случае, если игроку будет дан этот info_portion.

<code>
<map_location_type hint="esc_fox">green_location</map_location_type>
</code>
Создает указатель на карте с подсказкой esc_fox и типом green_location. Есть такие типы маркеров:
 green_location - зелёный маркер. Служит обычно для обозначения неодушевлённых предметов. Скажем чей-нибудь труп :)
 blue_location - синий маркер. Служит целью на человека.
 crlc_big - примерное место. К примеру зона поиска предмета.
<code>
<object_story_id>Escape_stalker_from_raid</object_story_id>
</code>
Указывает на sid из файла gamedata\config\game_story_ids.ltx

<code>
<infoportion_set_complete>garbage_meetstalker_start</infoportion_set_complete>
</code>
Автоматически устанавливает данную подзадачу в положение «Выполнено», если у игрока есть данный info_portion. //!!!!!!Не уверен – не пользовался не разу. Есть ещё версия, что выдаёт поршень, как только задача становится выполненной.

<code>
<text>esc_help_wounded_from_raid_0</text>
</code>
Содержит описание подзадачи. Может содержать внутри как текст, так и ссылку на текст.

Создадим задание, которое потребуется нам для диалога:

<code>
<game_task id="new_task">
<title>Поговорить с Волком</title>
<objective>
<text>Вернуться к Сидорычу</text>
<icon>ui_iconsTotal_find_item</icon>
<map_location_type hint="escape_trader">blue_location</map_location_type>
<object_story_id>Escape_Trader</object_story_id>
<infoportion_complete>player_complete_new_task</ infoportion_complete>
</objective>
<objective>
<text>Поговорить с Волком</text>
<map_location_type hint="volk">green_location</map_location_type>
<object_story_id>Escape_novice_lager_volk</object_story_id>
<infoportion_complete>player_talked_with_wolf</ infoportion_complete>
</objective>
<objective>
<text>Вернуться к Сидорычу</text>
<map_location_type hint="escape_trader">blue_location</map_location_type>
<object_story_id>Escape_Trader</object_story_id>
<infoportion_complete>player_complete_new_task</ infoportion_complete>
</objective>
</game_task>
</code>

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

Теперь создадим скелеты диалогов для нашего квеста. Потребуется три: один для Волка и два для Сидорыча.

<code>
<dialog id = "volk_new_quest">
<has_info>new_task_started</has_info>
<dont_has_info>player_talked_with_wolf</dont_has_info>
<dont_has_info> player_complete_new_task </dont_has_info>
<phrase_list>
<phrase id = "0">
<text>esc_volk_new_quest_0</text>
<next>1</next>
</phrase>
<phrase id = "1">
<text>esc_volk_new_quest_1</text>
<give_info>player_talked_with_wolf</give_info>
<next>2</next>
</phrase>
<phrase id = "2">
<text>esc_volk_new_quest_2</text>
<action>dialogs.break_dialog</action>
</phrase>

</phrase_list>
</dialog>

<dialog id = "esc_trader_new_quest">
<dont_has_info>player_complete_new_task</dont_has_info>
<dont_has_info>player_talked_with_wolf</dont_has_info>
<phrase_list>
<phrase id = "0">
<text>esc_trader_new_quest_0</text>
<next>1</next>
</phrase>
<phrase id = "1">
<text>esc_trader_new_quest_1</text>
<give_info>new_task_started</give_info>
<next>2</next>
</phrase>
<phrase id = "2">
<text>esc_trader_new_quest_2</text>
<action>dialogs.break_dialog</action>
</phrase>

</phrase_list>
</dialog>

<dialog id = "esc_trader_new_quest_complete">
<dont_has_info>player_complete_new_task</dont_has_info>
<phrase_list>
<phrase id = "0">
<text>esc_trader_new_quest_complete_0</text>
<next>1</next>
</phrase>
<phrase id = "1">
<text>esc_trader_new_quest_complete_1</text>
<give_info>player_complete_new_task</give_info>
<next>2</next>
</phrase>
<phrase id = "2">
<text>esc_trader_new_quest_complete_2</text>
<action>dialogs.break_dialog</action>
</phrase>
</phrase_list>
</dialog>
</code>

Все «скелеты» добавляем в файл dialogs_escape.xml. Между <game_dialogs> и <dialog id=...>!

''Внимательно следите за правильностью написания тэгов и ОДИНАКОВЫМ написанием идентификаций - как в файле с вашим новым диалогом, так и во всех других файлах, где используются тэги или ваши идентификации(например, идентификации фраз в файле с диалогом должны быть такими же, как и идентификации этих же фраз в файле с текстом). Иначе кроме серии вылетов с не всем понятными логами вы ничего не получите. У меня самого были проблемы при попытке активировать квест, выложеный в этой статье, так что пришлось кое-что поправить - и в тэгах, и в идентификаторах.''

Примечание: посмотрите на уже готовые диалоги, которые создали разработчики игры – это облегчит вам жизнь.

Теперь бежим в файл character_desc_escape.xml

Ищем там NPC с <tt>id = "escape_trader"</tt> и добавляем два новых <tt><actor_dialog></actor_dialog></tt>:

<code>
<actor_dialog>esc_trader_new_quest_complete </actor_dialog>
<actor_dialog>esc_trader_new_quest </actor_dialog>
</code>

Там же ищем NPC с id = "esc_wolf" и добавляем один актор_диалог:
<code>
<actor_dialog> volk_new_quest </actor_dialog>
</code>

Примечание: <tt><actor_dialog></tt> является диалогом, который активируется самим игроком по желанию. А <tt><start_dialog></tt> активируется только при выполнении определенных условий, заданных в нем, и обычно недоступен.

Осталось только добавить текст трех диалогов, чтобы наш квест стал полноценным. Открываем файл stable_dialogs_escape.xml и добавляем в него новый текст в таком виде:

<code><string id="esc_trader_new_quest_complete_0">
<text>Все, я выполнил поручение Волка!</text>
</string>
<string id="esc_trader_new_quest_complete_1">
<text>Молодец, Меченый. На тебя можно положиться.</text>
</string>
<string id="esc_trader_new_quest_complete_2">
<text>Рад был помочь, Сидорыч.</text>
</string>
<string id="esc_trader_new_quest_0">
<text> Здравствуй, Сидорыч! Есть работенка?</text>
</string>
<string id="esc_trader_new_quest_1">
<text>О, неужели заглянул к нам на огонек, Меченый? Ладно… ближе к телу… эээ, к делу. У меня к тебе следующая
просьба: сбегай к Волку, у него что-то намечалось.</text>
</string>
<string id=" esc_trader_new_quest_2">
<text>Без проблем! Уже бегу.</text>
</string>
<string id="esc_volk_new_quest_0">
<text>Здорово, Волк. Меня тут Сидорыч послал, говорит у тебя работа есть.</text>
</string>
<string id="esc_volk_new_quest_1">
<text>Привет, Меченый. Верь ты ему больше, этому старому маразматику! Все спокойно сейчас. Так что иди к нему и
скажи, что все хорошо.</text>
</string>
<string id="esc_volk_new_quest_2">
<text>Все, ухожу.</text>
</string>
</code>

Все! Поздравляю! Вы только что написали новый квест.

==Авторы==

Статья создана: [[Участник:Fr3nzy|Fr3nzy]]

== Внесённые изменения ==
*[[Участник:BerSerK™|BerSerK™]]

[[Категория:Конфигурационные файлы]]