Начальные сведения о скриптах

2013-08-01T12:44:55Z

95.135.223.167: Поправил недочёты. --# ColR_iT

ПРЕДИСЛОВИЕ
{{Message_box|
id =pseudoscience|
align = left|
backgroundcolor = #f9f9f9|
image =Lamp.gif|
heading = Для чего нужны срипты и сведения и их использовании - Rez@niy aka Oxygenium|
message = В скриптах содержаться данные для выполнения по условиям.

}}
 

Итак, начнём. Создадим в папке '''gamedata/scripts''' файл с любым названием и расширением '''.script'''. Пускай, '''my_test.script'''. В нем будем прописывать функции.
Рассмотрим простой скрипт спавна предмета в рюкзак ГГ. Пропишем:<lua>--*********************************************
--**TESTING**
--*********************************************
--
-- Создает в рюкзаке ГГ "калаш"
function ak_create()
alife():create("wpn_ak74", db.actor:position(), db.actor:level_vertex_id(), db.actor:game_vertex_id(), db.actor:id())
end</lua>
Давайте разбирать.
Игра считывает весь код из файла, поэтому не удивляйтесь, если игра вылетит при наличии лишнего текста, символов и прочего ненужного в скрипте. Однако, подобных проблем возникать не будет, если мы ''закомментируем'' лишнее. Чтобы игра не считывала текст, перед ним мы ставим две черточки, два минуса, два дефиса, в общем называйте как угодно:<lua>--</lua>
Часто таким образом оставляют словесную подсказку того, что делает данный участок кода, либо комментируют код, который на данный момент не нужен, но возможно пригодится в дальнейшем. В общем, зачастую комментарий - это пояснения к исходному тексту программы. В данном случае, система не будет считывать следующие строки:<lua>--*********************************************
--**TESTING**
--*********************************************
--
-- Создает в рюкзаке ГГ "калаш"</lua>
Идем дальше.
''function'' - всегда обязательное начало, это что-то в роде id в языке '''LUA'''. После ''function'' отступаем и пишем текст. Данный текст может состоять из букв латинского алфавита и цифр, при этом важно, чтобы этот текст начинался с буквы и в нём не содержалось пробелов. Этот текст будет названием функции. Не забываем в конце названия функции дописать две круглые скобки:
<lua>()</lua>
Это обязательный элемент. В нем указываются переменные функции, с которыми идет работа. В нашем случае таковых нету, но элемент обязателен.
Дальше идёт сам спавн объекта:
<lua>alife():create("wpn_ak74", db.actor:position(), db.actor:level_vertex_id(), db.actor:game_vertex_id(), db.actor:id())</lua>
В конце функции обязательно наличие ''end''. Он означает конец функции. Логично, правда? :)

Напоминаю, при таком раскладе АК-74 заспавнится в рюкзак ГГ.
Если же мы пожелаем заспавнить калаш где-нибудь на локации, вызов спавна приобретет следующий вид:
<lua>alife():create("wpn_ak74", vector():set(-81.800, -4.980, -72.739), 186578, 76)</lua>
АК заспавнится в вагончике, недалеко от Деревни новичков.

Но без детального разбора мы дальше, пожалуй,не пойдем. В целом, скелет функции спавна таким методом выглядит так:
<lua>function название_функции()
alife():create("имя_секции_предмета", vector():set(x,y,z), level_vertex_id, game_vertex_id)
end</lua>
Про конкретные значения.
''alife():create'' - стандартный вызов спавна
''vector():set'' - инициализация координат
''x,y,z'' - координаты места по долготе, высоте, ширине
''level_vertex_id'' и ''game_vertex_id'' - дополнительные координаты относительно локации
Все это нужно снимать в игре. Есть множество способов.
Что касается спавна в рюкзак ГГ, тут с координатами действует немного другая схема. Объект актора можно получить посредством вот такой записи: ''db.actor'', а получить его данные можно вот так:

''db.actor:position()'' - координаты x,y,z актера

''db.actor:level_vertex_id(),db.actor:game_vertex_id()'' - думаю, понятно

''db.actor:id()'' - дополнительный параметр, сам id актера, нужен, чтоб предмет заспавнился именно в рюкзак.

