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

Назначение скриптам горячих кнопок. Часть 2. Интерфейс

2009-10-14T20:47:52Z

Wasly: /* Скрипт */

== Введение ==

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

Способ вызова нашего скрипта останется прежним, '''Esc - F1''', но вызывать окно можно и из диалогов, и по некоторому событию, в общем простор для мододелов огромный. Я использовал уже имеющиеся текстуры и элементы управления, но никто не запрещает использовать свои. Для рамки я выбрал текстуру '''ui\ui_dg_inventory''', а кнопки брал из '''ui\ui_common'''.

== Скрипт ==

Будем использовать тот же скрипт '''ui_cheat.script''', но немного видоизмененный. Я приведу его содержание полностью, а потом начнем его дополнять.

Начало:
<code lua>
class "cheat" (CUIScriptWnd)

-- инициализируем элементы интерфейса и каллбаки
function cheat:__init(owner) super()
self.owner = owner
self:InitControls()
self:InitCallBacks()
end

function cheat:__finalize()

end

function cheat:InitControls()
-- здесь определяем координаты левого верхнего угла и ширину-высоту
self:Init(50,50,550,450)

-- файл-описатель наших элементов
local xml = CScriptXmlInit()
xml:ParseFile("ui_cheat_wnd.xml")

-- видео на заднем плане
xml:InitStatic("back_video", self)

-- рамка
xml:InitStatic("background", self)

-- кнопки
self:Register(xml:Init3tButton("btn_1", self),"btn_1")
self:Register(xml:Init3tButton("btn_2", self),"btn_2")
self:Register(xml:Init3tButton("btn_3", self),"btn_3")
-- кнопка выхода
self:Register(xml:Init3tButton("btn_quit", self),"btn_quit")

end

function cheat:InitCallBacks()
-- тут интерактивные элементы, при определенном действии выполняется заданная ф-ия
self:AddCallback("btn_1", ui_events.BUTTON_CLICKED, self.cheat1, self)
self:AddCallback("btn_2", ui_events.BUTTON_CLICKED, self.cheat2, self)
self:AddCallback("btn_3", ui_events.BUTTON_CLICKED, self.cheat3, self)
self:AddCallback("btn_quit", ui_events.BUTTON_CLICKED, self.on_quit, self)
end
</code>
Теперь на имеющиеся кнопки прикрутим ф-ии, которые будут что-нибудь делать.
<code lua>
function cheat:cheat1()
-- колдуем СВД
self:spawn_item("wpn_svd_m1", 3)
end
function cheat:cheat2()
-- патроны к ней
self:spawn_item("ammo_7.62x54_ap", 3)
end
function cheat:cheat3()
-- и того, кого будем из СВД мучать
self:spawn_item("dog_weak", 30)
end

function cheat:check_game()
-- возвращает true, если запущена игра
local check = false
if level.present() and (db.actor ~= nil) and db.actor:alive() then
check = true
end
return check
end

function cheat:on_quit()
-- убираем наше окно, показываем предыдущее (или возвращаемся в игру)
local console = get_console()
self:GetHolder():start_stop_menu (self.owner, true)
self:GetHolder():start_stop_menu (self,true)
self.owner:Show (true)
-- скрытие главного меню только если запущена игра
if self:check_game() then
console:execute("main_menu off")
end
end

function cheat:spawn_item(spawn_item, dist)
-- спавним только в игре
if self:check_game() then
self:on_quit()
local pos = db.actor:position()
local dir = db.actor:direction()
pos = pos:add(dir:mul(dist))
alife():create(spawn_item, pos, 1, db.actor:game_vertex_id())
end
end
</code>
Скриптовую часть закончили. Теперь надо "нарисовать" интерфейс. Инструмент для его создания пока отсутствует (по крайней мере у нас), поэтому будем делать ручками, методом проб и ошибок.

== XML-описатель ==

Так как мы уже определили файл, который будет содержать расположение элементов (''xml:ParseFile("ui_cheat_wnd.xml")''), то создадим его. Полный путь до файла: '''config\ui\ui_cheat_wnd.xml'''.

Вот его содержание:
<code xml>
<?xml version="1.0" encoding="windows-1251" ?>

<cheat>
<back_video x="10" y="10" width="380" height="320" stretch="1">
<texture>ui\1_hyuv_sq</texture>
</back_video>

<background x="0" y="0" width="400" height="340" stretch="1">
<texture x="0" y="0" width="350" height="460">ui\ui_dg_inventory</texture>
</background>

<btn_1 x="20" y="30" width="117" height="29">
<texture_e>ui_button_ordinary_e</texture_e>
<text>wpn-svd</text>
</btn_1>

<btn_2 x="20" y="60" width="117" height="29">
<texture_e>ui_button_ordinary_e</texture_e>
<text>Патроны</text>
</btn_2>

<btn_3 x="20" y="90" width="117" height="29">
<texture_e>ui_button_ordinary_e</texture_e>
<text>Собака</text>
</btn_3>

<btn_quit x="270" y="300" width="117" height="29">
<texture_e>ui_button_ordinary_e</texture_e>
<text>ui_inv_exit</text>
</btn_quit>

</cheat>
</code>

== Погружение ==

=== Видео ===

Разберем построчно. Так как ф-ия '''cheat:InitControls()''' сначала отображает видеоролик (чтобы он оказался под всеми элементами, с него и начнем.

<code xml><back_video x="10" y="10" width="380" height="320" stretch="1"></code>
Название элемента должно совпадать с именем, которое присутствует в '''xml:InitStatic("back_video", self)'''

'''x,y''' - координаты левого верхнего угла относительно объявленного в '''self:Init'''

'''width, height''' - ширина-высота

'''stretch="1"''' - указывает на необходимость растягивания элемента
<code xml><texture>ui\1_hyuv_sq</texture></code>
Используется видеоролик находящися по адресу '''textures\ui\1_hyuv_sq.ogm'''. Его исходные размеры - 512х512, поэтому нам и понадобилось растягивание, вернее так называемый стретч.
<code xml></back_video></code>
конец элемента.

=== Бэкграунд ===

<code xml><background x="0" y="0" width="400" height="340" stretch="1"></code>
координаты, размеры, растягивание, все как и выше
<code xml><texture x="0" y="0" width="350" height="460">ui\ui_dg_inventory</texture></code>
а вот здесь ссылка на используемую текстуру. Мы не стали рисовать свою, а взяли уже имеющуюся, поэтому задаваемые здесь координаты и размеры означают, что нужно взять текстуру '''ui\ui_dg_inventory.dds''' и вырезать из нее нужный нам кусок. Обратите внимание, что размеры вырезанной части и определенные нами не совпадают, маловата текстура оказалась, поэтому пришлось ее растягивать ;)
<code xml></background></code>
конец элемента.

=== Кнопки ===

<code xml><btn_1 x="20" y="30" width="117" height="29"></code>
координаты, размеры, без растягивания, все как и выше. Но, здесь это означает размеры интерактивной области. Если указать иные размеры, то кнопка будет реагировать только в указанной зоне. Если указать нулевые размеры, то кнопка вообще перестанет быть интерактивной.
<code xml><texture_e>ui_button_ordinary_e</texture_e></code>
а вот тут уже интереснее. не пытайтесь искать текстуру с именем ui_button_ordinary_e. Она описана в другом файле, '''config\ui\ui_common.xml'''. Ссылка на этот файл входит в секцию '''[texture_desc]''' в '''system.ltx'''. То есть, если вы создали свой файл-описатель интерфейса, то нужно проставить ссылку на этот файл в вышеописанной секции.
<code xml><text>wpn-svd</text></code>
текст на кнопке. Здесь тоже не все так просто. Сначала игра ищет выражение '''wpn-svd''' в файлах заданных в секции '''[string_table]''' файла '''localization.ltx''', то есть зависит от установленного языка. В данном случае ссылка на '''wpn-svd''' есть в файле '''config\text\rus\string_table_enc_weapons.xml''', и равно
<code xml><string id="wpn-svd"><text>СВДм 2</text></string></code>
При таком способе установки текстового значения мы не будем зависеть от языка игры и сможем создавать не привязанные к языку моды.

Если посмотреть на вторую кнопку, то ее текстовое значение равно
<code xml><text>Патроны</text></code>
Такого значения игра не найдет и просто отобразит так как есть. Но англоязычные пользователи врядли поймут написанное. Поэтому я лично рекомендую использовать уже имеющиеся ресурсы, и минимально вмешиваться в ресурсы и добавлять новые. Но, например, файл с названиями машин ('''string_table_enc_vehicles.xml''') не входит в файл '''localization.ltx''', поэтому придется его туда подключить, либо указать конечному пользователю на необходимость добавления одной строчки в этот файл.

Ну кнопочка "Выход" сделана вот так:
<code xml><text>ui_inv_exit</text></code>

== Продолжение ==

Все. Сохраняем, запускаем игру, жмем '''Esc - F1''', и видим наше окошко. Можно понажимать на кнопки и увидеть что они какие-то неинтерактивные. То есть никак не реагируют на наведение мыши и нажатие. Но это легко поправимо. В игре все для этого есть. Достаточно оформить кнопку вот так (пример для одной, остальные аналогично):
<code lua><btn_quit x="270" y="300" width="117" height="29">
<texture_e>ui_button_ordinary_e</texture_e>
<texture_t>ui_button_ordinary_t</texture_t>
<texture_h>ui_button_ordinary_h</texture_h>
<text>ui_inv_exit</text>
</btn_quit></code>
Обозначения:
*texture_e - вид кнопки по умолчанию
*texture_t - вид кнопки при нажатии
*texture_h - вид кнопки при наведении мыши
есть еще одно состояние, '''texture_d''', оно означает текстуру выключенной кнопки. Можно скриптами задавать состояние кнопки (включена-выключена), но об этом в другой раз.

Поизучайте файлик '''ui_common.xml''' на предмет других элементов, там еще много интересного.

== Внимание ==

Так как скрипт спавна изменен по сравнению с первой статьей (добавлен вызов '''self:on_quit()''' перед самим спавном), то функцию привязки к клавишам следует оформить следующим образом:
<code lua>function cheat:OnKeyboard(dik, keyboard_action)
CUIScriptWnd.OnKeyboard(self,dik,keyboard_action)
if keyboard_action == ui_events.WINDOW_KEY_PRESSED then
-- отсюда убран вызов self:on_quit()
if dik == DIK_keys.DIK_ESCAPE then self:on_quit()
elseif dik == DIK_keys.DIK_NUMPAD1 then self:cheat1()
elseif dik == DIK_keys.DIK_NUMPAD2 then self:cheat2()
elseif dik == DIK_keys.DIK_NUMPAD3 then self:cheat3()
elseif dik == DIK_keys.DIK_NUMPAD4 then self:cheat4()
elseif dik == DIK_keys.DIK_NUMPAD5 then self:cheat5()
elseif dik == DIK_keys.DIK_NUMPAD6 then self:cheat6()
elseif dik == DIK_keys.DIK_NUMPAD7 then self:cheat7()
elseif dik == DIK_keys.DIK_NUMPAD8 then self:cheat8()
elseif dik == DIK_keys.DIK_NUMPAD9 then self:cheat9()
end
end
return true
end</code>

== Ссылки ==

*[[Назначение скриптам горячих кнопок. Часть 1. Скрипт|Первая часть статьи]]
*[[Bind_script_ui_script_2|Полный текст скрипта ui_cheats.script (нового)]]
*[[Bind_script_ui_xml|Полный текст ui_cheat_wnd.xml]]

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

Назначение скриптам горячих кнопок. Часть 2. Интерфейс

2009-10-14T20:45:09Z

Wasly: /* Введение */

== Введение ==

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

Способ вызова нашего скрипта останется прежним, '''Esc - F1''', но вызывать окно можно и из диалогов, и по некоторому событию, в общем простор для мододелов огромный. Я использовал уже имеющиеся текстуры и элементы управления, но никто не запрещает использовать свои. Для рамки я выбрал текстуру '''ui\ui_dg_inventory''', а кнопки брал из '''ui\ui_common'''.

== Скрипт ==

Будем использовать тот же скрипт '''ui_cheat.script''', но немного видоизмененный. Я приведу его содержание полностью, а потом начнем его дополнять.

Начало:
<code lua>
class "cheat" (CUIScriptWnd)

-- инициализируем элементы интерфейса и каллбаки
function cheat:__init(owner) super()
self.owner = owner
self:InitControls()
self:InitCallBacks()
end

function cheat:__finalize()

end

function cheat:InitControls()
-- здесь определяем координаты левого верхнего угла и ширину-высоту
self:Init(50,50,550,450)

-- файл-описатель наших элементов
local xml = CScriptXmlInit()
xml:ParseFile("ui_cheat_wnd.xml")

-- видео на заднем плане
xml:InitStatic("back_video", self)

-- рамка
xml:InitStatic("background", self)

-- кнопки
self:Register(xml:Init3tButton("btn_1", self),"btn_1")
self:Register(xml:Init3tButton("btn_2", self),"btn_2")
self:Register(xml:Init3tButton("btn_3", self),"btn_3")
-- кнопка выхода
self:Register(xml:Init3tButton("btn_quit", self),"btn_quit")

end

function cheat:InitCallBacks()
-- тут интерактивные элементы, при определенном действии выполняется заданная ф-ия
self:AddCallback("btn_1", ui_events.BUTTON_CLICKED, self.cheat1, self)
self:AddCallback("btn_2", ui_events.BUTTON_CLICKED, self.cheat2, self)
self:AddCallback("btn_3", ui_events.BUTTON_CLICKED, self.cheat3, self)
self:AddCallback("btn_quit", ui_events.BUTTON_CLICKED, self.on_quit, self)
end
</code>
Теперь на имеющиеся кнопки прикрутим ф-ии, которые будут что-нибудь делать.
<code lua>
function cheat:cheat1()
-- колдуем СВД
self:spawn_item("wpn_svd_m1", 3)
end
function cheat:cheat2()
-- патроны к ней
self:spawn_item("ammo_7.62x54_ap", 3)
end
function cheat:cheat3()
-- и того, кого будем из СВД мучать
self:spawn_item("dog_weak", 30)
end

function cheat:check_game()
-- возвращает true если запущена игра
local check = false
if level.present() and (db.actor ~= nil) and db.actor:alive() then
check = true
end
return check
end

function cheat:on_quit()
-- убираем наше окно, показываем предыдущее (или возвращаемся в игру)
local console = get_console()
self:GetHolder():start_stop_menu (self.owner, true)
self:GetHolder():start_stop_menu (self,true)
self.owner:Show (true)
-- скрытие главного меню только если запущена игра
if self:check_game() then
console:execute("main_menu off")
end
end

function cheat:spawn_item(spawn_item, dist)
-- спавним только в игре
if self:check_game() then
self:on_quit()
local pos = db.actor:position()
local dir = db.actor:direction()
pos = pos:add(dir:mul(dist))
alife():create(spawn_item, pos, 1, db.actor:game_vertex_id())
end
end
</code>
Скриптовую часть закончили. Теперь надо "нарисовать" интерфейс. Инструмет для его создания пока отсутствует (по крайней мере у нас), поэтому будем делать ручками, методом проб и ошибок.

== XML-описатель ==

Так как мы уже определили файл, который будет содержать расположение элементов (''xml:ParseFile("ui_cheat_wnd.xml")''), то создадим его. Полный путь до файла: '''config\ui\ui_cheat_wnd.xml'''.

Вот его содержание:
<code xml>
<?xml version="1.0" encoding="windows-1251" ?>

<cheat>
<back_video x="10" y="10" width="380" height="320" stretch="1">
<texture>ui\1_hyuv_sq</texture>
</back_video>

<background x="0" y="0" width="400" height="340" stretch="1">
<texture x="0" y="0" width="350" height="460">ui\ui_dg_inventory</texture>
</background>

<btn_1 x="20" y="30" width="117" height="29">
<texture_e>ui_button_ordinary_e</texture_e>
<text>wpn-svd</text>
</btn_1>

<btn_2 x="20" y="60" width="117" height="29">
<texture_e>ui_button_ordinary_e</texture_e>
<text>Патроны</text>
</btn_2>

<btn_3 x="20" y="90" width="117" height="29">
<texture_e>ui_button_ordinary_e</texture_e>
<text>Собака</text>
</btn_3>

<btn_quit x="270" y="300" width="117" height="29">
<texture_e>ui_button_ordinary_e</texture_e>
<text>ui_inv_exit</text>
</btn_quit>

</cheat>
</code>

== Погружение ==

=== Видео ===

