SoC. Смартеррейны и гулаги

2009-01-11T12:12:11Z

90.150.127.141:

В последнее время люди постоянно меня спрашивали как создать скрипт гулага для смартеррейнов. Чтобы постоянно не отвечать на каждое отдельное письмо, я решил написать небольшой тутор. Прежде чем начать, хотелось бы предупредить, что не являюсь экспертом в подобного рода вещах и некоторые моменты мне всё еще не ясны до конца, так что вероятно я не смогу объяснить всё правильно. Также я буду использовать ST как абревиатуру смартеррейна. Этот тутор посвящен НПС в ST, но он также сгодится и для мутантов. Предполагаю что вы знакомы с: 

- луа программированием 
- редактированием all.spawn 
- работа с вейпоинтами(патрульными путями) 
- утилитами аи

В первую очередить подумайте о своём ST, где бы его заспавнить, сколько нпс/мутантов будут в нем выполнять определенную "работу", когда ST должен активироваться/отключаться, сколько и какие состояния будет у вашего ST и тд. Думаю, наиболее эффективный способ объяснить вам как это работает на примере. Давайте предположим.. мы хотим поставить ST(smart terrain) на Кордоне для 3х бандитов.

1. Спавн ST:

<ini>
[2515]
; cse_abstract properties (основные параметры)
section_name = smart_terrain
name = esc_bandits_smart_terrain
position = 131.02030944824,0.065616846084595,-248.9094543457
direction = 0,0,0

; cse_alife_object properties (параметры объекта)
game_vertex_id = 635
distance = 9.09999942779541
level_vertex_id = 363757
object_flags = 0x==3e
custom_data = <<END
[smart_terrain]
type = esc_bandits_smart_terrain
cond = {-infoportion}
capacity = 3
squad = 1
groups = 5
respawn = esc_respawn_inventory_box_0002
END

; cse_shape properties (параметры шейпа объекта)
shapes = shape0
shape0:type = sphere
shape0:offset = 0,0,0
shape0:radius = 20.55957102775574

; cse_alife_space_restrictor properties (параметры рестриктора)
restrictor_type = 3

; se_smart_terrain properties (параметры смарттеррейна)
</ini>

Эта наиболее важная часть:

<ini>
type = esc_bandits_smart_terrain
cond = {-infoportion}
capacity = 3
squad = 1
groups = 5
respawn = esc_respawn_inventory_box_0002</source>
</ini>

'''type''' название вашего нового ST(обязательно) 
'''cond''' описывает условия, которые необходимы для включения гулага(по желанию) 
'''capacity''' количество мутантов/нпс, которое может вместить смарттеррейн(обязательно) 
'''squad, groups''' - номер сквада и количество групп(по желанию) 
'''respawn''' название тайника(синяя коробка) куда будут спавниться предметы, когда мы вызовем респавн в ST.(по желанию) 

2. Спавн нпс/мутантов и назначение(биндинг) их к нашему ST: для этого мы должны добавить каждому мутанту/нпс определенную логику:

<ini>
custom_data = <<END
[smart_terrains]
esc_bandits_smart_terrain = true
END
</ini>

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

3. Добавляем "работу" (логика) для каждого нпс/мутанта из нашего ST(для каждого состояния). Предположии у ST их два: состояние 0 (описывает какие нпс/мутанты "работают" днем) и состояние 1 (ночью). У нас 3 бандита, определяемся:

- bandit1: walker (состояние 0) и kamp (состояние 1) 
- bandit2: guard (состояние 0) и sleeper (состояние 1) 
- bandit3: walker (состояние 0 и 1 <= он делает тоже и днём, и ночью) 

У нас есть 3 способа добавить логику (работу) для каждого нпс/мутанта, мы будем использовать наиболее общепринятый способ, добавим логику в фаил config\misc\gulag_escape.ltx. Она должна выглядеть примерно так:

<ini>
;-- bandit1 (walker(прогуливающийся) -> состояние 0, днем)
[logic@esc_bandits_smart_terrain_bandit1_walker]
active = walker@esc_bandits_smart_terrain_bandit1

[walker@esc_bandits_smart_terrain_bandit1]
path_walk = bandit1_walk
danger = danger_condition@esc_bandits_smart_terrain
def_state_moving1 = patrol
def_state_moving2 = patrol
def_state_moving3 = patrol
meet = no_meet

;-- bandit1 (kamp(лагерь) -> состояние 1, ночью)
[logic@esc_bandits_smart_terrain_bandit1_kamp]
active = kamp@esc_bandits_smart_terrain_bandit1

[kamp@esc_bandits_smart_terrain_bandit1]
center_point = bandit_kamp
path_walk = bandit_kamp_task