На самом деле, для спавна в инвентарь атору, значение координат, левел и гейм вертексов не важны, а ключевым является последний параметр - '''''id''''' актора, в игре оно всегда равно нулю. Т.е. заспавнить тот же "Калаш" в рюкзак можно и так:<lua>alife():create("wpn_ak74", vector(), 0, 0, 0)</lua>
 Написали? Отлично!
 Теперь осталось только подключить это к игре, то есть вызвать функцию спавна.
 Идём в файл '''dialogs_escape.xml''' и выбираем какой-нибудь диалог.
 Там, после поля ''text'', одной из фраз диалога приписываем:
<xml><action>my_test.ak_create</action></xml>
Как это понимать:
<xml><action>название_скрипта.название_функции</action></xml>
 Всё, сохраняем и тестируем. В итоге, когда вы в игре нажмёте на фразу после которой находится ''action'', заспауниться калаш на указанных координатах.

{{Message_box|
id =pseudoscience1|
align = left|
backgroundcolor = #f9f9f9|
image =Lamp.gif|
heading = Углублённое изучение - Rez@niy|
message = Далее идём в более углублённое изучение. Изучаем построение}}

Прописываем функцию. Задаём условие:
<code>if =</code>
Для закрытия тэга:
<code>end</code>

ПОКА ВСЁ, МОЖЕТ НАПИШУ ЕЩЁ ЧЁ НИТЬ ПОЛЕЗНОЕ

Ну и я напишу.'''Меченый(Стрелок)'''

Мой монолог построен так: В - Вопрос,О - Ответ

Начнём:
'''В''' - Что такое ЦИКЛ? И как он выглядит?
''О'' - Цикл это повторение одного и того же действие n-ое кол-во раз
выглядит так
<pre>for i=1,n do

end</pre>
За место i может быть любая переменная ,за место n - число которое больше первоначального значения(i)
'''В''' - А для чего можно использовать цикл?
''О'' - много для чего можно.см. ниже
Пример 1.Перебор по id/Узнаем монстор ли объект,если да ,то функция возвращает истину(true)
<lua>for id=1,65535 do
local obj = level.object_by_id(id)
if obj~= nil then
if IsMonster(obj) then
return true
else
return false
end
end
end</lua>
Пример 2.Спавн/
<lua>for i=1,5 do --функция повторится 5 раз,следовательно будет заспавнено 5 АК
local a = vector()
a.x = -220.21
a.y = -19.93
a.z = -158.98
alife():create("wpn_ak47",a,33447,47,65535)
end</lua>
и т.п.
существует ещё цикл с предусловием (while a,n do),но об этом позже
'''В''' - Какие параметры ГГ можно корректировать скриптами?
''О'' - Таких не много, запись будет такой :
<pre>db.actor.параметр</pre>
Параметры:
<pre>radiation
health
psy_health
power</pre>
'''В''' - а можно ли спавнить в рандомной точке предмет,если да,то как?
''О'' - можно
Для этого нам понадобится таблица максимальных значений ''level_vertex_id'' и ''game_vertex_id''
выглядит она так:

<ini>local level_vertexes={
l01_escape = {lvid=595580, gvid=44},
l02_garbage = {lvid=384039, gvid=265},
l03_agroprom = {lvid=438379, gvid=693},
l04_darkvalley = {lvid=392517, gvid=813},
l06_rostok = {lvid=69283, gvid=1311},
l07_military = {lvid=915663, gvid=1546},
l10_radar = {lvid=796328, gvid=1868},
l11_pripyat = {lvid=295965, gvid=2269}
}</ini>

ЗЫ:Извините ,что не для всех уровней,исправлюсь
Так,таблица у нас есть ,теперь нам нужно написать функцию спавна.Давайте покажу на Монстрах
создадим таблицу с секциями спавна монстров:
(Я буду использовать свои наработки ,поэтому таких секции у вас не будет ,эта таблица -пример)

<lua>local mutants = {
"zombie_ghost_hell",
"zombie_normal_hell",
"zombie_immortal_hell",
"bloodsucker_weak_hell",
"tushkano_normal_hell",
"snork_weak_hell",
"burer_weak_hell",
"cat_weak_hell",
"chimera_weak_hell",
"gigant_strong_hell"
}</lua>

Таблицу записали ,наконец приступим к оформлению главной функции
<lua>function random_spawn()
local count = math.random(5,20) --выбираем кол-во заспавненых мобов
local section = mutants[math.random(table.getn(mutants))] -- выбираем секцию моба
local lv = math.random(level_vertexes[level.name()]["lvid"]) --выбираем левел вертекс
local gv = level_vertexes[level.name()]["gvid"] --выбираем гэйм вертекс
for ind = 1, count do
alife():create(section, level.vertex_position(lv), lv, gv)--\\level.vertex_position(lv) - позиция левел вертекса
end
end</lua>