Разберем построчно. Так как ф-ия '''cheat:InitControls()''' сначала отображает видеоролик (чтобы он оказался под всеми элементами, с него и начнем.

<code xml><back_video x="10" y="10" width="380" height="320" stretch="1"></code>
Название элемента должно совпадать с именем, которое присутствует в '''xml:InitStatic("back_video", self)'''

'''x,y''' - координаты левого верхнего угла относительно объявленного в '''self:Init'''

'''width, height''' - ширина-высота

'''stretch="1"''' - указывает на необходимость растягивания элемента
<code xml><texture>ui\1_hyuv_sq</texture></code>
Используется видеоролик находящися по адресу '''textures\ui\1_hyuv_sq.ogm'''. Его исходные размеры - 512х512, поэтому нам и понадобилось растягивание, вернее так называемый стретч.
<code xml></back_video></code>
конец элемента.

=== Бэкграунд ===

<code xml><background x="0" y="0" width="400" height="340" stretch="1"></code>
координаты, размеры, растягивание, все как и выше
<code xml><texture x="0" y="0" width="350" height="460">ui\ui_dg_inventory</texture></code>
а вот здесь ссылка на используемую текстуру. Мы не стали рисовать свою, а взяли уже имеющуюся, поэтому задаваемые здесь координаты и размеры означают, что нужно взять текстуру '''ui\ui_dg_inventory.dds''' и вырезать из нее нужный нам кусок. Обратите внимание, что размеры вырезанной части и определенные нами не совпадают, маловата текстура оказалась, поэтому пришлось ее растягивать ;)
<code xml></background></code>
конец элемента.

=== Кнопки ===

<code xml><btn_1 x="20" y="30" width="117" height="29"></code>
координаты, размеры, без растягивания, все как и выше. Но, здесь это означает размеры интерактивной области. Если указать иные размеры, то кнопка будет реагировать только в указанной зоне. Если указать нулевые размеры, то кнопка вообще перестанет быть интерактивной.
<code xml><texture_e>ui_button_ordinary_e</texture_e></code>
а вот тут уже интереснее. не пытайтесь искать текстуру с именем ui_button_ordinary_e. Она описана в другом файле, '''config\ui\ui_common.xml'''. Ссылка на этот файл входит в секцию '''[texture_desc]''' в '''system.ltx'''. То есть, если вы создали свой файл-описатель интерфейса, то нужно проставить ссылку на этот файл в вышеописанной секции.
<code xml><text>wpn-svd</text></code>
текст на кнопке. Здесь тоже не все так просто. Сначала игра ищет выражение '''wpn-svd''' в файлах заданных в секции '''[string_table]''' файла '''localization.ltx''', то есть зависит от установленного языка. В данном случае ссылка на '''wpn-svd''' есть в файле '''config\text\rus\string_table_enc_weapons.xml''', и равно
<code xml><string id="wpn-svd"><text>СВДм 2</text></string></code>
При таком способе установки текстового значения мы не будем зависеть от языка игры и сможем создавать не привязанные к языку моды.

Если посмотреть на вторую кнопку, то ее текстовое значение равно
<code xml><text>Патроны</text></code>
Такого значения игра не найдет и просто отобразит так как есть. Но англоязычные пользователи врядли поймут написанное. Поэтому я лично рекомендую использовать уже имеющиеся ресурсы, и минимально вмешиваться в ресурсы и добавлять новые. Но, например, файл с названиями машин ('''string_table_enc_vehicles.xml''') не входит в файл '''localization.ltx''', поэтому придется его туда подключить, либо указать конечному пользователю на необходимость добавления одной строчки в этот файл.

Ну кнопочка "Выход" сделана вот так:
<code xml><text>ui_inv_exit</text></code>

== Продолжение ==

Все. Сохраняем, запускаем игру, жмем '''Esc - F1''', и видим наше окошко. Можно понажимать на кнопки и увидеть что они какие-то неинтерактивные. То есть никак не реагируют на наведение мыши и нажатие. Но это легко поправимо. В игре все для этого есть. Достаточно оформить кнопку вот так (пример для одной, остальные аналогично):
<code lua><btn_quit x="270" y="300" width="117" height="29">
<texture_e>ui_button_ordinary_e</texture_e>
<texture_t>ui_button_ordinary_t</texture_t>
<texture_h>ui_button_ordinary_h</texture_h>
<text>ui_inv_exit</text>
</btn_quit></code>
Обозначения:
*texture_e - вид кнопки по умолчанию
*texture_t - вид кнопки при нажатии
*texture_h - вид кнопки при наведении мыши
есть еще одно состояние, '''texture_d''', оно означает текстуру выключенной кнопки. Можно скриптами задавать состояние кнопки (включена-выключена), но об этом в другой раз.

Поизучайте файлик '''ui_common.xml''' на предмет других элементов, там еще много интересного.

== Внимание ==

Так как скрипт спавна изменен по сравнению с первой статьей (добавлен вызов '''self:on_quit()''' перед самим спавном), то функцию привязки к клавишам следует оформить следующим образом:
<code lua>function cheat:OnKeyboard(dik, keyboard_action)
CUIScriptWnd.OnKeyboard(self,dik,keyboard_action)
if keyboard_action == ui_events.WINDOW_KEY_PRESSED then
-- отсюда убран вызов self:on_quit()
if dik == DIK_keys.DIK_ESCAPE then self:on_quit()
elseif dik == DIK_keys.DIK_NUMPAD1 then self:cheat1()
elseif dik == DIK_keys.DIK_NUMPAD2 then self:cheat2()
elseif dik == DIK_keys.DIK_NUMPAD3 then self:cheat3()
elseif dik == DIK_keys.DIK_NUMPAD4 then self:cheat4()
elseif dik == DIK_keys.DIK_NUMPAD5 then self:cheat5()
elseif dik == DIK_keys.DIK_NUMPAD6 then self:cheat6()
elseif dik == DIK_keys.DIK_NUMPAD7 then self:cheat7()
elseif dik == DIK_keys.DIK_NUMPAD8 then self:cheat8()
elseif dik == DIK_keys.DIK_NUMPAD9 then self:cheat9()
end
end
return true
end</code>

== Ссылки ==

*[[Назначение скриптам горячих кнопок. Часть 1. Скрипт|Первая часть статьи]]
*[[Bind_script_ui_script_2|Полный текст скрипта ui_cheats.script (нового)]]
*[[Bind_script_ui_xml|Полный текст ui_cheat_wnd.xml]]

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

Назначение скриптам горячих кнопок. Часть 1. Скрипт

2009-10-14T20:41:24Z

Wasly: /* Сон по желанию */

== Вступление ==