;-- bandit2 (guard(охранник) -> состояние 0, днем)
[logic@esc_bandits_smart_terrain_bandit2_walker]
active = walker@esc_bandits_smart_terrain_bandit2

[walker@esc_bandits_smart_terrain_bandit2]
path_walk = bandit2_walk
path_look = bandit2_look
danger = danger_condition@esc_bandits_smart_terrain

;-- bandit2 (sleeper(спящий) -> состояние 1, ночью)
[logic@esc_bandits_smart_terrain_bandit2_sleeper]
active = sleeper@esc_bandits_smart_terrain_bandit2

[sleeper@esc_bandits_smart_terrain_bandit2]
path_main = bandit2_sleep
wakeable = false

;-- bandit3 (guard -> состояние 0 и 1, днем/ночью)
[logic@esc_bandits_smart_terrain_bandit3_walker]
active = walker@esc_bandits_smart_terrain_bandit3

[walker@esc_bandits_smart_terrain_bandit3]
path_walk = bandit3_walk
path_look = bandit3_look

[danger_condition@esc_bandits_smart_terrain]
ignore_distance_corpse = 0
ignore_distance = 0
</ini>

4. Теперь нам нужно заскриптовать наш ST. Так что добавим наш код в фаил скрипта \gulag_escape.script. Есть еще несколько моментов, которые мы должны здесь доделать (каждый из этих шагов обязателен):

- грузим логику (работу) для каждого нпс/мутанта и для каждого состояния -> function load_job(...)

<lua>
if type == "esc_bandits_smart_terrain" then
t = {}
;-- "соеденительная секция" для логики, определяем ltx фаилом
t.section = "logic@esc_bandits_smart_terrain_bandit1_walker"
;-- no idea, probably describes after what time
;-- npc will use this job again (?)
t.idle = 0
;-- no idea but i guess it's optional
t.timeout = 0
;-- пріоритет
t.prior = 100
;-- нпс будет использовать эту логику,
;-- если ST переключится в это состояние
;-- в этом случае - состояние 0 (день)
t.state = {0}
;-- Какой squad и group назначится персонажу принявшему эту работу.
t.squad = squad
t.group = groups[1]
;-- no idea what means position_threshold
t.position_threshold = 100
;-- описывает нпс в этом состоянии: онлайн или офлайн
;-- онлайн = истина по дефолту
t.online = true
;-- описывает рестрикторы (куда нпс могут/не могут пойти)
t.in_rest = ""
t.out_rest = ""
;-- ввиду особого способа присвоения работ в
;-- smart_terrain.script вы никогда не знаете, какая работа
;-- будет использоваться каждым нпсом; если вы хотите быть уверенным
;-- что конкретный нпс взял конкретную работу, тогда
;-- вам нужно заюзать предикатную функцию; в этом слуае
;-- мы хотим чтобы эта работа присвоилась мастеру бандиту
t.predicate = function(obj_info) return obj_info.rank >= 900 end
table.insert(sj, t)

t = {section = "logic@esc_bandits_smart_terrain_bandit1_kamp",
idle = 0, timeout = 0, prior = 100, state = {1},squad = squad,
group = groups[1], position_threshold = 100, online = true, in_rest = "",
out_rest = "", predicate = function(obj_info) return obj_info.rank >= 900 end}
table.insert(sj, t)

;-- bandit2 -> состояние 0 (день)
t = {section = "logic@esc_bandits_smart_terrain_bandit2_walker",
idle = 0, prior = 5, state = {0}, squad = squad, group = groups[1],
in_rest = "", out_rest = ""}
table.insert(sj, t)

;-- bandit2 -> состояние 1 (ночь)
t = {section = "logic@esc_bandits_smart_terrain_bandit2_sleeper",
idle = 0, prior = 5, state = {1}, squad = squad, group = groups[1],
in_rest = "", out_rest = ""}
table.insert(sj, t)

;-- bandit3 -> состояние 0 (день) и состояние 1 (ночь)
t = {section = "logic@esc_bandits_smart_terrain_bandit3_walker",
idle = 0, prior = 5, state = {0, 1}, squad = squad, group = groups[1],
in_rest = "", out_rest = ""}
table.insert(sj, t)
end
</lua>

Еще один момент о состояниях ST, всё зависит от того сколько у вас их в ST. Еще одна важной вещью является добавление логики для каждого состояния. Например в вашем ST такие состояния:

0 - нпс оффлайн 
1 - нпс онлайн (день) 
2 - нпс онлайн (ночь) 
3 - нпс онлайн, они решили напасть на другой ST 
4 - нпс онлайн, актор напал на них

К сведению, меня не прет заполнять такое большое количество таблиц, так что обычно я использую эту функцию:

<lua>
function fill_tbl(section, idle, prior, states, squad, group, in_rest, out_rest, online, gulag_name)
local tbl = {}

tbl.section = "logic@" .. gulag_name .. "_" .. section
tbl.idle = idle
tbl.prior = prior
tbl.state = {}

for index = 1, #states do
table.insert(tbl.state, states[index])
end

tbl.squad = squad
tbl.group = group
tbl.in_rest = in_rest
tbl.out_rest = out_rest
tbl.online = online
return tbl
end
</lua>

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

<lua>
if type == "esc_bandits_smart_terrain" then
local t = table.insert(sj, fill_tbl("bandit1_walker", 0, 100, {0}, squad, groups[1], "", "", true, type))
t.timeout = 0
t.position_threshold = 100
t.predicate = function(obj_info) return obj_info.rank >= 900 end
table.insert(sj, t)

t = table.insert(sj, fill_tbl("bandit1_kamp", 0, 100, {1}, squad, groups[1], "", "", true, type))
t.timeout = 0
t.position_threshold = 100
t.predicate = function(obj_info) return obj_info.rank >= 900 end
table.insert(sj, t)

table.insert(sj, fill_tbl("bandit2_walker", 0, 5, {0}, squad, groups[1], "", "", true, type))
table.insert(sj, fill_tbl("bandit2_sleeper", 0, 5, {1}, squad, groups[1], "", "", true, type))
table.insert(sj, fill_tbl("bandit3_walker", 0, 5, {0, 1}, squad, groups[1], "", "", true, type))
end
</lua>

- автоматически изменяем работу для каждого нпс/мутанта -> function load_states(...)

<lua>
if type == "esc_bandits_smart_terrain" then
return function(gulag)
if not db.actor then
return gulag.state
end
if level.get_time_hours() >= 5 and level.get_time_hours() <= 22 then
return 0 -- переключает всех мутантов/нпс на дневную работу
else
return 1 -- ереключает всех мутантов/нпс на ночную работу
end
end
end
</lua>

- убедитесь что наш ST будет использоваться только для бандитов -> function checkStalker(...)

<lua>
if gulag_type == "esc_bandits_smart_terrain" then
return npc_community == "bandit"
end
</lua>

Так же существуют универсальные гулаги General_lager для сталкеров. Они считаются упрощенными гулагами.

Пример, создаем смарт:
<lua>
[9999]
; cse_abstract properties (основные параметры)
section_name = smart_terrain
name = esc_gen_lager
position = 131.02030944824,0.065616846084595,-248.9094543457
direction = 0,0,0

; cse_alife_object properties (параметры объекта)
game_vertex_id = 635
distance = 9.09999942779541
level_vertex_id = 363757
object_flags = 0x==3e
custom_data = <<END
[smart_terrain]
type = general_lager
capacity = 3 ;вместимость
communities = bandit ; комьюнити населения
END

; cse_shape properties (параметры шейпа объекта)
shapes = shape0
shape0:type = sphere
shape0:offset = 0,0,0
shape0:radius = 20.55957102775574

; cse_alife_space_restrictor properties (параметры рестриктора)
restrictor_type = 3

; se_smart_terrain properties (параметры смарттеррейна)
</lua>

General_lager автоматически соберет все точки путей на уровне начинающиеся на имя смарта(в нашем случае esc_gen_lager)
и разделит их названия таким образом:
(имя_смарта)_(аи схема)_(номер если требуется,напрмер если 2 walkerа то 1 и 2 соответственно)_(поднастройка схемы)_(состояние гулага 1 или 0,день или ночь)
пример:
esc_gen_lager _walker _1 _walk _1 (walk то же что и path_walk,look это path_look соответственно)

Пришедший на general_lager сталкер рандомно примет любую свободную работу
работой считается комбинация схем с одним номером.
например esc_gen_lager_walker_1_walk_1 и esc_gen_lager_walker_1_look_1 это схема дневной работы одного персонажа из гулага.

Так что для каждого general_lager нужны заранее расставленые точки путей для него.

== Автор ==

[[Dez0wave]]

== Перевод ==
[[Loxotron]]

== Дополнял ==
[[IamFarsight]]

==Ссылки==
[http://www.gsc-game.com/main.php?t=community&s=forums&s_game_type=xr&thm_page=77&thm_id=14712&sec_id=16&page=1#199726 Обсуждение тут]

Используйте нашу утилиту для дебаггинга смартеррейнов и экспорта вейпоинтов:

[http://sdk.stalker-game.com/ru/images/d/d7/Smartterrain_and_Waypoint_Tools_by_dez0wave.zip Скачать Smartterrain and Waypoint Tools]

[http://ifolder.ru/7179080 Зеркало на всякий случай]

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

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

SoC. Смартеррейны и гулаги