Далее помещаем вызов функции в '''bind_stalker.script''' в ''net_spawn()'' и при каждой загрузке будут спавнится мобы в рандомной точке
[[Категория:Скрипты]]

<big>Вступление ГГ в группировку!</big>
1.Создаем файл '''ваше_название_скприпта.script''' в папке '''gamedata/scripts'''
2. Открываем его и пишем:
--меняем группировку ГГ
<lua>function new_group(actor, npc)
if npc:character_community() ~= "(dolg)" then
npc:set_character_community("dolg", 0, 0)
end
end</lua>
Выдаём функцию при разговоре с НПС

НПС вступает в группировку
<pre>function ваше_название_функции(npc, actor)</pre>
Вызываем также, из любого диалога

<big>Нельзя взять оружие без брони</big>
Пишем функцию в любом скрипе:
<lua>function ваше_название_функции()
local armor = db.actor:item_in_slot(6) --слот брони (НЕ ТРОГАТЬ!)
local weapon = db.actor:item_in_slot(2) --слот оружия (для пистолетов в оригинале слот 1)

if db.actor:active_slot()==2 and weapon then -- за место 2 пишем слот оружия еще раз
local tmp
if armor then
tmp = armor:section()
else
tmp = "none"
end</lua>

<lua>if (not string.find(tmp, "пишем_название_брони" )) and (weapon:section()=="пишем_название_оружия1" or weapon:section()=="пишем_название_оружия2" or weapon:section()=="пишем_название_оружия3") then --если необходима проверка одного оружия то надо писать так: if (not string.find(tmp, "exo" )) and weapon:section()=="wpn_pkm" then
db.actor:drop_item(weapon)
local tmpw = amk.spawn_item_in_inv(weapon:section())
db.actor:transfer_item(weapon,db.actor)
alife():release(tmpw)
news_manager.send_tip(db.actor,"Невозможно взять пулемёт в руки без экзы",nil,nil,10000)
end
end</lua>

Далее идем по пути '''gamedata/script/bind_stalker.script'''
Функция:
<pre>function actor_binder:update(delta)</pre>
Сразу ниже неё пиши вызов в формате :
<code>название_файла.название_функции</code>
Можешь написать эту функцию в любом файле из папки '''scripts''', а можешь создать свой файл и назвать, скажем, '''my_script''', и написать там.
Должно быть так :
Код
<lua>function actor_binder:update(delta)
my_script.check_armor()</lua>

<big>Удаление предмета из инвентаря</big>

<lua>function name_function()
local se_obj = alife():object("сюда_пишем_что_удалять_будем")
if se_obj then
alife():release(se_obj, true)
end
end</lua>

ПРИМЕР
--' убираем финального Клыка
<lua>function dell_kluk_final()
local se_obj = alife():object("final_kluk")
if se_obj then
alife():release(se_obj, true)
end
end</lua>

Я добвлю может кому и пригодится.'''Болотный Доктор'''

ВЫДАЁМ ПРЕДМЕТ АКТОРУ
<lua>function название функции (first_speaker, second_speaker)
dialogs.relocate_item_section(second_speaker, "название предмета", "in")
end</lua>

Размещается в файлах скрипт.

Выдача поршня вставляется под строку действия.
<code><action>название скрипта.название функции</action></code>

Примечание, что бы выдать два одинаковых предмета пишем

<lua>function название функции (first_speaker, second_speaker)
dialogs.relocate_item_section(second_speaker, "название предмета", "in",2)
end</lua>

Если надо больше меняем цифру 2 на нужную нам.

ОТБИРАЕМ ПРЕДМЕТ У АКТОРА.
<lua>function название функции(first_speaker, second_speaker)
dialogs.relocate_item_section_from_actor(first_speaker, second_speaker, "название предмета")
end</lua>

размещается в файлах скрипт

выдача поршня вставляется под строку действия:
<code><action>название скрипта.название функции</action></code>

Примечание, что бы отобрать два одинаковых предмета пишем

<lua>function название функции(first_speaker, second_speaker)
dialogs.relocate_item_section_from_actor(first_speaker, second_speaker, "название предмета",2)
end</lua>
Если надо больше меняем цифру 2 на нужную нам.