Поизучав [http://shooter-szene.4players.de/modules/PNphpBB2/files/jeppa_s_mod__v1.05__incl.vehicles_946.zip мод] от камрада Jeppa, решил создать небольшое руководство по созданию новых интерфейсных окон, привязки скриптов на кнопки, реакцию на нажатия клавиш, спавн предметов прямо в игре.

К сожалению в самой игре возможность прибиндить запуск скрипта или еще какое действие на новую кнопку отсутствует, поэтому приходится придумывать что-то свое. Jeppa вышел из положения создав новое диалоговое окно на основе старого интерфейса загрузки спавн файлов. Он добавил на него 10 кнопок с описаниями, при нажатии на каждую вызывался какой-либо скрипт или функция.

Нам понадобятся следующие распакованные (или имеющиеся) файлы:
config\system.ltx
scripts\ui_main_menu.script
Остальное будем делать с нуля. Я придерживаюсь политики минимального вмешательства в уже имеющиеся файлы.

== Скрипт ==

Итак, как это сделать. Начнем с самого простого. Сначала создадим наш новый скрипт, который и будет заниматься вызовом других скриптов. Назовем его '''ui_cheat.script''' и положим ко всем остальным скриптам.

{| class="collapsible collapsed"
|-
! Вот его содержание:
|-
|
<code lua>-- инициализация
class "cheat" (CUIScriptWnd)

function cheat:__init(owner) super()
self.owner = owner
self:InitControls()
self:InitCallBacks()
end

function cheat:__finalize() end

function cheat:InitControls()
-- здесь будут все контролы
end

function cheat:InitCallBacks()
-- здесь будут все каллбаки (ну, или обработчики)
end

-- сразу создадим ф-ию для выхода
function cheat:on_quit()
local console = get_console()
self:GetHolder():start_stop_menu (self.owner, true)
self:GetHolder():start_stop_menu (self,true)
self.owner:Show (true)
-- если мы вызывались из игры, то убираем главное меню
if level.present() and (db.actor ~= nil) and db.actor:alive() then
console:execute("main_menu off")
end
end</code>
|}
Теперь нужно как-то этот скрипт вызвать. Я решил пойти по проторенной дорожке и вызывать его из главного меню. Пока мы не будем создавать там новых кнопок, а повесим его запуск на горячую клавишу. Например, на F1, из игры будет удобно жать Esc и сразу F1. Но можете и другую кнопку использовать. Итак, открываем файл '''ui_main_menu.script''', идем в самый конец и ищем там такую ф-ию:
<code lua>function main_menu:OnKeyboard(dik, keyboard_action)</code>
Это обработчик нажатий клавиш. Используемые клавиши перечислены в '''lua_help.script''' (ищите строку ''C++ class DIK_keys''). Итак, вместо
<code lua>-- if dik == DIK_keys.DIK_S then
-- self:OnButton_load_spawn()

-- else
if dik == DIK_keys.DIK_Q then
self:OnMessageQuitWin()
end</code>
мы напишем
<code lua>-- раскомментируем и заодно включим убранное спавн меню
if dik == DIK_keys.DIK_S then
self:OnButton_load_spawn()
elseif dik == DIK_keys.DIK_Q then
self:OnMessageQuitWin()
-- а вот это обработка кнопки F1. При ее нажатии будет вызываться ф-ия OnButton_ch
</code>

== Предметы ==

Теперь наша задача в том, чтобы в обработчик нажатий клавиш внести новые ф-ии. Начнем, например, со спавна предметов. Посмотрим, как спавнятся квестовые монстры и вещи и сделаем также (добаляем в конец '''ui_cheat.script'''):
<code lua>-- spawn_item - необходимый предмет
-- dist - радиус появления (случайно)
function cheat:spawn_item(spawn_item, dist)
local pos = db.actor:position()
local dir = db.actor:direction()
pos = pos:add(dir:mul(dist))
-- создаем предмет в dist метрах прямо перед нами
alife():create(spawn_item, pos, 1, db.actor:game_vertex_id())
end
</code>
{{Message_box|
id =pseudoscience|
align = left|
backgroundcolor = #f9f9f9|
image =Lamp.gif|
heading = Можно спавнить предметы прямо в инвентарь -- Neo][|
message = Функция будет выглядеть следующим образом(соответственно надо учитывать отсутствие параметра dist, при вызове функции и не применять при спавне техники и монстров):
<pre>function cheat:spawn_item(spawn_item)
alife():create (spawn_item, db.actor:position(), db.actor:level_vertex_id(),
db.actor:game_vertex_id(), db.actor:id())
end</pre>}}
 

<pre>Добавление от HikeR.
Таким образом, кстати, передаются квестовые предметы. Используйте в своих скриптах и новых квестах.
Функцию можно добавить к существующей, тогда при ее вызове будет проверятся количество аргументов
и вызываться нужная. В С++ это называется "перегрузка" (если не ошибаюсь ;)
</pre>

Теперь необходимо вызвать эту функцию. Привяжем кнопки '''1''' и '''2''' на цифровой клавиатуре к появлению Грозы и патронов к ней. В функцию '''cheat:OnKeyboard''' после строки:
<code lua>if dik == DIK_keys.DIK_ESCAPE then</code>
добавим следующее:
<code lua>
elseif dik == DIK_keys.DIK_NUMPAD1 then self:cheat1()
elseif dik == DIK_keys.DIK_NUMPAD2 then self:cheat2()
</code>
и создадим эти функции (опять добавляем в конец файла):
<code lua>
function cheat:cheat1()
-- колдуем грозу на расстоянии 3 метров.
self:spawn_item("wpn_groza", 3)
end
function cheat:cheat2()
self:spawn_item("ammo_9x39_sp5", 3)
end
</code>

== Транспорт ==

Спавнить транспорт мы будем аналогично, но тут есть небольшая проблема. В конфигах для траспорта отсутствуют необходимые параметры, все-таки машины в игре были вырезаны. Но нам это не помеха, поэтому начнем с Нивы.

Создадим новый файл с именем cars_spawn.ltx
<code>
[ven_niva]
class = SCRPTCAR
cform = skeleton
visual = physics\vehicles\niva\veh_niva_u_01.ogf
</code>
Сохраним его к остальным конфигам транспорта, то есть в '''config\models\vehicles'''. Это минимальный набор для правильного появление нового объекта в игре. Но игра еще не знает, что мы добавили новый конфиг, поэтому немного подредактируем '''system.ltx'''. В начале файла есть множество команд '''#include ...''', они подключают конфиги. Найдем последний include и добавим наш конфиг:
<code>#include "models\vehicles\cars_spawn.ltx"</code>
Далее по накатанной дорожке. Допишем функцию вызова спавна:
<code lua>
function cheat:cheat3()
self:spawn_item("ven_niva", 5, 10)
end
</code>
и назначим ей кнопку '''3''' на цифровой клавиатуре:
<code lua>elseif dik == DIK_keys.DIK_NUMPAD3 then self:cheat3()</code>
Все. Можно запускаться и смотреть. Жмем Esc, потом F1 (главное меню пропадает, остается просто картинка), потом 1, 2 или 3 на цифровой клавиатуре. в выбранном радиусе будут появляться автоматы, патроны и Нивы.

Однако, оружие и боеприпасы при появлении падают на землю, а вот траспорт остается висеть в воздухе. Я пытаюсь понять, что можно сделать, но пока просто киньте в нее болт. Машина упадет и покатится, если стоит на неровной поверхности.

== Монстры ==

Аналогично добавляем монстров и прочую живность. Функция:
<code lua>function cheat:cheat4()
-- создаем монстра подальше от нас
self:spawn_item("dog_weak", 20)
end</code>
Обработка клавиши '''4'''
<code lua>elseif dik == DIK_keys.DIK_NUMPAD4 then self:cheat4()</code>

== Сон по желанию ==

Если у Вас установлен Dream mod, то можно и его повесить на кнопку.
<code lua>function cheat:cheat5()
sleep_manager.sleep_three_hours()
end</code>
Предполагается, что имя скрипта '''sleep_manager.script''', а в нем есть функция '''sleep_three_hours()''', то есть спать 3 часа. Сам я не пользовал этот мод, поэтому могу ошибаться.

Прим. от Empro: лично у меня не заработало и повисло. Вообще, вызывать сон из главного меню, да ещё и в режиме паузы - неблагодарное дело.
Прим. от HikeR: сначала снять с паузы, а потом спать. Тогда все работает.

== Внимание!!! ==

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

Желательно выбирать ровную поверхность, либо поверхность с наклоном '''от''' игрока. Если спавнить '''в гору''' - то предмет вообще не появится, вернее он появится, но провалится под уровень.

== Ссылки на ресурсы ==

* [[Скрипт ui script|Полный текст скрипта ui_cheats.script]]
* [http://shooter-szene.4players.de/PNphpBB2-viewtopic-t-6216.phtml Stalker-MOD incl. Fahrzeuge] - официальный топик(обсуждение и загрузка)(нем.)
* [http://www.gsc-game.com/index.php?t=community&s=forums&s_game_type=xr&thm_page=2&thm_id=8281&sec_id=16 Обсуждение Jeppa's Vehicle mod на gsc-game.com](англ.)
* [http://www.gsc-game.com/index.php?t=community&s=forums&s_game_type=xr&thm_page=2&thm_id=8271&sec_id=17&page=3 Загрузка Jeppa's Vehicle mod на gsc-game.com](англ.)

== Благодарности ==

*'''Jeppa''' - за толчок в сторону изучения этой стороны скриптинга
*'''[http://forums.ag.ru/?action=viewprofile&username=Red75 Red75]''' - за расчет координат спавна (появление прямо перед нами)

== Что дальше? ==

А дальше плавно переходим к облагораживанию, иначе говоря - к [[Назначение скриптам горячих кнопок. Часть 2. Интерфейс|интерфейсу]].

--[[Участник:HikeR|HikeR]] 23:37, 20 мая 2007 (MSD)
[[Категория:Скрипты]]

Назначение скриптам горячих кнопок. Часть 1. Скрипт

2009-10-14T20:40:34Z

Wasly: /* Монстры */

== Вступление ==

Поизучав [http://shooter-szene.4players.de/modules/PNphpBB2/files/jeppa_s_mod__v1.05__incl.vehicles_946.zip мод] от камрада Jeppa, решил создать небольшое руководство по созданию новых интерфейсных окон, привязки скриптов на кнопки, реакцию на нажатия клавиш, спавн предметов прямо в игре.

К сожалению в самой игре возможность прибиндить запуск скрипта или еще какое действие на новую кнопку отсутствует, поэтому приходится придумывать что-то свое. Jeppa вышел из положения создав новое диалоговое окно на основе старого интерфейса загрузки спавн файлов. Он добавил на него 10 кнопок с описаниями, при нажатии на каждую вызывался какой-либо скрипт или функция.

Нам понадобятся следующие распакованные (или имеющиеся) файлы:
config\system.ltx
scripts\ui_main_menu.script
Остальное будем делать с нуля. Я придерживаюсь политики минимального вмешательства в уже имеющиеся файлы.

== Скрипт ==

Итак, как это сделать. Начнем с самого простого. Сначала создадим наш новый скрипт, который и будет заниматься вызовом других скриптов. Назовем его '''ui_cheat.script''' и положим ко всем остальным скриптам.

{| class="collapsible collapsed"
|-
! Вот его содержание:
|-
|
<code lua>-- инициализация
class "cheat" (CUIScriptWnd)

function cheat:__init(owner) super()
self.owner = owner
self:InitControls()
self:InitCallBacks()
end

function cheat:__finalize() end

function cheat:InitControls()
-- здесь будут все контролы
end

function cheat:InitCallBacks()
-- здесь будут все каллбаки (ну, или обработчики)
end

-- сразу создадим ф-ию для выхода
function cheat:on_quit()
local console = get_console()
self:GetHolder():start_stop_menu (self.owner, true)
self:GetHolder():start_stop_menu (self,true)
self.owner:Show (true)
-- если мы вызывались из игры, то убираем главное меню
if level.present() and (db.actor ~= nil) and db.actor:alive() then
console:execute("main_menu off")
end
end</code>
|}
Теперь нужно как-то этот скрипт вызвать. Я решил пойти по проторенной дорожке и вызывать его из главного меню. Пока мы не будем создавать там новых кнопок, а повесим его запуск на горячую клавишу. Например, на F1, из игры будет удобно жать Esc и сразу F1. Но можете и другую кнопку использовать. Итак, открываем файл '''ui_main_menu.script''', идем в самый конец и ищем там такую ф-ию:
<code lua>function main_menu:OnKeyboard(dik, keyboard_action)</code>
Это обработчик нажатий клавиш. Используемые клавиши перечислены в '''lua_help.script''' (ищите строку ''C++ class DIK_keys''). Итак, вместо
<code lua>-- if dik == DIK_keys.DIK_S then
-- self:OnButton_load_spawn()

-- else
if dik == DIK_keys.DIK_Q then
self:OnMessageQuitWin()
end</code>
мы напишем
<code lua>-- раскомментируем и заодно включим убранное спавн меню
if dik == DIK_keys.DIK_S then
self:OnButton_load_spawn()
elseif dik == DIK_keys.DIK_Q then
self:OnMessageQuitWin()
-- а вот это обработка кнопки F1. При ее нажатии будет вызываться ф-ия OnButton_ch
</code>

== Предметы ==

Теперь наша задача в том, чтобы в обработчик нажатий клавиш внести новые ф-ии. Начнем, например, со спавна предметов. Посмотрим, как спавнятся квестовые монстры и вещи и сделаем также (добаляем в конец '''ui_cheat.script'''):
<code lua>-- spawn_item - необходимый предмет
-- dist - радиус появления (случайно)
function cheat:spawn_item(spawn_item, dist)
local pos = db.actor:position()
local dir = db.actor:direction()
pos = pos:add(dir:mul(dist))
-- создаем предмет в dist метрах прямо перед нами
alife():create(spawn_item, pos, 1, db.actor:game_vertex_id())
end
</code>
{{Message_box|
id =pseudoscience|
align = left|
backgroundcolor = #f9f9f9|
image =Lamp.gif|
heading = Можно спавнить предметы прямо в инвентарь -- Neo][|
message = Функция будет выглядеть следующим образом(соответственно надо учитывать отсутствие параметра dist, при вызове функции и не применять при спавне техники и монстров):
<pre>function cheat:spawn_item(spawn_item)
alife():create (spawn_item, db.actor:position(), db.actor:level_vertex_id(),
db.actor:game_vertex_id(), db.actor:id())
end</pre>}}
 

<pre>Добавление от HikeR.
Таким образом, кстати, передаются квестовые предметы. Используйте в своих скриптах и новых квестах.
Функцию можно добавить к существующей, тогда при ее вызове будет проверятся количество аргументов
и вызываться нужная. В С++ это называется "перегрузка" (если не ошибаюсь ;)
</pre>

Теперь необходимо вызвать эту функцию. Привяжем кнопки '''1''' и '''2''' на цифровой клавиатуре к появлению Грозы и патронов к ней. В функцию '''cheat:OnKeyboard''' после строки:
<code lua>if dik == DIK_keys.DIK_ESCAPE then</code>
добавим следующее:
<code lua>
elseif dik == DIK_keys.DIK_NUMPAD1 then self:cheat1()
elseif dik == DIK_keys.DIK_NUMPAD2 then self:cheat2()
</code>
и создадим эти функции (опять добавляем в конец файла):
<code lua>
function cheat:cheat1()
-- колдуем грозу на расстоянии 3 метров.
self:spawn_item("wpn_groza", 3)
end
function cheat:cheat2()
self:spawn_item("ammo_9x39_sp5", 3)
end
</code>

== Транспорт ==

Спавнить транспорт мы будем аналогично, но тут есть небольшая проблема. В конфигах для траспорта отсутствуют необходимые параметры, все-таки машины в игре были вырезаны. Но нам это не помеха, поэтому начнем с Нивы.

Создадим новый файл с именем cars_spawn.ltx
<code>
[ven_niva]
class = SCRPTCAR
cform = skeleton
visual = physics\vehicles\niva\veh_niva_u_01.ogf
</code>
Сохраним его к остальным конфигам транспорта, то есть в '''config\models\vehicles'''. Это минимальный набор для правильного появление нового объекта в игре. Но игра еще не знает, что мы добавили новый конфиг, поэтому немного подредактируем '''system.ltx'''. В начале файла есть множество команд '''#include ...''', они подключают конфиги. Найдем последний include и добавим наш конфиг:
<code>#include "models\vehicles\cars_spawn.ltx"</code>
Далее по накатанной дорожке. Допишем функцию вызова спавна:
<code lua>
function cheat:cheat3()
self:spawn_item("ven_niva", 5, 10)
end
</code>
и назначим ей кнопку '''3''' на цифровой клавиатуре:
<code lua>elseif dik == DIK_keys.DIK_NUMPAD3 then self:cheat3()</code>
Все. Можно запускаться и смотреть. Жмем Esc, потом F1 (главное меню пропадает, остается просто картинка), потом 1, 2 или 3 на цифровой клавиатуре. в выбранном радиусе будут появляться автоматы, патроны и Нивы.

Однако, оружие и боеприпасы при появлении падают на землю, а вот траспорт остается висеть в воздухе. Я пытаюсь понять, что можно сделать, но пока просто киньте в нее болт. Машина упадет и покатится, если стоит на неровной поверхности.

== Монстры ==

Аналогично добавляем монстров и прочую живность. Функция:
<code lua>function cheat:cheat4()
-- создаем монстра подальше от нас
self:spawn_item("dog_weak", 20)
end</code>
Обработка клавиши '''4'''
<code lua>elseif dik == DIK_keys.DIK_NUMPAD4 then self:cheat4()</code>

== Сон по желанию ==

Если у Вас установлен Dream mod, то можно и его повесить на кнопку.
function cheat:cheat5()
sleep_manager.sleep_three_hours()
end
Предполагается, что имя скрипта '''sleep_manager.script''', а в нем есть функция '''sleep_three_hours()''', то есть спать 3 часа. Сам я не пользовал этот мод, поэтому могу ошибаться.

Прим. от Empro: лично у меня не заработало и повисло. Вообще, вызывать сон из главного меню, да ещё и в режиме паузы - неблагодарное дело.
Прим. от HikeR: сначала снять с паузы, а потом спать. Тогда все работает.

== Внимание!!! ==

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

Желательно выбирать ровную поверхность, либо поверхность с наклоном '''от''' игрока. Если спавнить '''в гору''' - то предмет вообще не появится, вернее он появится, но провалится под уровень.

== Ссылки на ресурсы ==

* [[Скрипт ui script|Полный текст скрипта ui_cheats.script]]
* [http://shooter-szene.4players.de/PNphpBB2-viewtopic-t-6216.phtml Stalker-MOD incl. Fahrzeuge] - официальный топик(обсуждение и загрузка)(нем.)
* [http://www.gsc-game.com/index.php?t=community&s=forums&s_game_type=xr&thm_page=2&thm_id=8281&sec_id=16 Обсуждение Jeppa's Vehicle mod на gsc-game.com](англ.)
* [http://www.gsc-game.com/index.php?t=community&s=forums&s_game_type=xr&thm_page=2&thm_id=8271&sec_id=17&page=3 Загрузка Jeppa's Vehicle mod на gsc-game.com](англ.)

== Благодарности ==

*'''Jeppa''' - за толчок в сторону изучения этой стороны скриптинга
*'''[http://forums.ag.ru/?action=viewprofile&username=Red75 Red75]''' - за расчет координат спавна (появление прямо перед нами)

== Что дальше? ==

А дальше плавно переходим к облагораживанию, иначе говоря - к [[Назначение скриптам горячих кнопок. Часть 2. Интерфейс|интерфейсу]].

--[[Участник:HikeR|HikeR]] 23:37, 20 мая 2007 (MSD)
[[Категория:Скрипты]]

Назначение скриптам горячих кнопок. Часть 1. Скрипт

2009-10-14T20:40:03Z

Wasly: /* Транспорт */

== Вступление ==

Поизучав [http://shooter-szene.4players.de/modules/PNphpBB2/files/jeppa_s_mod__v1.05__incl.vehicles_946.zip мод] от камрада Jeppa, решил создать небольшое руководство по созданию новых интерфейсных окон, привязки скриптов на кнопки, реакцию на нажатия клавиш, спавн предметов прямо в игре.

К сожалению в самой игре возможность прибиндить запуск скрипта или еще какое действие на новую кнопку отсутствует, поэтому приходится придумывать что-то свое. Jeppa вышел из положения создав новое диалоговое окно на основе старого интерфейса загрузки спавн файлов. Он добавил на него 10 кнопок с описаниями, при нажатии на каждую вызывался какой-либо скрипт или функция.

Нам понадобятся следующие распакованные (или имеющиеся) файлы:
config\system.ltx
scripts\ui_main_menu.script
Остальное будем делать с нуля. Я придерживаюсь политики минимального вмешательства в уже имеющиеся файлы.

== Скрипт ==

Итак, как это сделать. Начнем с самого простого. Сначала создадим наш новый скрипт, который и будет заниматься вызовом других скриптов. Назовем его '''ui_cheat.script''' и положим ко всем остальным скриптам.

{| class="collapsible collapsed"
|-
! Вот его содержание:
|-
|
<code lua>-- инициализация
class "cheat" (CUIScriptWnd)

function cheat:__init(owner) super()
self.owner = owner
self:InitControls()
self:InitCallBacks()
end

function cheat:__finalize() end

function cheat:InitControls()
-- здесь будут все контролы
end

function cheat:InitCallBacks()
-- здесь будут все каллбаки (ну, или обработчики)
end

-- сразу создадим ф-ию для выхода
function cheat:on_quit()
local console = get_console()
self:GetHolder():start_stop_menu (self.owner, true)
self:GetHolder():start_stop_menu (self,true)
self.owner:Show (true)
-- если мы вызывались из игры, то убираем главное меню
if level.present() and (db.actor ~= nil) and db.actor:alive() then
console:execute("main_menu off")
end
end</code>
|}
Теперь нужно как-то этот скрипт вызвать. Я решил пойти по проторенной дорожке и вызывать его из главного меню. Пока мы не будем создавать там новых кнопок, а повесим его запуск на горячую клавишу. Например, на F1, из игры будет удобно жать Esc и сразу F1. Но можете и другую кнопку использовать. Итак, открываем файл '''ui_main_menu.script''', идем в самый конец и ищем там такую ф-ию:
<code lua>function main_menu:OnKeyboard(dik, keyboard_action)</code>
Это обработчик нажатий клавиш. Используемые клавиши перечислены в '''lua_help.script''' (ищите строку ''C++ class DIK_keys''). Итак, вместо
<code lua>-- if dik == DIK_keys.DIK_S then
-- self:OnButton_load_spawn()

-- else
if dik == DIK_keys.DIK_Q then
self:OnMessageQuitWin()
end</code>
мы напишем
<code lua>-- раскомментируем и заодно включим убранное спавн меню
if dik == DIK_keys.DIK_S then
self:OnButton_load_spawn()
elseif dik == DIK_keys.DIK_Q then
self:OnMessageQuitWin()
-- а вот это обработка кнопки F1. При ее нажатии будет вызываться ф-ия OnButton_ch
</code>

== Предметы ==

Теперь наша задача в том, чтобы в обработчик нажатий клавиш внести новые ф-ии. Начнем, например, со спавна предметов. Посмотрим, как спавнятся квестовые монстры и вещи и сделаем также (добаляем в конец '''ui_cheat.script'''):
<code lua>-- spawn_item - необходимый предмет
-- dist - радиус появления (случайно)
function cheat:spawn_item(spawn_item, dist)
local pos = db.actor:position()
local dir = db.actor:direction()
pos = pos:add(dir:mul(dist))
-- создаем предмет в dist метрах прямо перед нами
alife():create(spawn_item, pos, 1, db.actor:game_vertex_id())
end
</code>
{{Message_box|
id =pseudoscience|
align = left|
backgroundcolor = #f9f9f9|
image =Lamp.gif|
heading = Можно спавнить предметы прямо в инвентарь -- Neo][|
message = Функция будет выглядеть следующим образом(соответственно надо учитывать отсутствие параметра dist, при вызове функции и не применять при спавне техники и монстров):
<pre>function cheat:spawn_item(spawn_item)
alife():create (spawn_item, db.actor:position(), db.actor:level_vertex_id(),
db.actor:game_vertex_id(), db.actor:id())
end</pre>}}
 

<pre>Добавление от HikeR.
Таким образом, кстати, передаются квестовые предметы. Используйте в своих скриптах и новых квестах.
Функцию можно добавить к существующей, тогда при ее вызове будет проверятся количество аргументов
и вызываться нужная. В С++ это называется "перегрузка" (если не ошибаюсь ;)
</pre>

Теперь необходимо вызвать эту функцию. Привяжем кнопки '''1''' и '''2''' на цифровой клавиатуре к появлению Грозы и патронов к ней. В функцию '''cheat:OnKeyboard''' после строки:
<code lua>if dik == DIK_keys.DIK_ESCAPE then</code>
добавим следующее:
<code lua>
elseif dik == DIK_keys.DIK_NUMPAD1 then self:cheat1()
elseif dik == DIK_keys.DIK_NUMPAD2 then self:cheat2()
</code>
и создадим эти функции (опять добавляем в конец файла):
<code lua>
function cheat:cheat1()
-- колдуем грозу на расстоянии 3 метров.
self:spawn_item("wpn_groza", 3)
end
function cheat:cheat2()
self:spawn_item("ammo_9x39_sp5", 3)
end
</code>

== Транспорт ==

Спавнить транспорт мы будем аналогично, но тут есть небольшая проблема. В конфигах для траспорта отсутствуют необходимые параметры, все-таки машины в игре были вырезаны. Но нам это не помеха, поэтому начнем с Нивы.

Создадим новый файл с именем cars_spawn.ltx
<code>
[ven_niva]
class = SCRPTCAR
cform = skeleton
visual = physics\vehicles\niva\veh_niva_u_01.ogf
</code>
Сохраним его к остальным конфигам транспорта, то есть в '''config\models\vehicles'''. Это минимальный набор для правильного появление нового объекта в игре. Но игра еще не знает, что мы добавили новый конфиг, поэтому немного подредактируем '''system.ltx'''. В начале файла есть множество команд '''#include ...''', они подключают конфиги. Найдем последний include и добавим наш конфиг:
<code>#include "models\vehicles\cars_spawn.ltx"</code>
Далее по накатанной дорожке. Допишем функцию вызова спавна:
<code lua>
function cheat:cheat3()
self:spawn_item("ven_niva", 5, 10)
end
</code>
и назначим ей кнопку '''3''' на цифровой клавиатуре:
<code lua>elseif dik == DIK_keys.DIK_NUMPAD3 then self:cheat3()</code>
Все. Можно запускаться и смотреть. Жмем Esc, потом F1 (главное меню пропадает, остается просто картинка), потом 1, 2 или 3 на цифровой клавиатуре. в выбранном радиусе будут появляться автоматы, патроны и Нивы.

Однако, оружие и боеприпасы при появлении падают на землю, а вот траспорт остается висеть в воздухе. Я пытаюсь понять, что можно сделать, но пока просто киньте в нее болт. Машина упадет и покатится, если стоит на неровной поверхности.

== Монстры ==

Аналогично добавляем монстров и прочую живность. Функция:
<code lua>function cheat:cheat4()
-- создаем монстра подальше от нас
self:spawn_item("dog_weak", 20)
end</code>
Обработка клавиши '''4'''
<code lua>elseif dik == DIK_keys.DIK_NUMPAD4 then self:cheat4()</code>

== Сон по желанию ==

Если у Вас установлен Dream mod, то можно и его повесить на кнопку.
function cheat:cheat5()
sleep_manager.sleep_three_hours()
end
Предполагается, что имя скрипта '''sleep_manager.script''', а в нем есть функция '''sleep_three_hours()''', то есть спать 3 часа. Сам я не пользовал этот мод, поэтому могу ошибаться.

Прим. от Empro: лично у меня не заработало и повисло. Вообще, вызывать сон из главного меню, да ещё и в режиме паузы - неблагодарное дело.
Прим. от HikeR: сначала снять с паузы, а потом спать. Тогда все работает.

== Внимание!!! ==

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

Желательно выбирать ровную поверхность, либо поверхность с наклоном '''от''' игрока. Если спавнить '''в гору''' - то предмет вообще не появится, вернее он появится, но провалится под уровень.

== Ссылки на ресурсы ==

* [[Скрипт ui script|Полный текст скрипта ui_cheats.script]]
* [http://shooter-szene.4players.de/PNphpBB2-viewtopic-t-6216.phtml Stalker-MOD incl. Fahrzeuge] - официальный топик(обсуждение и загрузка)(нем.)
* [http://www.gsc-game.com/index.php?t=community&s=forums&s_game_type=xr&thm_page=2&thm_id=8281&sec_id=16 Обсуждение Jeppa's Vehicle mod на gsc-game.com](англ.)
* [http://www.gsc-game.com/index.php?t=community&s=forums&s_game_type=xr&thm_page=2&thm_id=8271&sec_id=17&page=3 Загрузка Jeppa's Vehicle mod на gsc-game.com](англ.)

== Благодарности ==

*'''Jeppa''' - за толчок в сторону изучения этой стороны скриптинга
*'''[http://forums.ag.ru/?action=viewprofile&username=Red75 Red75]''' - за расчет координат спавна (появление прямо перед нами)

== Что дальше? ==

А дальше плавно переходим к облагораживанию, иначе говоря - к [[Назначение скриптам горячих кнопок. Часть 2. Интерфейс|интерфейсу]].

--[[Участник:HikeR|HikeR]] 23:37, 20 мая 2007 (MSD)
[[Категория:Скрипты]]

Назначение скриптам горячих кнопок. Часть 1. Скрипт

2009-10-14T20:39:24Z

Wasly: /* Транспорт */

== Вступление ==

Поизучав [http://shooter-szene.4players.de/modules/PNphpBB2/files/jeppa_s_mod__v1.05__incl.vehicles_946.zip мод] от камрада Jeppa, решил создать небольшое руководство по созданию новых интерфейсных окон, привязки скриптов на кнопки, реакцию на нажатия клавиш, спавн предметов прямо в игре.

К сожалению в самой игре возможность прибиндить запуск скрипта или еще какое действие на новую кнопку отсутствует, поэтому приходится придумывать что-то свое. Jeppa вышел из положения создав новое диалоговое окно на основе старого интерфейса загрузки спавн файлов. Он добавил на него 10 кнопок с описаниями, при нажатии на каждую вызывался какой-либо скрипт или функция.

Нам понадобятся следующие распакованные (или имеющиеся) файлы:
config\system.ltx
scripts\ui_main_menu.script
Остальное будем делать с нуля. Я придерживаюсь политики минимального вмешательства в уже имеющиеся файлы.

== Скрипт ==

Итак, как это сделать. Начнем с самого простого. Сначала создадим наш новый скрипт, который и будет заниматься вызовом других скриптов. Назовем его '''ui_cheat.script''' и положим ко всем остальным скриптам.

{| class="collapsible collapsed"
|-
! Вот его содержание:
|-
|
<code lua>-- инициализация
class "cheat" (CUIScriptWnd)

function cheat:__init(owner) super()
self.owner = owner
self:InitControls()
self:InitCallBacks()
end

function cheat:__finalize() end

function cheat:InitControls()
-- здесь будут все контролы
end

function cheat:InitCallBacks()
-- здесь будут все каллбаки (ну, или обработчики)
end

-- сразу создадим ф-ию для выхода
function cheat:on_quit()
local console = get_console()
self:GetHolder():start_stop_menu (self.owner, true)
self:GetHolder():start_stop_menu (self,true)
self.owner:Show (true)
-- если мы вызывались из игры, то убираем главное меню
if level.present() and (db.actor ~= nil) and db.actor:alive() then
console:execute("main_menu off")
end
end</code>
|}
Теперь нужно как-то этот скрипт вызвать. Я решил пойти по проторенной дорожке и вызывать его из главного меню. Пока мы не будем создавать там новых кнопок, а повесим его запуск на горячую клавишу. Например, на F1, из игры будет удобно жать Esc и сразу F1. Но можете и другую кнопку использовать. Итак, открываем файл '''ui_main_menu.script''', идем в самый конец и ищем там такую ф-ию:
<code lua>function main_menu:OnKeyboard(dik, keyboard_action)</code>
Это обработчик нажатий клавиш. Используемые клавиши перечислены в '''lua_help.script''' (ищите строку ''C++ class DIK_keys''). Итак, вместо
<code lua>-- if dik == DIK_keys.DIK_S then
-- self:OnButton_load_spawn()

-- else
if dik == DIK_keys.DIK_Q then
self:OnMessageQuitWin()
end</code>
мы напишем
<code lua>-- раскомментируем и заодно включим убранное спавн меню
if dik == DIK_keys.DIK_S then
self:OnButton_load_spawn()
elseif dik == DIK_keys.DIK_Q then
self:OnMessageQuitWin()
-- а вот это обработка кнопки F1. При ее нажатии будет вызываться ф-ия OnButton_ch
</code>

== Предметы ==

Теперь наша задача в том, чтобы в обработчик нажатий клавиш внести новые ф-ии. Начнем, например, со спавна предметов. Посмотрим, как спавнятся квестовые монстры и вещи и сделаем также (добаляем в конец '''ui_cheat.script'''):
<code lua>-- spawn_item - необходимый предмет
-- dist - радиус появления (случайно)
function cheat:spawn_item(spawn_item, dist)
local pos = db.actor:position()
local dir = db.actor:direction()
pos = pos:add(dir:mul(dist))
-- создаем предмет в dist метрах прямо перед нами
alife():create(spawn_item, pos, 1, db.actor:game_vertex_id())
end
</code>
{{Message_box|
id =pseudoscience|
align = left|
backgroundcolor = #f9f9f9|
image =Lamp.gif|
heading = Можно спавнить предметы прямо в инвентарь -- Neo][|
message = Функция будет выглядеть следующим образом(соответственно надо учитывать отсутствие параметра dist, при вызове функции и не применять при спавне техники и монстров):
<pre>function cheat:spawn_item(spawn_item)
alife():create (spawn_item, db.actor:position(), db.actor:level_vertex_id(),
db.actor:game_vertex_id(), db.actor:id())
end</pre>}}
 

<pre>Добавление от HikeR.
Таким образом, кстати, передаются квестовые предметы. Используйте в своих скриптах и новых квестах.
Функцию можно добавить к существующей, тогда при ее вызове будет проверятся количество аргументов
и вызываться нужная. В С++ это называется "перегрузка" (если не ошибаюсь ;)
</pre>

Теперь необходимо вызвать эту функцию. Привяжем кнопки '''1''' и '''2''' на цифровой клавиатуре к появлению Грозы и патронов к ней. В функцию '''cheat:OnKeyboard''' после строки:
<code lua>if dik == DIK_keys.DIK_ESCAPE then</code>
добавим следующее:
<code lua>
elseif dik == DIK_keys.DIK_NUMPAD1 then self:cheat1()
elseif dik == DIK_keys.DIK_NUMPAD2 then self:cheat2()
</code>
и создадим эти функции (опять добавляем в конец файла):
<code lua>
function cheat:cheat1()
-- колдуем грозу на расстоянии 3 метров.
self:spawn_item("wpn_groza", 3)
end
function cheat:cheat2()
self:spawn_item("ammo_9x39_sp5", 3)
end
</code>

== Транспорт ==

Спавнить транспорт мы будем аналогично, но тут есть небольшая проблема. В конфигах для траспорта отсутствуют необходимые параметры, все-таки машины в игре были вырезаны. Но нам это не помеха, поэтому начнем с Нивы.

Создадим новый файл с именем cars_spawn.ltx
<code>
[ven_niva]
class = SCRPTCAR
cform = skeleton
visual = physics\vehicles\niva\veh_niva_u_01.ogf
</code>
Сохраним его к остальным конфигам транспорта, то есть в '''config\models\vehicles'''. Это минимальный набор для правильного появление нового объекта в игре. Но игра еще не знает, что мы добавили новый конфиг, поэтому немного подредактируем '''system.ltx'''. В начале файла есть множество команд '''#include ...''', они подключают конфиги. Найдем последний include и добавим наш конфиг:
<code>#include "models\vehicles\cars_spawn.ltx"</code>
Далее по накатанной дорожке. Допишем функцию вызова спавна:
<code lua>
function cheat:cheat3()
self:spawn_item("ven_niva", 5, 10)
end
</code>
и назначим ей кнопку '''3''' на цифровой клавиатуре:
<code lua>elseif dik == DIK_keys.DIK_NUMPAD3 then self:cheat3()</code>
Все. Можно запускаться и смотреть. Жмем Esc, потом F1 (главное меню пропадает, остается просто картинка), потом 1, 2 или 3 на цифровой клавиатуре. в выбранном радиусе будут появляться автоматы, патроны и Нивы.

Однако, оружие и боеприпасы при появлении падают на землю, а вот траспорт остается висеть в воздухе. Я пытаюсь понять, что можно сделать, но пока просто киньте в нее болт. Машина упадет и покатится, если стоит на неровной поверхности.

== Монстры ==

Аналогично добавляем монстров и прочую живность. Функция:
<code lua>function cheat:cheat4()
-- создаем монстра подальше от нас
self:spawn_item("dog_weak", 20)
end</code>
Обработка клавиши '''4'''
<code lua>elseif dik == DIK_keys.DIK_NUMPAD4 then self:cheat4()</code>

== Сон по желанию ==

Если у Вас установлен Dream mod, то можно и его повесить на кнопку.
function cheat:cheat5()
sleep_manager.sleep_three_hours()
end
Предполагается, что имя скрипта '''sleep_manager.script''', а в нем есть функция '''sleep_three_hours()''', то есть спать 3 часа. Сам я не пользовал этот мод, поэтому могу ошибаться.

Прим. от Empro: лично у меня не заработало и повисло. Вообще, вызывать сон из главного меню, да ещё и в режиме паузы - неблагодарное дело.
Прим. от HikeR: сначала снять с паузы, а потом спать. Тогда все работает.

== Внимание!!! ==

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

Желательно выбирать ровную поверхность, либо поверхность с наклоном '''от''' игрока. Если спавнить '''в гору''' - то предмет вообще не появится, вернее он появится, но провалится под уровень.

== Ссылки на ресурсы ==

* [[Скрипт ui script|Полный текст скрипта ui_cheats.script]]
* [http://shooter-szene.4players.de/PNphpBB2-viewtopic-t-6216.phtml Stalker-MOD incl. Fahrzeuge] - официальный топик(обсуждение и загрузка)(нем.)
* [http://www.gsc-game.com/index.php?t=community&s=forums&s_game_type=xr&thm_page=2&thm_id=8281&sec_id=16 Обсуждение Jeppa's Vehicle mod на gsc-game.com](англ.)
* [http://www.gsc-game.com/index.php?t=community&s=forums&s_game_type=xr&thm_page=2&thm_id=8271&sec_id=17&page=3 Загрузка Jeppa's Vehicle mod на gsc-game.com](англ.)

== Благодарности ==

*'''Jeppa''' - за толчок в сторону изучения этой стороны скриптинга
*'''[http://forums.ag.ru/?action=viewprofile&username=Red75 Red75]''' - за расчет координат спавна (появление прямо перед нами)

== Что дальше? ==

А дальше плавно переходим к облагораживанию, иначе говоря - к [[Назначение скриптам горячих кнопок. Часть 2. Интерфейс|интерфейсу]].

--[[Участник:HikeR|HikeR]] 23:37, 20 мая 2007 (MSD)
[[Категория:Скрипты]]

Назначение скриптам горячих кнопок. Часть 1. Скрипт

2009-10-14T20:34:53Z

Wasly: /* Монстры */

== Вступление ==

Поизучав [http://shooter-szene.4players.de/modules/PNphpBB2/files/jeppa_s_mod__v1.05__incl.vehicles_946.zip мод] от камрада Jeppa, решил создать небольшое руководство по созданию новых интерфейсных окон, привязки скриптов на кнопки, реакцию на нажатия клавиш, спавн предметов прямо в игре.

К сожалению в самой игре возможность прибиндить запуск скрипта или еще какое действие на новую кнопку отсутствует, поэтому приходится придумывать что-то свое. Jeppa вышел из положения создав новое диалоговое окно на основе старого интерфейса загрузки спавн файлов. Он добавил на него 10 кнопок с описаниями, при нажатии на каждую вызывался какой-либо скрипт или функция.

Нам понадобятся следующие распакованные (или имеющиеся) файлы:
config\system.ltx
scripts\ui_main_menu.script
Остальное будем делать с нуля. Я придерживаюсь политики минимального вмешательства в уже имеющиеся файлы.

== Скрипт ==

Итак, как это сделать. Начнем с самого простого. Сначала создадим наш новый скрипт, который и будет заниматься вызовом других скриптов. Назовем его '''ui_cheat.script''' и положим ко всем остальным скриптам.

{| class="collapsible collapsed"
|-
! Вот его содержание:
|-
|
<code lua>-- инициализация
class "cheat" (CUIScriptWnd)

function cheat:__init(owner) super()
self.owner = owner
self:InitControls()
self:InitCallBacks()
end

function cheat:__finalize() end

function cheat:InitControls()
-- здесь будут все контролы
end

function cheat:InitCallBacks()
-- здесь будут все каллбаки (ну, или обработчики)
end

-- сразу создадим ф-ию для выхода
function cheat:on_quit()
local console = get_console()
self:GetHolder():start_stop_menu (self.owner, true)
self:GetHolder():start_stop_menu (self,true)
self.owner:Show (true)
-- если мы вызывались из игры, то убираем главное меню
if level.present() and (db.actor ~= nil) and db.actor:alive() then
console:execute("main_menu off")
end
end</code>
|}
Теперь нужно как-то этот скрипт вызвать. Я решил пойти по проторенной дорожке и вызывать его из главного меню. Пока мы не будем создавать там новых кнопок, а повесим его запуск на горячую клавишу. Например, на F1, из игры будет удобно жать Esc и сразу F1. Но можете и другую кнопку использовать. Итак, открываем файл '''ui_main_menu.script''', идем в самый конец и ищем там такую ф-ию:
<code lua>function main_menu:OnKeyboard(dik, keyboard_action)</code>
Это обработчик нажатий клавиш. Используемые клавиши перечислены в '''lua_help.script''' (ищите строку ''C++ class DIK_keys''). Итак, вместо
<code lua>-- if dik == DIK_keys.DIK_S then
-- self:OnButton_load_spawn()

-- else
if dik == DIK_keys.DIK_Q then
self:OnMessageQuitWin()
end</code>
мы напишем
<code lua>-- раскомментируем и заодно включим убранное спавн меню
if dik == DIK_keys.DIK_S then
self:OnButton_load_spawn()
elseif dik == DIK_keys.DIK_Q then
self:OnMessageQuitWin()
-- а вот это обработка кнопки F1. При ее нажатии будет вызываться ф-ия OnButton_ch
</code>

== Предметы ==

Теперь наша задача в том, чтобы в обработчик нажатий клавиш внести новые ф-ии. Начнем, например, со спавна предметов. Посмотрим, как спавнятся квестовые монстры и вещи и сделаем также (добаляем в конец '''ui_cheat.script'''):
<code lua>-- spawn_item - необходимый предмет
-- dist - радиус появления (случайно)
function cheat:spawn_item(spawn_item, dist)
local pos = db.actor:position()
local dir = db.actor:direction()
pos = pos:add(dir:mul(dist))
-- создаем предмет в dist метрах прямо перед нами
alife():create(spawn_item, pos, 1, db.actor:game_vertex_id())
end
</code>
{{Message_box|
id =pseudoscience|
align = left|
backgroundcolor = #f9f9f9|
image =Lamp.gif|
heading = Можно спавнить предметы прямо в инвентарь -- Neo][|
message = Функция будет выглядеть следующим образом(соответственно надо учитывать отсутствие параметра dist, при вызове функции и не применять при спавне техники и монстров):
<pre>function cheat:spawn_item(spawn_item)
alife():create (spawn_item, db.actor:position(), db.actor:level_vertex_id(),
db.actor:game_vertex_id(), db.actor:id())
end</pre>}}
 

<pre>Добавление от HikeR.
Таким образом, кстати, передаются квестовые предметы. Используйте в своих скриптах и новых квестах.
Функцию можно добавить к существующей, тогда при ее вызове будет проверятся количество аргументов
и вызываться нужная. В С++ это называется "перегрузка" (если не ошибаюсь ;)
</pre>

Теперь необходимо вызвать эту функцию. Привяжем кнопки '''1''' и '''2''' на цифровой клавиатуре к появлению Грозы и патронов к ней. В функцию '''cheat:OnKeyboard''' после строки:
<code lua>if dik == DIK_keys.DIK_ESCAPE then</code>
добавим следующее:
<code lua>
elseif dik == DIK_keys.DIK_NUMPAD1 then self:cheat1()
elseif dik == DIK_keys.DIK_NUMPAD2 then self:cheat2()
</code>
и создадим эти функции (опять добавляем в конец файла):
<code lua>
function cheat:cheat1()
-- колдуем грозу на расстоянии 3 метров.
self:spawn_item("wpn_groza", 3)
end
function cheat:cheat2()
self:spawn_item("ammo_9x39_sp5", 3)
end
</code>

== Транспорт ==

Спавнить транспорт мы будем аналогично, но тут есть небольшая проблема. В конфигах для траспорта отсутствуют необходимые параметры, все-таки машины в игре были вырезаны. Но нам это не помеха, поэтому начнем с Нивы.

Создадим новый файл с именем cars_spawn.ltx
<code>
[ven_niva]
class = SCRPTCAR
cform = skeleton
visual = physics\vehicles\niva\veh_niva_u_01.ogf
</code>
Сохраним его к остальным конфигам транспорта, то есть в '''config\models\vehicles'''. Это минимальный набор для правильного появление нового объекта в игре. Но игра еще не знает, что мы добавили новый конфиг, поэтому немного подредактируем '''system.ltx'''. В начале файла есть множество команд '''#include ...''', они подключают конфиги. Найдем последний include и добавим наш конфиг:
<code>#include "models\vehicles\cars_spawn.ltx"</code>
Далее по накатанной дорожке. Допишем функцию вызова спавна:
<code lua>
function cheat:cheat3()
self:spawn_item("ven_niva", 5, 10)
end
</code>
и назначим ей кнопку 3 на цифровой клавиатуре:
<code lua>elseif dik == DIK_keys.DIK_NUMPAD3 then self:cheat3()</code>
Все. Можно запускаться и смотреть. Жмем Esc, потом F1 (главное меню пропадает, остается просто картинка), потом 1, 2 или 3 на цифровой клавиатуре. в выбранном радиусе будут появляться автоматы, патроны и Нивы.

Однако, оружие и боеприпасы при появлении падают на землю, а вот траспорт остается висеть в воздухе. Я пытаюсь понять, что можно сделать, но пока просто киньте в нее болт. Машина упадет и покатится, если стоит на неровной поверхности.

== Монстры ==

Аналогично добавляем монстров и прочую живность. Функция:
<code lua>function cheat:cheat4()
-- создаем монстра подальше от нас
self:spawn_item("dog_weak", 20)
end</code>
Обработка клавиши '''4'''
<code lua>elseif dik == DIK_keys.DIK_NUMPAD4 then self:cheat4()</code>

== Сон по желанию ==

Если у Вас установлен Dream mod, то можно и его повесить на кнопку.
function cheat:cheat5()
sleep_manager.sleep_three_hours()
end
Предполагается, что имя скрипта '''sleep_manager.script''', а в нем есть функция '''sleep_three_hours()''', то есть спать 3 часа. Сам я не пользовал этот мод, поэтому могу ошибаться.

Прим. от Empro: лично у меня не заработало и повисло. Вообще, вызывать сон из главного меню, да ещё и в режиме паузы - неблагодарное дело.
Прим. от HikeR: сначала снять с паузы, а потом спать. Тогда все работает.

== Внимание!!! ==

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

Желательно выбирать ровную поверхность, либо поверхность с наклоном '''от''' игрока. Если спавнить '''в гору''' - то предмет вообще не появится, вернее он появится, но провалится под уровень.

== Ссылки на ресурсы ==

* [[Скрипт ui script|Полный текст скрипта ui_cheats.script]]
* [http://shooter-szene.4players.de/PNphpBB2-viewtopic-t-6216.phtml Stalker-MOD incl. Fahrzeuge] - официальный топик(обсуждение и загрузка)(нем.)
* [http://www.gsc-game.com/index.php?t=community&s=forums&s_game_type=xr&thm_page=2&thm_id=8281&sec_id=16 Обсуждение Jeppa's Vehicle mod на gsc-game.com](англ.)
* [http://www.gsc-game.com/index.php?t=community&s=forums&s_game_type=xr&thm_page=2&thm_id=8271&sec_id=17&page=3 Загрузка Jeppa's Vehicle mod на gsc-game.com](англ.)

== Благодарности ==

*'''Jeppa''' - за толчок в сторону изучения этой стороны скриптинга
*'''[http://forums.ag.ru/?action=viewprofile&username=Red75 Red75]''' - за расчет координат спавна (появление прямо перед нами)

== Что дальше? ==

А дальше плавно переходим к облагораживанию, иначе говоря - к [[Назначение скриптам горячих кнопок. Часть 2. Интерфейс|интерфейсу]].

--[[Участник:HikeR|HikeR]] 23:37, 20 мая 2007 (MSD)
[[Категория:Скрипты]]

Назначение скриптам горячих кнопок. Часть 1. Скрипт

2009-10-14T20:32:23Z

Wasly: /* Транспорт */

== Вступление ==

Поизучав [http://shooter-szene.4players.de/modules/PNphpBB2/files/jeppa_s_mod__v1.05__incl.vehicles_946.zip мод] от камрада Jeppa, решил создать небольшое руководство по созданию новых интерфейсных окон, привязки скриптов на кнопки, реакцию на нажатия клавиш, спавн предметов прямо в игре.

К сожалению в самой игре возможность прибиндить запуск скрипта или еще какое действие на новую кнопку отсутствует, поэтому приходится придумывать что-то свое. Jeppa вышел из положения создав новое диалоговое окно на основе старого интерфейса загрузки спавн файлов. Он добавил на него 10 кнопок с описаниями, при нажатии на каждую вызывался какой-либо скрипт или функция.

Нам понадобятся следующие распакованные (или имеющиеся) файлы:
config\system.ltx
scripts\ui_main_menu.script
Остальное будем делать с нуля. Я придерживаюсь политики минимального вмешательства в уже имеющиеся файлы.

== Скрипт ==

Итак, как это сделать. Начнем с самого простого. Сначала создадим наш новый скрипт, который и будет заниматься вызовом других скриптов. Назовем его '''ui_cheat.script''' и положим ко всем остальным скриптам.

{| class="collapsible collapsed"
|-
! Вот его содержание:
|-
|
<code lua>-- инициализация
class "cheat" (CUIScriptWnd)

function cheat:__init(owner) super()
self.owner = owner
self:InitControls()
self:InitCallBacks()
end

function cheat:__finalize() end

function cheat:InitControls()
-- здесь будут все контролы
end

function cheat:InitCallBacks()
-- здесь будут все каллбаки (ну, или обработчики)
end

-- сразу создадим ф-ию для выхода
function cheat:on_quit()
local console = get_console()
self:GetHolder():start_stop_menu (self.owner, true)
self:GetHolder():start_stop_menu (self,true)
self.owner:Show (true)
-- если мы вызывались из игры, то убираем главное меню
if level.present() and (db.actor ~= nil) and db.actor:alive() then
console:execute("main_menu off")
end
end</code>
|}
Теперь нужно как-то этот скрипт вызвать. Я решил пойти по проторенной дорожке и вызывать его из главного меню. Пока мы не будем создавать там новых кнопок, а повесим его запуск на горячую клавишу. Например, на F1, из игры будет удобно жать Esc и сразу F1. Но можете и другую кнопку использовать. Итак, открываем файл '''ui_main_menu.script''', идем в самый конец и ищем там такую ф-ию:
<code lua>function main_menu:OnKeyboard(dik, keyboard_action)</code>
Это обработчик нажатий клавиш. Используемые клавиши перечислены в '''lua_help.script''' (ищите строку ''C++ class DIK_keys''). Итак, вместо
<code lua>-- if dik == DIK_keys.DIK_S then
-- self:OnButton_load_spawn()

-- else
if dik == DIK_keys.DIK_Q then
self:OnMessageQuitWin()
end</code>
мы напишем
<code lua>-- раскомментируем и заодно включим убранное спавн меню
if dik == DIK_keys.DIK_S then
self:OnButton_load_spawn()
elseif dik == DIK_keys.DIK_Q then
self:OnMessageQuitWin()
-- а вот это обработка кнопки F1. При ее нажатии будет вызываться ф-ия OnButton_ch
</code>

== Предметы ==

Теперь наша задача в том, чтобы в обработчик нажатий клавиш внести новые ф-ии. Начнем, например, со спавна предметов. Посмотрим, как спавнятся квестовые монстры и вещи и сделаем также (добаляем в конец '''ui_cheat.script'''):
<code lua>-- spawn_item - необходимый предмет
-- dist - радиус появления (случайно)
function cheat:spawn_item(spawn_item, dist)
local pos = db.actor:position()
local dir = db.actor:direction()
pos = pos:add(dir:mul(dist))
-- создаем предмет в dist метрах прямо перед нами
alife():create(spawn_item, pos, 1, db.actor:game_vertex_id())
end
</code>
{{Message_box|
id =pseudoscience|
align = left|
backgroundcolor = #f9f9f9|
image =Lamp.gif|
heading = Можно спавнить предметы прямо в инвентарь -- Neo][|
message = Функция будет выглядеть следующим образом(соответственно надо учитывать отсутствие параметра dist, при вызове функции и не применять при спавне техники и монстров):
<pre>function cheat:spawn_item(spawn_item)
alife():create (spawn_item, db.actor:position(), db.actor:level_vertex_id(),
db.actor:game_vertex_id(), db.actor:id())
end</pre>}}
 

<pre>Добавление от HikeR.
Таким образом, кстати, передаются квестовые предметы. Используйте в своих скриптах и новых квестах.
Функцию можно добавить к существующей, тогда при ее вызове будет проверятся количество аргументов
и вызываться нужная. В С++ это называется "перегрузка" (если не ошибаюсь ;)
</pre>

Теперь необходимо вызвать эту функцию. Привяжем кнопки '''1''' и '''2''' на цифровой клавиатуре к появлению Грозы и патронов к ней. В функцию '''cheat:OnKeyboard''' после строки:
<code lua>if dik == DIK_keys.DIK_ESCAPE then</code>
добавим следующее:
<code lua>
elseif dik == DIK_keys.DIK_NUMPAD1 then self:cheat1()
elseif dik == DIK_keys.DIK_NUMPAD2 then self:cheat2()
</code>
и создадим эти функции (опять добавляем в конец файла):
<code lua>
function cheat:cheat1()
-- колдуем грозу на расстоянии 3 метров.
self:spawn_item("wpn_groza", 3)
end
function cheat:cheat2()
self:spawn_item("ammo_9x39_sp5", 3)
end
</code>

== Транспорт ==

Спавнить транспорт мы будем аналогично, но тут есть небольшая проблема. В конфигах для траспорта отсутствуют необходимые параметры, все-таки машины в игре были вырезаны. Но нам это не помеха, поэтому начнем с Нивы.

Создадим новый файл с именем cars_spawn.ltx
<code>
[ven_niva]
class = SCRPTCAR
cform = skeleton
visual = physics\vehicles\niva\veh_niva_u_01.ogf
</code>
Сохраним его к остальным конфигам транспорта, то есть в '''config\models\vehicles'''. Это минимальный набор для правильного появление нового объекта в игре. Но игра еще не знает, что мы добавили новый конфиг, поэтому немного подредактируем '''system.ltx'''. В начале файла есть множество команд '''#include ...''', они подключают конфиги. Найдем последний include и добавим наш конфиг:
<code>#include "models\vehicles\cars_spawn.ltx"</code>
Далее по накатанной дорожке. Допишем функцию вызова спавна:
<code lua>
function cheat:cheat3()
self:spawn_item("ven_niva", 5, 10)
end
</code>
и назначим ей кнопку 3 на цифровой клавиатуре:
<code lua>elseif dik == DIK_keys.DIK_NUMPAD3 then self:cheat3()</code>
Все. Можно запускаться и смотреть. Жмем Esc, потом F1 (главное меню пропадает, остается просто картинка), потом 1, 2 или 3 на цифровой клавиатуре. в выбранном радиусе будут появляться автоматы, патроны и Нивы.

Однако, оружие и боеприпасы при появлении падают на землю, а вот траспорт остается висеть в воздухе. Я пытаюсь понять, что можно сделать, но пока просто киньте в нее болт. Машина упадет и покатится, если стоит на неровной поверхности.

== Монстры ==

Аналогично добавляем монстров и прочую живность. Функция:
function cheat:cheat4()
-- создаем монстра подальше от нас
self:spawn_item("dog_weak", 20)
end
Обработка клавиши '''4'''
elseif dik == DIK_keys.DIK_NUMPAD4 then self:cheat4()

== Сон по желанию ==

Если у Вас установлен Dream mod, то можно и его повесить на кнопку.
function cheat:cheat5()
sleep_manager.sleep_three_hours()
end
Предполагается, что имя скрипта '''sleep_manager.script''', а в нем есть функция '''sleep_three_hours()''', то есть спать 3 часа. Сам я не пользовал этот мод, поэтому могу ошибаться.

Прим. от Empro: лично у меня не заработало и повисло. Вообще, вызывать сон из главного меню, да ещё и в режиме паузы - неблагодарное дело.
Прим. от HikeR: сначала снять с паузы, а потом спать. Тогда все работает.

== Внимание!!! ==

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

Желательно выбирать ровную поверхность, либо поверхность с наклоном '''от''' игрока. Если спавнить '''в гору''' - то предмет вообще не появится, вернее он появится, но провалится под уровень.

== Ссылки на ресурсы ==

* [[Скрипт ui script|Полный текст скрипта ui_cheats.script]]
* [http://shooter-szene.4players.de/PNphpBB2-viewtopic-t-6216.phtml Stalker-MOD incl. Fahrzeuge] - официальный топик(обсуждение и загрузка)(нем.)
* [http://www.gsc-game.com/index.php?t=community&s=forums&s_game_type=xr&thm_page=2&thm_id=8281&sec_id=16 Обсуждение Jeppa's Vehicle mod на gsc-game.com](англ.)
* [http://www.gsc-game.com/index.php?t=community&s=forums&s_game_type=xr&thm_page=2&thm_id=8271&sec_id=17&page=3 Загрузка Jeppa's Vehicle mod на gsc-game.com](англ.)

== Благодарности ==

*'''Jeppa''' - за толчок в сторону изучения этой стороны скриптинга
*'''[http://forums.ag.ru/?action=viewprofile&username=Red75 Red75]''' - за расчет координат спавна (появление прямо перед нами)

== Что дальше? ==

А дальше плавно переходим к облагораживанию, иначе говоря - к [[Назначение скриптам горячих кнопок. Часть 2. Интерфейс|интерфейсу]].

--[[Участник:HikeR|HikeR]] 23:37, 20 мая 2007 (MSD)
[[Категория:Скрипты]]

Назначение скриптам горячих кнопок. Часть 1. Скрипт

2009-10-14T20:25:43Z

Wasly: /* Скрипт */

== Вступление ==

Поизучав [http://shooter-szene.4players.de/modules/PNphpBB2/files/jeppa_s_mod__v1.05__incl.vehicles_946.zip мод] от камрада Jeppa, решил создать небольшое руководство по созданию новых интерфейсных окон, привязки скриптов на кнопки, реакцию на нажатия клавиш, спавн предметов прямо в игре.

К сожалению в самой игре возможность прибиндить запуск скрипта или еще какое действие на новую кнопку отсутствует, поэтому приходится придумывать что-то свое. Jeppa вышел из положения создав новое диалоговое окно на основе старого интерфейса загрузки спавн файлов. Он добавил на него 10 кнопок с описаниями, при нажатии на каждую вызывался какой-либо скрипт или функция.

Нам понадобятся следующие распакованные (или имеющиеся) файлы:
config\system.ltx
scripts\ui_main_menu.script
Остальное будем делать с нуля. Я придерживаюсь политики минимального вмешательства в уже имеющиеся файлы.

== Скрипт ==

Итак, как это сделать. Начнем с самого простого. Сначала создадим наш новый скрипт, который и будет заниматься вызовом других скриптов. Назовем его '''ui_cheat.script''' и положим ко всем остальным скриптам.

{| class="collapsible collapsed"
|-
! Вот его содержание:
|-
|
<code lua>-- инициализация
class "cheat" (CUIScriptWnd)

function cheat:__init(owner) super()
self.owner = owner
self:InitControls()
self:InitCallBacks()
end

function cheat:__finalize() end

function cheat:InitControls()
-- здесь будут все контролы
end

function cheat:InitCallBacks()
-- здесь будут все каллбаки (ну, или обработчики)
end

-- сразу создадим ф-ию для выхода
function cheat:on_quit()
local console = get_console()
self:GetHolder():start_stop_menu (self.owner, true)
self:GetHolder():start_stop_menu (self,true)
self.owner:Show (true)
-- если мы вызывались из игры, то убираем главное меню
if level.present() and (db.actor ~= nil) and db.actor:alive() then
console:execute("main_menu off")
end
end</code>
|}
Теперь нужно как-то этот скрипт вызвать. Я решил пойти по проторенной дорожке и вызывать его из главного меню. Пока мы не будем создавать там новых кнопок, а повесим его запуск на горячую клавишу. Например, на F1, из игры будет удобно жать Esc и сразу F1. Но можете и другую кнопку использовать. Итак, открываем файл '''ui_main_menu.script''', идем в самый конец и ищем там такую ф-ию:
<code lua>function main_menu:OnKeyboard(dik, keyboard_action)</code>
Это обработчик нажатий клавиш. Используемые клавиши перечислены в '''lua_help.script''' (ищите строку ''C++ class DIK_keys''). Итак, вместо
<code lua>-- if dik == DIK_keys.DIK_S then
-- self:OnButton_load_spawn()

-- else
if dik == DIK_keys.DIK_Q then
self:OnMessageQuitWin()
end</code>
мы напишем
<code lua>-- раскомментируем и заодно включим убранное спавн меню
if dik == DIK_keys.DIK_S then
self:OnButton_load_spawn()
elseif dik == DIK_keys.DIK_Q then
self:OnMessageQuitWin()
-- а вот это обработка кнопки F1. При ее нажатии будет вызываться ф-ия OnButton_ch
</code>

== Предметы ==

Теперь наша задача в том, чтобы в обработчик нажатий клавиш внести новые ф-ии. Начнем, например, со спавна предметов. Посмотрим, как спавнятся квестовые монстры и вещи и сделаем также (добаляем в конец '''ui_cheat.script'''):
<code lua>-- spawn_item - необходимый предмет
-- dist - радиус появления (случайно)
function cheat:spawn_item(spawn_item, dist)
local pos = db.actor:position()
local dir = db.actor:direction()
pos = pos:add(dir:mul(dist))
-- создаем предмет в dist метрах прямо перед нами
alife():create(spawn_item, pos, 1, db.actor:game_vertex_id())
end
</code>
{{Message_box|
id =pseudoscience|
align = left|
backgroundcolor = #f9f9f9|
image =Lamp.gif|
heading = Можно спавнить предметы прямо в инвентарь -- Neo][|
message = Функция будет выглядеть следующим образом(соответственно надо учитывать отсутствие параметра dist, при вызове функции и не применять при спавне техники и монстров):
<pre>function cheat:spawn_item(spawn_item)
alife():create (spawn_item, db.actor:position(), db.actor:level_vertex_id(),
db.actor:game_vertex_id(), db.actor:id())
end</pre>}}
 

<pre>Добавление от HikeR.
Таким образом, кстати, передаются квестовые предметы. Используйте в своих скриптах и новых квестах.
Функцию можно добавить к существующей, тогда при ее вызове будет проверятся количество аргументов
и вызываться нужная. В С++ это называется "перегрузка" (если не ошибаюсь ;)
</pre>

Теперь необходимо вызвать эту функцию. Привяжем кнопки '''1''' и '''2''' на цифровой клавиатуре к появлению Грозы и патронов к ней. В функцию '''cheat:OnKeyboard''' после строки:
<code lua>if dik == DIK_keys.DIK_ESCAPE then</code>
добавим следующее:
<code lua>
elseif dik == DIK_keys.DIK_NUMPAD1 then self:cheat1()
elseif dik == DIK_keys.DIK_NUMPAD2 then self:cheat2()
</code>
и создадим эти функции (опять добавляем в конец файла):
<code lua>
function cheat:cheat1()
-- колдуем грозу на расстоянии 3 метров.
self:spawn_item("wpn_groza", 3)
end
function cheat:cheat2()
self:spawn_item("ammo_9x39_sp5", 3)
end
</code>

== Транспорт ==

Спавнить транспорт мы будем аналогично, но тут есть небольшая проблема. В конфигах для траспорта отсутствуют необходимые параметры, все-таки машины в игре были вырезаны. Но нам это не помеха, поэтому начнем с Нивы.

Создадим новый файл с именем cars_spawn.ltx
<code>
[ven_niva]
class = SCRPTCAR
cform = skeleton
visual = physics\vehicles\niva\veh_niva_u_01.ogf
</code>
Сохраним его к остальным конфигам транспорта, то есть в '''config\models\vehicles'''. Это минимальный набор для правильного появление нового объекта в игре. Но игра еще не знает, что мы добавили новый конфиг, поэтому немного подредактируем '''system.ltx'''. В начале файла есть множество команд '''#include ...''', они подключают конфиги. найдем последний include и добавим наш конфиг:
<code>#include "models\vehicles\cars_spawn.ltx"</code>
Далее по накатанной дорожке. Допишем функцию вызова спавна:
<code lua>
function cheat:cheat3()
self:spawn_item("ven_niva", 5, 10)
end
</code>
и назначим ей кнопку 3 на цифровой клавиатуре:
<code lua>elseif dik == DIK_keys.DIK_NUMPAD3 then self:cheat3()</code>
Все. Можно запускаться и смотреть. Жмем Esc, потом F1 (главное меню пропадает, остается просто картинка), потом 1, 2 или 3 на цифровой клавиатуре. в выбранном радиусе будут появляться автоматы, патроны и Нивы.

Однако, оружие и боеприпасы при появлении падают на землю, а вот траспорт остается висеть в воздухе. Я пытаюсь понять, что можно сделать, но пока просто киньте в нее болт. Машина упадет и покатится, если стоит на неровной поверхности.

Продолжение следует...

== Монстры ==

Аналогично добавляем монстров и прочую живность. Функция:
function cheat:cheat4()
-- создаем монстра подальше от нас
self:spawn_item("dog_weak", 20)
end
Обработка клавиши '''4'''
elseif dik == DIK_keys.DIK_NUMPAD4 then self:cheat4()

== Сон по желанию ==

Если у Вас установлен Dream mod, то можно и его повесить на кнопку.
function cheat:cheat5()
sleep_manager.sleep_three_hours()
end
Предполагается, что имя скрипта '''sleep_manager.script''', а в нем есть функция '''sleep_three_hours()''', то есть спать 3 часа. Сам я не пользовал этот мод, поэтому могу ошибаться.

Прим. от Empro: лично у меня не заработало и повисло. Вообще, вызывать сон из главного меню, да ещё и в режиме паузы - неблагодарное дело.
Прим. от HikeR: сначала снять с паузы, а потом спать. Тогда все работает.

== Внимание!!! ==

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

Желательно выбирать ровную поверхность, либо поверхность с наклоном '''от''' игрока. Если спавнить '''в гору''' - то предмет вообще не появится, вернее он появится, но провалится под уровень.

== Ссылки на ресурсы ==

* [[Скрипт ui script|Полный текст скрипта ui_cheats.script]]
* [http://shooter-szene.4players.de/PNphpBB2-viewtopic-t-6216.phtml Stalker-MOD incl. Fahrzeuge] - официальный топик(обсуждение и загрузка)(нем.)
* [http://www.gsc-game.com/index.php?t=community&s=forums&s_game_type=xr&thm_page=2&thm_id=8281&sec_id=16 Обсуждение Jeppa's Vehicle mod на gsc-game.com](англ.)
* [http://www.gsc-game.com/index.php?t=community&s=forums&s_game_type=xr&thm_page=2&thm_id=8271&sec_id=17&page=3 Загрузка Jeppa's Vehicle mod на gsc-game.com](англ.)

== Благодарности ==

*'''Jeppa''' - за толчок в сторону изучения этой стороны скриптинга
*'''[http://forums.ag.ru/?action=viewprofile&username=Red75 Red75]''' - за расчет координат спавна (появление прямо перед нами)

== Что дальше? ==

А дальше плавно переходим к облагораживанию, иначе говоря - к [[Назначение скриптам горячих кнопок. Часть 2. Интерфейс|интерфейсу]].

--[[Участник:HikeR|HikeR]] 23:37, 20 мая 2007 (MSD)
[[Категория:Скрипты]]

Назначение скриптам горячих кнопок. Часть 1. Скрипт

2009-10-14T20:20:37Z

Wasly: /* Вступление */

== Вступление ==

Поизучав [http://shooter-szene.4players.de/modules/PNphpBB2/files/jeppa_s_mod__v1.05__incl.vehicles_946.zip мод] от камрада Jeppa, решил создать небольшое руководство по созданию новых интерфейсных окон, привязки скриптов на кнопки, реакцию на нажатия клавиш, спавн предметов прямо в игре.

К сожалению в самой игре возможность прибиндить запуск скрипта или еще какое действие на новую кнопку отсутствует, поэтому приходится придумывать что-то свое. Jeppa вышел из положения создав новое диалоговое окно на основе старого интерфейса загрузки спавн файлов. Он добавил на него 10 кнопок с описаниями, при нажатии на каждую вызывался какой-либо скрипт или функция.

Нам понадобятся следующие распакованные (или имеющиеся) файлы:
config\system.ltx
scripts\ui_main_menu.script
Остальное будем делать с нуля. Я придерживаюсь политики минимального вмешательства в уже имеющиеся файлы.

== Скрипт ==

Итак, как это сделать. Начнем с самого простого. Сначала создадим наш новый скрипт, который и будет заниматься вызовом других скриптов. Назовем его '''ui_cheat.script''' и положим ко всем остальным скриптам.

{| class="collapsible collapsed"
|-
! Вот его содержание:
|-
|
<code lua>-- инициализация
class "cheat" (CUIScriptWnd)

function cheat:__init(owner) super()
self.owner = owner
self:InitControls()
self:InitCallBacks()
end

function cheat:__finalize() end

function cheat:InitControls()
-- здесь будут все контролы
end

function cheat:InitCallBacks()
-- здесь будут все каллбаки (ну или обработчики)
end

-- сразу созадим ф-ию для выхода
function cheat:on_quit()
local console = get_console()
self:GetHolder():start_stop_menu (self.owner, true)
self:GetHolder():start_stop_menu (self,true)
self.owner:Show (true)
-- если мы вызывались из игры, то убираем главное меню
if level.present() and (db.actor ~= nil) and db.actor:alive() then
console:execute("main_menu off")
end
end</code>
|}
Теперь нужно как-то этот скрипт вызвать. Я решил пойти по проторенной дорожке, и вызывать его из главного меню. Пока мы не будем создавать там новых кнопок, а повесим его запуск на горячую клавишу. Например на F1, из игры будет удобно жать Esc и сразу F1. Но можете и другую кнопку использовать. Итак, открываем файл '''ui_main_menu.script''', идем в самый конец и ищем там такую ф-ию:
<code lua>function main_menu:OnKeyboard(dik, keyboard_action)</code>
Это обработчик нажатий клавиш. Ииспользуемые клавиши перечислены в '''lua_help.script''' (ищите строку ''C++ class DIK_keys''). Итак, вместо
<code lua>-- if dik == DIK_keys.DIK_S then
-- self:OnButton_load_spawn()

-- else
if dik == DIK_keys.DIK_Q then
self:OnMessageQuitWin()
end</code>
мы напишем
<code lua>-- раскоментируем и заоодно включим убранное спавн меню
if dik == DIK_keys.DIK_S then
self:OnButton_load_spawn()
elseif dik == DIK_keys.DIK_Q then
self:OnMessageQuitWin()
-- а вот это обработка кнопки F1. при ее нажатии будет вызываться ф-ия OnButton_ch
</code>

== Предметы ==

Теперь наша задача в том, чтобы в обработчик нажатий клавиш внести новые ф-ии. Начнем, например, со спавна предметов. Посмотрим, как спавнятся квестовые монстры и вещи и сделаем также (добаляем в конец '''ui_cheat.script'''):
<code lua>-- spawn_item - необходимый предмет
-- dist - радиус появления (случайно)
function cheat:spawn_item(spawn_item, dist)
local pos = db.actor:position()
local dir = db.actor:direction()
pos = pos:add(dir:mul(dist))
-- создаем предмет в dist метрах прямо перед нами
alife():create(spawn_item, pos, 1, db.actor:game_vertex_id())
end
</code>
{{Message_box|
id =pseudoscience|
align = left|
backgroundcolor = #f9f9f9|
image =Lamp.gif|
heading = Можно спавнить предметы прямо в инвентарь -- Neo][|
message = Функция будет выглядеть следующим образом(соответственно надо учитывать отсутствие параметра dist, при вызове функции и не применять при спавне техники и монстров):
<pre>function cheat:spawn_item(spawn_item)
alife():create (spawn_item, db.actor:position(), db.actor:level_vertex_id(),
db.actor:game_vertex_id(), db.actor:id())
end</pre>}}
 

<pre>Добавление от HikeR.
Таким образом, кстати, передаются квестовые предметы. Используйте в своих скриптах и новых квестах.
Функцию можно добавить к существующей, тогда при ее вызове будет проверятся количество аргументов
и вызываться нужная. В С++ это называется "перегрузка" (если не ошибаюсь ;)
</pre>

Теперь необходимо вызвать эту функцию. Привяжем кнопки '''1''' и '''2''' на цифровой клавиатуре к появлению Грозы и патронов к ней. В функцию '''cheat:OnKeyboard''' после строки:
<code lua>if dik == DIK_keys.DIK_ESCAPE then</code>
добавим следующее:
<code lua>
elseif dik == DIK_keys.DIK_NUMPAD1 then self:cheat1()
elseif dik == DIK_keys.DIK_NUMPAD2 then self:cheat2()
</code>
и создадим эти функции (опять добавляем в конец файла):
<code lua>
function cheat:cheat1()
-- колдуем грозу на расстоянии 3 метров.
self:spawn_item("wpn_groza", 3)
end
function cheat:cheat2()
self:spawn_item("ammo_9x39_sp5", 3)
end
</code>

== Транспорт ==

Спавнить транспорт мы будем аналогично, но тут есть небольшая проблема. В конфигах для траспорта отсутствуют необходимые параметры, все-таки машины в игре были вырезаны. Но нам это не помеха, поэтому начнем с Нивы.

Создадим новый файл с именем cars_spawn.ltx
<code>
[ven_niva]
class = SCRPTCAR
cform = skeleton
visual = physics\vehicles\niva\veh_niva_u_01.ogf
</code>
Сохраним его к остальным конфигам транспорта, то есть в '''config\models\vehicles'''. Это минимальный набор для правильного появление нового объекта в игре. Но игра еще не знает, что мы добавили новый конфиг, поэтому немного подредактируем '''system.ltx'''. В начале файла есть множество команд '''#include ...''', они подключают конфиги. найдем последний include и добавим наш конфиг:
<code>#include "models\vehicles\cars_spawn.ltx"</code>
Далее по накатанной дорожке. Допишем функцию вызова спавна:
<code lua>
function cheat:cheat3()
self:spawn_item("ven_niva", 5, 10)
end
</code>
и назначим ей кнопку 3 на цифровой клавиатуре:
<code lua>elseif dik == DIK_keys.DIK_NUMPAD3 then self:cheat3()</code>
Все. Можно запускаться и смотреть. Жмем Esc, потом F1 (главное меню пропадает, остается просто картинка), потом 1, 2 или 3 на цифровой клавиатуре. в выбранном радиусе будут появляться автоматы, патроны и Нивы.

Однако, оружие и боеприпасы при появлении падают на землю, а вот траспорт остается висеть в воздухе. Я пытаюсь понять, что можно сделать, но пока просто киньте в нее болт. Машина упадет и покатится, если стоит на неровной поверхности.

Продолжение следует...

== Монстры ==

Аналогично добавляем монстров и прочую живность. Функция:
function cheat:cheat4()
-- создаем монстра подальше от нас
self:spawn_item("dog_weak", 20)
end
Обработка клавиши '''4'''
elseif dik == DIK_keys.DIK_NUMPAD4 then self:cheat4()

== Сон по желанию ==

Если у Вас установлен Dream mod, то можно и его повесить на кнопку.
function cheat:cheat5()
sleep_manager.sleep_three_hours()
end
Предполагается, что имя скрипта '''sleep_manager.script''', а в нем есть функция '''sleep_three_hours()''', то есть спать 3 часа. Сам я не пользовал этот мод, поэтому могу ошибаться.

Прим. от Empro: лично у меня не заработало и повисло. Вообще, вызывать сон из главного меню, да ещё и в режиме паузы - неблагодарное дело.
Прим. от HikeR: сначала снять с паузы, а потом спать. Тогда все работает.

== Внимание!!! ==

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

Желательно выбирать ровную поверхность, либо поверхность с наклоном '''от''' игрока. Если спавнить '''в гору''' - то предмет вообще не появится, вернее он появится, но провалится под уровень.

== Ссылки на ресурсы ==

* [[Скрипт ui script|Полный текст скрипта ui_cheats.script]]
* [http://shooter-szene.4players.de/PNphpBB2-viewtopic-t-6216.phtml Stalker-MOD incl. Fahrzeuge] - официальный топик(обсуждение и загрузка)(нем.)
* [http://www.gsc-game.com/index.php?t=community&s=forums&s_game_type=xr&thm_page=2&thm_id=8281&sec_id=16 Обсуждение Jeppa's Vehicle mod на gsc-game.com](англ.)
* [http://www.gsc-game.com/index.php?t=community&s=forums&s_game_type=xr&thm_page=2&thm_id=8271&sec_id=17&page=3 Загрузка Jeppa's Vehicle mod на gsc-game.com](англ.)

== Благодарности ==

*'''Jeppa''' - за толчок в сторону изучения этой стороны скриптинга
*'''[http://forums.ag.ru/?action=viewprofile&username=Red75 Red75]''' - за расчет координат спавна (появление прямо перед нами)

== Что дальше? ==

А дальше плавно переходим к облагораживанию, иначе говоря - к [[Назначение скриптам горячих кнопок. Часть 2. Интерфейс|интерфейсу]].

--[[Участник:HikeR|HikeR]] 23:37, 20 мая 2007 (MSD)
[[Категория:Скрипты]]

Назначение скриптам горячих кнопок. Часть 1. Скрипт

2009-10-13T10:20:09Z

Wasly: /* Вступление */

== Вступление ==

Поизучав [http://shooter-szene.4players.de/modules/PNphpBB2/files/jeppa_s_mod__v1.05__incl.vehicles_946.zip мод] от камрада Jeppa, решил создать небольшое руководство по созданию новых интерфейсных окон, привязки скриптов на кнопки, реакцию на нажатия клавиш, спавн предметов прямо в игре.

К сожалению в самой игре возможность прибиндить запуск скрипта или еще какое действие на новую кнопку отсутствет, поэтому приходится придумывать что-то свое. Jeppa вышел из положения создав новое диалоговое окно на основе старого интерфейса загрузки спавн файлов. Он добавил на него 10 кнопок с описаниями, при нажатии на каждую вызывался какой-либо скрипт или функция.

Нам понадобятся следующие распакованные (или имеющиеся) файлы:
config\system.ltx
scripts\ui_main_menu.script
Остальное будем делать с нуля. Я придерживаюсь политики минимального вмешательства в уже имеющиеся файлы.

== Скрипт ==

Итак, как это сделать. Начнем с самого простого. Сначала создадим наш новый скрипт, который и будет заниматься вызовом других скриптов. Назовем его '''ui_cheat.script''' и положим ко всем остальным скриптам.

{| class="collapsible collapsed"
|-
! Вот его содержание:
|-
|
<code lua>-- инициализация
class "cheat" (CUIScriptWnd)

function cheat:__init(owner) super()
self.owner = owner
self:InitControls()
self:InitCallBacks()
end

function cheat:__finalize() end

function cheat:InitControls()
-- здесь будут все контролы
end

function cheat:InitCallBacks()
-- здесь будут все каллбаки (ну или обработчики)
end

-- сразу созадим ф-ию для выхода
function cheat:on_quit()
local console = get_console()
self:GetHolder():start_stop_menu (self.owner, true)
self:GetHolder():start_stop_menu (self,true)
self.owner:Show (true)
-- если мы вызывались из игры, то убираем главное меню
if level.present() and (db.actor ~= nil) and db.actor:alive() then
console:execute("main_menu off")
end
end</code>
|}
Теперь нужно как-то этот скрипт вызвать. Я решил пойти по проторенной дорожке, и вызывать его из главного меню. Пока мы не будем создавать там новых кнопок, а повесим его запуск на горячую клавишу. Например на F1, из игры будет удобно жать Esc и сразу F1. Но можете и другую кнопку использовать. Итак, открываем файл '''ui_main_menu.script''', идем в самый конец и ищем там такую ф-ию:
<code lua>function main_menu:OnKeyboard(dik, keyboard_action)</code>
Это обработчик нажатий клавиш. Ииспользуемые клавиши перечислены в '''lua_help.script''' (ищите строку ''C++ class DIK_keys''). Итак, вместо
<code lua>-- if dik == DIK_keys.DIK_S then
-- self:OnButton_load_spawn()

-- else
if dik == DIK_keys.DIK_Q then
self:OnMessageQuitWin()
end</code>
мы напишем
<code lua>-- раскоментируем и заоодно включим убранное спавн меню
if dik == DIK_keys.DIK_S then
self:OnButton_load_spawn()
elseif dik == DIK_keys.DIK_Q then
self:OnMessageQuitWin()
-- а вот это обработка кнопки F1. при ее нажатии будет вызываться ф-ия OnButton_ch
</code>

== Предметы ==

Теперь наша задача в том, чтобы в обработчик нажатий клавиш внести новые ф-ии. Начнем, например, со спавна предметов. Посмотрим, как спавнятся квестовые монстры и вещи и сделаем также (добаляем в конец '''ui_cheat.script'''):
<code lua>-- spawn_item - необходимый предмет
-- dist - радиус появления (случайно)
function cheat:spawn_item(spawn_item, dist)
local pos = db.actor:position()
local dir = db.actor:direction()
pos = pos:add(dir:mul(dist))
-- создаем предмет в dist метрах прямо перед нами
alife():create(spawn_item, pos, 1, db.actor:game_vertex_id())
end
</code>
{{Message_box|
id =pseudoscience|
align = left|
backgroundcolor = #f9f9f9|
image =Lamp.gif|
heading = Можно спавнить предметы прямо в инвентарь -- Neo][|
message = Функция будет выглядеть следующим образом(соответственно надо учитывать отсутствие параметра dist, при вызове функции и не применять при спавне техники и монстров):
<pre>function cheat:spawn_item(spawn_item)
alife():create (spawn_item, db.actor:position(), db.actor:level_vertex_id(),
db.actor:game_vertex_id(), db.actor:id())
end</pre>}}
 

<pre>Добавление от HikeR.
Таким образом, кстати, передаются квестовые предметы. Используйте в своих скриптах и новых квестах.
Функцию можно добавить к существующей, тогда при ее вызове будет проверятся количество аргументов
и вызываться нужная. В С++ это называется "перегрузка" (если не ошибаюсь ;)
</pre>

Теперь необходимо вызвать эту функцию. Привяжем кнопки '''1''' и '''2''' на цифровой клавиатуре к появлению Грозы и патронов к ней. В функцию '''cheat:OnKeyboard''' после строки:
<code lua>if dik == DIK_keys.DIK_ESCAPE then</code>
добавим следующее:
<code lua>
elseif dik == DIK_keys.DIK_NUMPAD1 then self:cheat1()
elseif dik == DIK_keys.DIK_NUMPAD2 then self:cheat2()
</code>
и создадим эти функции (опять добавляем в конец файла):
<code lua>
function cheat:cheat1()
-- колдуем грозу на расстоянии 3 метров.
self:spawn_item("wpn_groza", 3)
end
function cheat:cheat2()
self:spawn_item("ammo_9x39_sp5", 3)
end
</code>

== Транспорт ==

Спавнить транспорт мы будем аналогично, но тут есть небольшая проблема. В конфигах для траспорта отсутствуют необходимые параметры, все-таки машины в игре были вырезаны. Но нам это не помеха, поэтому начнем с Нивы.

Создадим новый файл с именем cars_spawn.ltx
<code>
[ven_niva]
class = SCRPTCAR
cform = skeleton
visual = physics\vehicles\niva\veh_niva_u_01.ogf
</code>
Сохраним его к остальным конфигам транспорта, то есть в '''config\models\vehicles'''. Это минимальный набор для правильного появление нового объекта в игре. Но игра еще не знает, что мы добавили новый конфиг, поэтому немного подредактируем '''system.ltx'''. В начале файла есть множество команд '''#include ...''', они подключают конфиги. найдем последний include и добавим наш конфиг:
<code>#include "models\vehicles\cars_spawn.ltx"</code>
Далее по накатанной дорожке. Допишем функцию вызова спавна:
<code lua>
function cheat:cheat3()
self:spawn_item("ven_niva", 5, 10)
end
</code>
и назначим ей кнопку 3 на цифровой клавиатуре:
<code lua>elseif dik == DIK_keys.DIK_NUMPAD3 then self:cheat3()</code>
Все. Можно запускаться и смотреть. Жмем Esc, потом F1 (главное меню пропадает, остается просто картинка), потом 1, 2 или 3 на цифровой клавиатуре. в выбранном радиусе будут появляться автоматы, патроны и Нивы.

Однако, оружие и боеприпасы при появлении падают на землю, а вот траспорт остается висеть в воздухе. Я пытаюсь понять, что можно сделать, но пока просто киньте в нее болт. Машина упадет и покатится, если стоит на неровной поверхности.

Продолжение следует...

== Монстры ==

Аналогично добавляем монстров и прочую живность. Функция:
function cheat:cheat4()
-- создаем монстра подальше от нас
self:spawn_item("dog_weak", 20)
end
Обработка клавиши '''4'''
elseif dik == DIK_keys.DIK_NUMPAD4 then self:cheat4()

== Сон по желанию ==

Если у Вас установлен Dream mod, то можно и его повесить на кнопку.
function cheat:cheat5()
sleep_manager.sleep_three_hours()
end
Предполагается, что имя скрипта '''sleep_manager.script''', а в нем есть функция '''sleep_three_hours()''', то есть спать 3 часа. Сам я не пользовал этот мод, поэтому могу ошибаться.

Прим. от Empro: лично у меня не заработало и повисло. Вообще, вызывать сон из главного меню, да ещё и в режиме паузы - неблагодарное дело.
Прим. от HikeR: сначала снять с паузы, а потом спать. Тогда все работает.

== Внимание!!! ==

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

Желательно выбирать ровную поверхность, либо поверхность с наклоном '''от''' игрока. Если спавнить '''в гору''' - то предмет вообще не появится, вернее он появится, но провалится под уровень.

== Ссылки на ресурсы ==

* [[Скрипт ui script|Полный текст скрипта ui_cheats.script]]
* [http://shooter-szene.4players.de/PNphpBB2-viewtopic-t-6216.phtml Stalker-MOD incl. Fahrzeuge] - официальный топик(обсуждение и загрузка)(нем.)
* [http://www.gsc-game.com/index.php?t=community&s=forums&s_game_type=xr&thm_page=2&thm_id=8281&sec_id=16 Обсуждение Jeppa's Vehicle mod на gsc-game.com](англ.)
* [http://www.gsc-game.com/index.php?t=community&s=forums&s_game_type=xr&thm_page=2&thm_id=8271&sec_id=17&page=3 Загрузка Jeppa's Vehicle mod на gsc-game.com](англ.)

== Благодарности ==

*'''Jeppa''' - за толчок в сторону изучения этой стороны скриптинга
*'''[http://forums.ag.ru/?action=viewprofile&username=Red75 Red75]''' - за расчет координат спавна (появление прямо перед нами)

== Что дальше? ==

А дальше плавно переходим к облагораживанию, иначе говоря - к [[Назначение скриптам горячих кнопок. Часть 2. Интерфейс|интерфейсу]].

--[[Участник:HikeR|HikeR]] 23:37, 20 мая 2007 (MSD)
[[Категория:Скрипты]]

Назначение скриптам горячих кнопок. Часть 1. Скрипт

2009-10-13T10:16:53Z

Wasly: /* Ссылки на ресурсы */

== Вступление ==

Поизучав мод от камрада Jeppa, решил создать небольшое руководство по созданию новых интерфейсных окон, привязки скриптов на кнопки, реакцию на нажатия клавиш, спавн предметов прямо в игре.
''(если кто знает ссылку на первоисточник мода '''jeppa_s_mod__v1.05__incl.vehicles_946''', то поставьте ее плиз. я только ссылки на закачку находил)''

К сожалению в самой игре возможность прибиндить запуск скрипта или еще какое действие на новую кнопку отсутствет, поэтому приходится придумывать что-то свое. Jeppa вышел из положения создав новое диалоговое окно на основе старого интерфейса загрузки спавн файлов. Он добавил на него 10 кнопок с описаниями, при нажатии на каждую вызывался какой-либо скрипт или функция.

Нам понадобятся следующие распакованные (или имеющиеся) файлы:
config\system.ltx
scripts\ui_main_menu.script
Остальное будем делать с нуля. Я придерживаюсь политики минимального вмешательства в уже имеющиеся файлы.

== Скрипт ==

Итак, как это сделать. Начнем с самого простого. Сначала создадим наш новый скрипт, который и будет заниматься вызовом других скриптов. Назовем его '''ui_cheat.script''' и положим ко всем остальным скриптам.

{| class="collapsible collapsed"
|-
! Вот его содержание:
|-
|
<code lua>-- инициализация
class "cheat" (CUIScriptWnd)

function cheat:__init(owner) super()
self.owner = owner
self:InitControls()
self:InitCallBacks()
end

function cheat:__finalize() end

function cheat:InitControls()
-- здесь будут все контролы
end

function cheat:InitCallBacks()
-- здесь будут все каллбаки (ну или обработчики)
end

-- сразу созадим ф-ию для выхода
function cheat:on_quit()
local console = get_console()
self:GetHolder():start_stop_menu (self.owner, true)
self:GetHolder():start_stop_menu (self,true)
self.owner:Show (true)
-- если мы вызывались из игры, то убираем главное меню
if level.present() and (db.actor ~= nil) and db.actor:alive() then
console:execute("main_menu off")
end
end</code>
|}
Теперь нужно как-то этот скрипт вызвать. Я решил пойти по проторенной дорожке, и вызывать его из главного меню. Пока мы не будем создавать там новых кнопок, а повесим его запуск на горячую клавишу. Например на F1, из игры будет удобно жать Esc и сразу F1. Но можете и другую кнопку использовать. Итак, открываем файл '''ui_main_menu.script''', идем в самый конец и ищем там такую ф-ию:
<code lua>function main_menu:OnKeyboard(dik, keyboard_action)</code>
Это обработчик нажатий клавиш. Ииспользуемые клавиши перечислены в '''lua_help.script''' (ищите строку ''C++ class DIK_keys''). Итак, вместо
<code lua>-- if dik == DIK_keys.DIK_S then
-- self:OnButton_load_spawn()

-- else
if dik == DIK_keys.DIK_Q then
self:OnMessageQuitWin()
end</code>
мы напишем
<code lua>-- раскоментируем и заоодно включим убранное спавн меню
if dik == DIK_keys.DIK_S then
self:OnButton_load_spawn()
elseif dik == DIK_keys.DIK_Q then
self:OnMessageQuitWin()
-- а вот это обработка кнопки F1. при ее нажатии будет вызываться ф-ия OnButton_ch
</code>

== Предметы ==

Теперь наша задача в том, чтобы в обработчик нажатий клавиш внести новые ф-ии. Начнем, например, со спавна предметов. Посмотрим, как спавнятся квестовые монстры и вещи и сделаем также (добаляем в конец '''ui_cheat.script'''):
<code lua>-- spawn_item - необходимый предмет
-- dist - радиус появления (случайно)
function cheat:spawn_item(spawn_item, dist)
local pos = db.actor:position()
local dir = db.actor:direction()
pos = pos:add(dir:mul(dist))
-- создаем предмет в dist метрах прямо перед нами
alife():create(spawn_item, pos, 1, db.actor:game_vertex_id())
end
</code>
{{Message_box|
id =pseudoscience|
align = left|
backgroundcolor = #f9f9f9|
image =Lamp.gif|
heading = Можно спавнить предметы прямо в инвентарь -- Neo][|
message = Функция будет выглядеть следующим образом(соответственно надо учитывать отсутствие параметра dist, при вызове функции и не применять при спавне техники и монстров):
<pre>function cheat:spawn_item(spawn_item)
alife():create (spawn_item, db.actor:position(), db.actor:level_vertex_id(),
db.actor:game_vertex_id(), db.actor:id())
end</pre>}}
 

<pre>Добавление от HikeR.
Таким образом, кстати, передаются квестовые предметы. Используйте в своих скриптах и новых квестах.
Функцию можно добавить к существующей, тогда при ее вызове будет проверятся количество аргументов
и вызываться нужная. В С++ это называется "перегрузка" (если не ошибаюсь ;)
</pre>

Теперь необходимо вызвать эту функцию. Привяжем кнопки '''1''' и '''2''' на цифровой клавиатуре к появлению Грозы и патронов к ней. В функцию '''cheat:OnKeyboard''' после строки:
<code lua>if dik == DIK_keys.DIK_ESCAPE then</code>
добавим следующее:
<code lua>
elseif dik == DIK_keys.DIK_NUMPAD1 then self:cheat1()
elseif dik == DIK_keys.DIK_NUMPAD2 then self:cheat2()
</code>
и создадим эти функции (опять добавляем в конец файла):
<code lua>
function cheat:cheat1()
-- колдуем грозу на расстоянии 3 метров.
self:spawn_item("wpn_groza", 3)
end
function cheat:cheat2()
self:spawn_item("ammo_9x39_sp5", 3)
end
</code>

== Транспорт ==

Спавнить транспорт мы будем аналогично, но тут есть небольшая проблема. В конфигах для траспорта отсутствуют необходимые параметры, все-таки машины в игре были вырезаны. Но нам это не помеха, поэтому начнем с Нивы.

Создадим новый файл с именем cars_spawn.ltx
<code>
[ven_niva]
class = SCRPTCAR
cform = skeleton
visual = physics\vehicles\niva\veh_niva_u_01.ogf
</code>
Сохраним его к остальным конфигам транспорта, то есть в '''config\models\vehicles'''. Это минимальный набор для правильного появление нового объекта в игре. Но игра еще не знает, что мы добавили новый конфиг, поэтому немного подредактируем '''system.ltx'''. В начале файла есть множество команд '''#include ...''', они подключают конфиги. найдем последний include и добавим наш конфиг:
<code>#include "models\vehicles\cars_spawn.ltx"</code>
Далее по накатанной дорожке. Допишем функцию вызова спавна:
<code lua>
function cheat:cheat3()
self:spawn_item("ven_niva", 5, 10)
end
</code>
и назначим ей кнопку 3 на цифровой клавиатуре:
<code lua>elseif dik == DIK_keys.DIK_NUMPAD3 then self:cheat3()</code>
Все. Можно запускаться и смотреть. Жмем Esc, потом F1 (главное меню пропадает, остается просто картинка), потом 1, 2 или 3 на цифровой клавиатуре. в выбранном радиусе будут появляться автоматы, патроны и Нивы.

Однако, оружие и боеприпасы при появлении падают на землю, а вот траспорт остается висеть в воздухе. Я пытаюсь понять, что можно сделать, но пока просто киньте в нее болт. Машина упадет и покатится, если стоит на неровной поверхности.

Продолжение следует...

== Монстры ==

Аналогично добавляем монстров и прочую живность. Функция:
function cheat:cheat4()
-- создаем монстра подальше от нас
self:spawn_item("dog_weak", 20)
end
Обработка клавиши '''4'''
elseif dik == DIK_keys.DIK_NUMPAD4 then self:cheat4()

== Сон по желанию ==

Если у Вас установлен Dream mod, то можно и его повесить на кнопку.
function cheat:cheat5()
sleep_manager.sleep_three_hours()
end
Предполагается, что имя скрипта '''sleep_manager.script''', а в нем есть функция '''sleep_three_hours()''', то есть спать 3 часа. Сам я не пользовал этот мод, поэтому могу ошибаться.

Прим. от Empro: лично у меня не заработало и повисло. Вообще, вызывать сон из главного меню, да ещё и в режиме паузы - неблагодарное дело.
Прим. от HikeR: сначала снять с паузы, а потом спать. Тогда все работает.

== Внимание!!! ==

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

Желательно выбирать ровную поверхность, либо поверхность с наклоном '''от''' игрока. Если спавнить '''в гору''' - то предмет вообще не появится, вернее он появится, но провалится под уровень.

== Ссылки на ресурсы ==

* [[Скрипт ui script|Полный текст скрипта ui_cheats.script]]
* [http://shooter-szene.4players.de/PNphpBB2-viewtopic-t-6216.phtml Stalker-MOD incl. Fahrzeuge] - официальный топик(обсуждение и загрузка)(нем.)
* [http://www.gsc-game.com/index.php?t=community&s=forums&s_game_type=xr&thm_page=2&thm_id=8281&sec_id=16 Обсуждение Jeppa's Vehicle mod на gsc-game.com](англ.)
* [http://www.gsc-game.com/index.php?t=community&s=forums&s_game_type=xr&thm_page=2&thm_id=8271&sec_id=17&page=3 Загрузка Jeppa's Vehicle mod на gsc-game.com](англ.)

== Благодарности ==

*'''Jeppa''' - за толчок в сторону изучения этой стороны скриптинга
*'''[http://forums.ag.ru/?action=viewprofile&username=Red75 Red75]''' - за расчет координат спавна (появление прямо перед нами)

== Что дальше? ==

А дальше плавно переходим к облагораживанию, иначе говоря - к [[Назначение скриптам горячих кнопок. Часть 2. Интерфейс|интерфейсу]].

--[[Участник:HikeR|HikeR]] 23:37, 20 мая 2007 (MSD)
[[Категория:Скрипты]]

Назначение скриптам горячих кнопок. Часть 1. Скрипт

2009-10-13T09:16:49Z

Wasly: /* Скрипт */

== Вступление ==

Поизучав мод от камрада Jeppa, решил создать небольшое руководство по созданию новых интерфейсных окон, привязки скриптов на кнопки, реакцию на нажатия клавиш, спавн предметов прямо в игре.
''(если кто знает ссылку на первоисточник мода '''jeppa_s_mod__v1.05__incl.vehicles_946''', то поставьте ее плиз. я только ссылки на закачку находил)''

К сожалению в самой игре возможность прибиндить запуск скрипта или еще какое действие на новую кнопку отсутствет, поэтому приходится придумывать что-то свое. Jeppa вышел из положения создав новое диалоговое окно на основе старого интерфейса загрузки спавн файлов. Он добавил на него 10 кнопок с описаниями, при нажатии на каждую вызывался какой-либо скрипт или функция.

Нам понадобятся следующие распакованные (или имеющиеся) файлы:
config\system.ltx
scripts\ui_main_menu.script
Остальное будем делать с нуля. Я придерживаюсь политики минимального вмешательства в уже имеющиеся файлы.

== Скрипт ==

Итак, как это сделать. Начнем с самого простого. Сначала создадим наш новый скрипт, который и будет заниматься вызовом других скриптов. Назовем его '''ui_cheat.script''' и положим ко всем остальным скриптам.

{| class="collapsible collapsed"
|-
! Вот его содержание:
|-
|
<code lua>-- инициализация
class "cheat" (CUIScriptWnd)

function cheat:__init(owner) super()
self.owner = owner
self:InitControls()
self:InitCallBacks()
end

function cheat:__finalize() end

function cheat:InitControls()
-- здесь будут все контролы
end

function cheat:InitCallBacks()
-- здесь будут все каллбаки (ну или обработчики)
end

-- сразу созадим ф-ию для выхода
function cheat:on_quit()
local console = get_console()
self:GetHolder():start_stop_menu (self.owner, true)
self:GetHolder():start_stop_menu (self,true)
self.owner:Show (true)
-- если мы вызывались из игры, то убираем главное меню
if level.present() and (db.actor ~= nil) and db.actor:alive() then
console:execute("main_menu off")
end
end</code>
|}
Теперь нужно как-то этот скрипт вызвать. Я решил пойти по проторенной дорожке, и вызывать его из главного меню. Пока мы не будем создавать там новых кнопок, а повесим его запуск на горячую клавишу. Например на F1, из игры будет удобно жать Esc и сразу F1. Но можете и другую кнопку использовать. Итак, открываем файл '''ui_main_menu.script''', идем в самый конец и ищем там такую ф-ию:
<code lua>function main_menu:OnKeyboard(dik, keyboard_action)</code>
Это обработчик нажатий клавиш. Ииспользуемые клавиши перечислены в '''lua_help.script''' (ищите строку ''C++ class DIK_keys''). Итак, вместо
<code lua>-- if dik == DIK_keys.DIK_S then
-- self:OnButton_load_spawn()

-- else
if dik == DIK_keys.DIK_Q then
self:OnMessageQuitWin()
end</code>
мы напишем
<code lua>-- раскоментируем и заоодно включим убранное спавн меню
if dik == DIK_keys.DIK_S then
self:OnButton_load_spawn()
elseif dik == DIK_keys.DIK_Q then
self:OnMessageQuitWin()
-- а вот это обработка кнопки F1. при ее нажатии будет вызываться ф-ия OnButton_ch
</code>

== Предметы ==

Теперь наша задача в том, чтобы в обработчик нажатий клавиш внести новые ф-ии. Начнем, например, со спавна предметов. Посмотрим, как спавнятся квестовые монстры и вещи и сделаем также (добаляем в конец '''ui_cheat.script'''):
<code lua>-- spawn_item - необходимый предмет
-- dist - радиус появления (случайно)
function cheat:spawn_item(spawn_item, dist)
local pos = db.actor:position()
local dir = db.actor:direction()
pos = pos:add(dir:mul(dist))
-- создаем предмет в dist метрах прямо перед нами
alife():create(spawn_item, pos, 1, db.actor:game_vertex_id())
end
</code>
{{Message_box|
id =pseudoscience|
align = left|
backgroundcolor = #f9f9f9|
image =Lamp.gif|
heading = Можно спавнить предметы прямо в инвентарь -- Neo][|
message = Функция будет выглядеть следующим образом(соответственно надо учитывать отсутствие параметра dist, при вызове функции и не применять при спавне техники и монстров):
<pre>function cheat:spawn_item(spawn_item)
alife():create (spawn_item, db.actor:position(), db.actor:level_vertex_id(),
db.actor:game_vertex_id(), db.actor:id())
end</pre>}}
 

<pre>Добавление от HikeR.
Таким образом, кстати, передаются квестовые предметы. Используйте в своих скриптах и новых квестах.
Функцию можно добавить к существующей, тогда при ее вызове будет проверятся количество аргументов
и вызываться нужная. В С++ это называется "перегрузка" (если не ошибаюсь ;)
</pre>

Теперь необходимо вызвать эту функцию. Привяжем кнопки '''1''' и '''2''' на цифровой клавиатуре к появлению Грозы и патронов к ней. В функцию '''cheat:OnKeyboard''' после строки:
<code lua>if dik == DIK_keys.DIK_ESCAPE then</code>
добавим следующее:
<code lua>
elseif dik == DIK_keys.DIK_NUMPAD1 then self:cheat1()
elseif dik == DIK_keys.DIK_NUMPAD2 then self:cheat2()
</code>
и создадим эти функции (опять добавляем в конец файла):
<code lua>
function cheat:cheat1()
-- колдуем грозу на расстоянии 3 метров.
self:spawn_item("wpn_groza", 3)
end
function cheat:cheat2()
self:spawn_item("ammo_9x39_sp5", 3)
end
</code>

== Транспорт ==

Спавнить транспорт мы будем аналогично, но тут есть небольшая проблема. В конфигах для траспорта отсутствуют необходимые параметры, все-таки машины в игре были вырезаны. Но нам это не помеха, поэтому начнем с Нивы.

Создадим новый файл с именем cars_spawn.ltx
<code>
[ven_niva]
class = SCRPTCAR
cform = skeleton
visual = physics\vehicles\niva\veh_niva_u_01.ogf
</code>
Сохраним его к остальным конфигам транспорта, то есть в '''config\models\vehicles'''. Это минимальный набор для правильного появление нового объекта в игре. Но игра еще не знает, что мы добавили новый конфиг, поэтому немного подредактируем '''system.ltx'''. В начале файла есть множество команд '''#include ...''', они подключают конфиги. найдем последний include и добавим наш конфиг:
<code>#include "models\vehicles\cars_spawn.ltx"</code>
Далее по накатанной дорожке. Допишем функцию вызова спавна:
<code lua>
function cheat:cheat3()
self:spawn_item("ven_niva", 5, 10)
end
</code>
и назначим ей кнопку 3 на цифровой клавиатуре:
<code lua>elseif dik == DIK_keys.DIK_NUMPAD3 then self:cheat3()</code>
Все. Можно запускаться и смотреть. Жмем Esc, потом F1 (главное меню пропадает, остается просто картинка), потом 1, 2 или 3 на цифровой клавиатуре. в выбранном радиусе будут появляться автоматы, патроны и Нивы.

Однако, оружие и боеприпасы при появлении падают на землю, а вот траспорт остается висеть в воздухе. Я пытаюсь понять, что можно сделать, но пока просто киньте в нее болт. Машина упадет и покатится, если стоит на неровной поверхности.

Продолжение следует...

== Монстры ==

Аналогично добавляем монстров и прочую живность. Функция:
function cheat:cheat4()
-- создаем монстра подальше от нас
self:spawn_item("dog_weak", 20)
end
Обработка клавиши '''4'''
elseif dik == DIK_keys.DIK_NUMPAD4 then self:cheat4()

== Сон по желанию ==

Если у Вас установлен Dream mod, то можно и его повесить на кнопку.
function cheat:cheat5()
sleep_manager.sleep_three_hours()
end
Предполагается, что имя скрипта '''sleep_manager.script''', а в нем есть функция '''sleep_three_hours()''', то есть спать 3 часа. Сам я не пользовал этот мод, поэтому могу ошибаться.

Прим. от Empro: лично у меня не заработало и повисло. Вообще, вызывать сон из главного меню, да ещё и в режиме паузы - неблагодарное дело.
Прим. от HikeR: сначала снять с паузы, а потом спать. Тогда все работает.

== Внимание!!! ==

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

Желательно выбирать ровную поверхность, либо поверхность с наклоном '''от''' игрока. Если спавнить '''в гору''' - то предмет вообще не появится, вернее он появится, но провалится под уровень.

== Ссылки на ресурсы ==

[[Скрипт ui script|Полный текст скрипта ui_cheats.script]]

== Благодарности ==

*'''Jeppa''' - за толчок в сторону изучения этой стороны скриптинга
*'''[http://forums.ag.ru/?action=viewprofile&username=Red75 Red75]''' - за расчет координат спавна (появление прямо перед нами)

== Что дальше? ==

А дальше плавно переходим к облагораживанию, иначе говоря - к [[Назначение скриптам горячих кнопок. Часть 2. Интерфейс|интерфейсу]].

--[[Участник:HikeR|HikeR]] 23:37, 20 мая 2007 (MSD)
[[Категория:Скрипты]]