СПАВНИМ ВЕЩЬ В РЮКЗАК гг
<lua>function название функции()
local obj = alife():create("ВЕЩЬ", db.actor:position(), db.actor:level_vertex_id(), db.actor:game_vertex_id(), db.actor:id())
end</lua>

В диалог:
<code><action>название скрипта.название функции</action></code>

ПРОВЕРКА НАЛИЧИЯ У АКТОРА ПРЕДМЕТА
Вариант первый
<lua>function Название функции()
if db.actor:object("название предмета") then
return true
end
return false
end</lua>

в диалог:

<code><precondition>имя скрипта.название функции</precondition></code>

<---------Вариант второй)------------------>

<lua>function название функции(first_speaker, second_speaker)
return first_speaker:object("название предмета") ~= nil
end</lua>

в диалог:

<code><precondition>имя скрипта.название функции</precondition></code>

ПРОВЕРКА ВЕЩЕЙ У ГГ
<lua>function Название функции(first_speaker, second_speaker)
return first_speaker:object("название предмета") ~= nil or
first_speaker:object("название предмета") ~= nil or
first_speaker:object("название предмета") ~= nil
end</lua>

в диалог:

<code><precondition>имя скрипта.название функции</precondition></code>

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

ПРОВЕРКА ДЕНЕГ У ГГ
Вариант первый(используют ПЫС)

<lua>function название функции(first_speaker, second_speaker)
return first_speaker:money() >= 2000
end</lua>

в диалог:

<precondition>имя скрипта.название функции</precondition>

<-----------Вариант два-------------->
Использовал на ТЧ, но и в ЗП работает

<lua>function название функции()
return db.actor:money()>=10000
end</lua>
В диалог:

<code><precondition>имя скрипта.название функции</precondition></code>

СПАВН ПРЕДМЕТА
<lua>function spawn_vintar()
alife():create("Название предмета",vector():set(24.725412368774,-3.6072344779968,173.83030700684),993926,210)
end</lua>

В диалог:

<code><action>название скрипта.название функции</action></code>

МГНОВЕННАЯ СМЕРТЬ ГГ
<lua>function название функции(npc, actor)
npc:kill(actor)
end</lua>

В диалог:

<code><action>название скрипта.название функции</action></code>

ПРОВЕРКА КОЛ_ВА ОДИНАКОВЫХ ПРЕДМЕТОВ
<lua>function название функции(first_speaker, second_speaker)
local item_sections = {"Предмет"}
local needed = количество одинаковых предметов, ставится цифра без знаков
local count = 0
local item_section
local function calc(temp, item)
if item:section() == item_section then
count = count + 1
end
end
for k,v in pairs(item_sections) do
item_section = v
get_story_object("actor"):iterate_inventory(calc, actor)
end
return count >= needed
end
</lua>

В диалог:
<code><precondition>имя скрипта.название функции</precondition></code>

ЛЕЧЕНИЕ ГГ
Вставим этот актион в диалог:

<code><action>dialogs.medic_magic_potion</action></code>

ВЫДАЧА ДЕНЕГ от НПС ГГ

<lua>function название функции(first_speaker, second_speaker)
dialogs.relocate_money_to_actor(first_speaker, second_speaker, 2000)
end</lua>

В диалог:

<code><action>название скрипта.название функции</action></code>

ВЫДАЧА ДЕНЕГ от ГГ НПС

<lua>function название функции(actor, npc)
dialogs.relocate_money(npc,кол-во,"out")
end</lua>

В диалог:

<code><action>название скрипта.название функции</action></code>

НПС становится врагом после определенной ветки диалона или другом -5000 враг 5000 друг

<lua>function название скрипта(actor, npc)
npc:force_set_goodwill(-5000, actor)
end</lua>

<code><action>название скрипта.название функции</action></code>

ПРОВЕРКА СМЕРТИ NPC

<lua>function название функции проверки(actor,npc)
return has_alife_info("инфо смерти")
end</lua>

В диалог:

<code><precondition>имя скрипта.название функции</precondition></code>

== Авторы ==
'''Оригинальный вид статьи:'''
*Rez@nyi
*Меченый
*Болотный Доктор
'''Переоформление, перестройка, дополнение статьи:'''
*FantomICW

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

Начальные сведения о скриптах