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

Создание диалогов (полный обзор)

2008-08-10T16:18:07Z

89.178.50.109: /* Диалоги */

'''Статья в процессе написания...'''

===Общие данные===

В диалогах обычно задействуются три .xml-файла:

* character_desc_x.xml
* dialogs_x.xml
* stable_dialogs_x.xml

В них нам важны, соотвественно, списки присвоения диалогов персонажам, структуры диалогов и текстовые массивы для фраз.

===Структура фраз===

В общем виде диалог выглядит так:

'''диалог 001''' '''фраза 0''' 
''"Так, чего хотел-то?"'' 
следующие фразы: '''1''' '''фраза 1''' 
''"Задание для тебя есть. Возьмешься?"'' 
следующие фразы: '''21, 22''' '''фраза 21''' 
''"Ну, давай."'' 
следующие фразы: '''3''' '''фраза 22''' 
''"Не, иди к черту."'' 
следующие фразы: '''нет''' 
действие: '''выйти из диалога''' [фраза 3 и дальнейшее продолжение...] '''конец диалога'''

В файлах эта структура записывается следующим образом:

<xml>
<dialog id="escape_trader_letat_gusi">
<phrase_list>

<phrase id="0">
<text>Так, чего хотел-то?</text>
<next>1</next>
</phrase>

<phrase id="1">
<text>Задание для тебя есть. Возьмешься?</text>
<next>21</next>
<next>22</next>
</phrase>

<phrase id="21">
<text>Ну, давай.</text>
<next>3</next>
</phrase>

<phrase id="22">
<text>Не, иди к черту.</text>
<action>dialogs.break_dialog</action>
</phrase>

[...]

</phrase_list>
</dialog>
</xml>

Разберемся подробнее.

Во-первых, принадлежность фраз.
Они могут принадлежать или игроку, или NPC, причем:

* фраза, принадлежащая игроку, всегда идет первой, а за ней уже по древу диалога игра понимает, чья фраза кому принадлежит (например, у нас 0, 21, 22 - игрока; а 1, 3 - NPC)
* только у фразы, принадлежащей NPC, можно выбрать несколько вариантов ответа игрока

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

Во-вторых, структура фразы.
Простейшая фраза выглядит так:

<xml>
<phrase id="0"> -- открывающий тег с ID фразы
<text>Привет.</text> -- текст фразы
<next>1</next> -- ссылка на следующую фразу
</phrase> -- закрытие тега фразы
</xml>

Но есть возможность строить и такие фразы (в данном случае она принадлежит NPC, а игрок на неё будет давать ответ):

<xml>
<phrase id="1">
<give_info>propusk_given</give_info> -- выдача инфопорции (см. объяснение №1 ниже)
<text>Вот, держи пропуск. Теперь тебе охранник позволит войти.</text>
<action>dialogs.give_propusk_item</action> -- ссылка на скрипт (см. объяснение №2 ниже)
<next>21</next>
<next>22</next>
<next>23</next>
</phrase>
</xml>

* 1. Здесь у нас выдается [[Инфопорция|инфопорция]], которая может потом использоваться в различных местах (например, её наличие может проверяться каким-нибудь охранником - и если она есть, то он, скажем, отойдет и пропустит игрока внутрь). Важно понимать отличие инфопорции от предмета. Инфопорция - это ''факт наличия'' пропуска, а лежащий в инвентаре пропуск - ''материальный предмет''. Можно, кстати, обойтись и без инфопорций, впоследствии пользуясь скриптами, проверяющими инвентарь игрока и ищущими нужный предмет, но этот способ сложен и нам пока не понадобится.

* 2. Это скрипт, выдающий игроку предмет "пропуск" в инвентарь. Ссылка на скрипты дается в формате имя_файла.имя_функции.

Как видите, фраза, в которой некий NPC выдает игроку пропуск, позволяющий пройти дальше, достаточно сложна.

Вот еще один пример (здесь она принадлежит игроку):

<xml>
<phrase id="4">
<has_info>propusk_given</has_info> -- проверка на наличие инфопорции propusk_given
<text>Да, пропуск у меня есть.</text>
<action>dialogs.break_dialog</action> -- ссылка на скрипт, завершающий диалог
</phrase>
</xml>

Здесь у нас фраза из диалога игрока с NPC - та, что после вопроса NPC "А пропуск у тебя есть?". Это один из вариантов ответа на неё. Особенность в том, что этот вариант не появится, если пропуска у вас на самом деле нет - она появляется только при наличии нужной инфопорции (за это отвечает строка с <has_info>).

Далее, поподробнее остановимся на задании условий появления фразы. 
Способов это сделать - два.

* проверка на наличие инфопорций
* проверка через скриптовую функцию

Первый метод мы видели выше, а второй - гораздо более комплексный и многофункциональный. Он запускает скрипт, который проводит проверку определенных вещей, и возвращает true/false. Простой пример - NPC требует денег (скажем, 5000 рублей), а нам нужно, чтобы ответная фраза игрока "Вот, держи свои 5000.", могла быть доступна для выбора, только если у нас действительно есть эти деньги. Для этого пишем такую фразу:

<xml>
<phrase id="8">
<text>Вот, держи, ровно 5000.</text>
<precondition>dialogs.actor_have_5000</precondition> -- вызываем условие (см. объяснение №1 ниже)
<action>dialogs.transfer_5000</action> -- передача денег скриптом (см. объяснение №2 ниже)
<next>9</next>
</phrase>
</xml>

* 1. Этот скрипт который проверяет наличие денег: если было возвращено true, то фраза доступна.
* 2. Вызываем другой скрипт, действие - он осуществляет саму передачу денег.

Да, кстати, порядок расстановки тегов внутри фразы не играет никакой роли - они все выполняются одновременно. Единственное - <next> всегда последний. Еще одно - есть второй вид проверки на инфопорцию - он наоборот, проверяет её отсутствие. Применяется точно так же, но называется не has_info, а dont_has_info.

Итак, что у нас есть:

* '''<phrase id="..."></phrase>''' - общий тег фразы, задание номера фразы
* '''<nowiki><text>...</text></nowiki>''' - тег, содержащий текст фразы
* '''<give_info>...</give_info>''' - выдача инфопорции с именем, записанным в теге
* '''<has_info>...</has_info>''' - проверка на наличие инфопорции с именем, записанным в теге
* '''<dont_has_info>...</dont_has_info>''' - проверка на отсутствие инфопорции с именем, записанным в теге
* '''<precondition>...</precondition>''' - запуск скрипта, возвращающего true или false в зависимости от чего-либо (скриптовая проверка)
* '''<action>...</action>''' - запуск скрипта
* '''<next>...</next>''' - тег ссылки на следующую фразу

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

Номер фразы: '''12''' Текст: ''Да, там сейчас база военных. Я не в курсе, сколько их там точно, но могу сказать, не меньше, чем один два отряда.'' Выдать инфопорцию: '''info_about_military_base''' Проверить наличие инфопорции: '''info_1''' Проверить отсутствие инфопорции: '''нет''' Проверить через скрипт: '''dialogs.is_npc_a_friend''' Совершить действие: '''dialogs.break_dialog''' Номера следующих фраз: '''13''' 

Нам нужна вот такая запись:

<xml>
<phrase id="12">
<has_info>info_1</has_info>
<text>Да, там сейчас база военных. Я не в курсе, сколько их там точно [...]</text>
<precondition>dialogs.is_npc_a_friend</precondition>
<action>dialogs.break_dialog</action>
<give_info>info_about_military_base</give_info>
<next>13</next>
</phrase>
</xml>

===Текстовые (строковые) массивы===

Мы упустили один важный нюанс, критичный для крупных диалогов.

<xml>
<phrase id="54">
<text>Здравствуй, сталкер. Чем я могу помочь тебе?</text>
<next>55</next>
</phrase>
</xml>

Мы записывали текст фразы в <'''text>...</text>'''. Это, безусловно, удобно, но на самом деле - может привести к проблемам. Дело в том, что таким образом можно использовать только короткие фразы. Стоит ввести в тег длинный текст, и игра... так сказать, не переварит наш диалог.

Поэтому нужно использовать не тексты, а ссылки на них. Работает это так:

[[Изображение:Text massive explain.jpg]]

То есть фразу мы записываем так:

<xml>
<phrase id="54">
<text>my_text_1</text>
<next>55</next>
</phrase>
</xml>

А в игре видим нормальный текст - игра по названию my_text_1 находит его в массиве. 
Массивы (для русскоязычной версии игры) находятся в папке:

<pre>S.T.A.L.K.E.R\gamedata\config\text\rus</pre>

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

Запись текста происходит в такой форме:

<xml>
<string id="my_text_1"> -- в заголовке указывается имя текста, которое вызывается из диалога
<text>Здравствуй, сталкер. Чем я могу помочь тебе?</text> -- собственно, сам текст
</string>
</xml>

===Диалоги===

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

Откроем папку:

<pre>S.T.A.L.K.E.R\gamedata\config\gameplay</pre>

Сейчас нас интересует файл '''character_desc_escape.xml''', хранящий профили персонажей с локации "Кордон" (остальные файлы названы по аналогичной системе - вместо '''escape''', соответственно, идет название других уровней). Открываем его и видим профиль Сидоровича '''escape_trader''' - он находится в самом начале файла.

<xml>
<specific_character id="escape_trader" no_random = "1">
<name>escape_trader_name</name>
<icon>ui_npc_u_trader</icon>
<bio>escape_trader_bio</bio>

<class>trader</class>
<community>trader</community>
<visual>actors\trader\trader</visual>

<rank>330</rank>
<reputation>23</reputation>
<money min="100000" max="100000" infinitive="1"/>
<supplies>
[spawn] \n
wpn_knife \n
</supplies>

<start_dialog>escape_trader_start_dialog</start_dialog>
<actor_dialog>escape_trader_talk_info</actor_dialog>
<actor_dialog>escape_trader_jobs</actor_dialog>
<actor_dialog>tm_trader_dialog</actor_dialog>
<actor_dialog>tm_trader_reward</actor_dialog>
<actor_dialog>escape_trader_done_blockpost_box</actor_dialog>
</specific_character>
</xml>

Подробный разбор параметров профиля мы делать не будем - для этого существует [[Редактирование_NPC|отдельная статья]]. Сейчас нас интересуют теги <actor_dialog>...</actor_dialog>, ссылающиеся на доступные у этого NPC диалоги. Добавим в этот список и ссылку на наш будущий диалог:

<xml>
<start_dialog>escape_trader_start_dialog</start_dialog>
<actor_dialog>my_dialog_1</actor_dialog>
<actor_dialog>escape_trader_talk_info</actor_dialog>
<actor_dialog>escape_trader_jobs</actor_dialog>
<actor_dialog>tm_trader_dialog</actor_dialog>
<actor_dialog>tm_trader_reward</actor_dialog>
<actor_dialog>escape_trader_done_blockpost_box</actor_dialog>
</xml>

Далее добавим в любой диалоговый файл, например, в '''dialogs_escape.xml''', следующий диалог:

<xml>
<dialog id="my_dialog_1">
<precondition>my_script_for_dialogs.my_function_1</precondition> -- условия можно вызывать и здесь
<phrase_list>
<phrase id="0"> -- фразы Меченого
<text>my_text_0</text> -- "Ага, вот эти ребята..."
<next>1</next>
</phrase>
<phrase id="1"> -- фразы Сидоровича
<text>my_text_1</text> -- "Ненене!!! Нет, Меченый, нет!"
<next>2</next>
</phrase>
<phrase id="2">
<text>my_text_2</text> -- "Я делаю особую, уличную магию. Кто хочет увидеть немного магии?"
<next>3</next>
</phrase>
<phrase id="3">
<text>my_text_3</text> -- "Что я тебе, Толик какой-нибудь? Целый день у этих идиотов из лагеря
<next>4</next> разный хлам скупал, устал, хочу просто отдохнуть..."
</phrase>
<phrase id="4">
<text>my_text_4</text> -- "И что купил?"
<next>5</next>
</phrase>
<phrase id="5">
<text>my_text_5</text> -- "Я купил зеленый свитер, если ты так хочешь знать! Сорок долларов,
<next>6</next> между прочим."
</phrase>
<phrase id="6">
<text>my_text_6</text> -- "Зеленый свитер? А ты уверен, что не купил тедди-бир?"
<next>7</next>
</phrase>
<phrase id="7">
<text>my_text_7</text> -- "Тедди-бир?... ТЕДДИ-БИР!!! Где мой зеленый свитер, ты что делаешь, демон?!"
<next>8</next>
</phrase>
<phrase id="8">
<text>my_text_8</text> -- "Ладно, ладно... еще один фокус. Будь добр, взгляни на телевизор
<next>9</next> рядом с тобой. Что он показывает?"
</phrase>
<phrase id="9">
<text>my_text_9</text> -- "Билд 1154!!! Ты что делаешь, демон, ты что делаешь?! Проваливай отсюда!"
<next>10</next>
</phrase>
<phrase id="10">
<text>my_text_10</text> -- "Ладно."
<action>dialogs.break_dialog</action> -- выход из диалога
</phrase>
</phrase_list>
</dialog>
</xml>

Для начала лучше попробовать свои силы в простом линейном диалоге вроде этого. 
Да, и не забудьте добавить строки с текстовыми фразами в массив. 
* Если вам неясно, что за ахинея написана в текстах, вам [http://ru.youtube.com/watch?v=CdTIQ6BVlvw&feature=related сюда] xD

===Дополнительные сведения по диалогам===

===Скрипт-генерируемые диалоги===

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

Создание диалогов (полный обзор)

2008-08-10T16:17:41Z

89.178.50.109: /* Структура фраз */

'''Статья в процессе написания...'''

===Общие данные===

В диалогах обычно задействуются три .xml-файла:

* character_desc_x.xml
* dialogs_x.xml
* stable_dialogs_x.xml

В них нам важны, соотвественно, списки присвоения диалогов персонажам, структуры диалогов и текстовые массивы для фраз.

===Структура фраз===

В общем виде диалог выглядит так:

'''диалог 001''' '''фраза 0''' 
''"Так, чего хотел-то?"'' 
следующие фразы: '''1''' '''фраза 1''' 
''"Задание для тебя есть. Возьмешься?"'' 
следующие фразы: '''21, 22''' '''фраза 21''' 
''"Ну, давай."'' 
следующие фразы: '''3''' '''фраза 22''' 
''"Не, иди к черту."'' 
следующие фразы: '''нет''' 
действие: '''выйти из диалога''' [фраза 3 и дальнейшее продолжение...] '''конец диалога'''

В файлах эта структура записывается следующим образом:

<xml>
<dialog id="escape_trader_letat_gusi">
<phrase_list>

<phrase id="0">
<text>Так, чего хотел-то?</text>
<next>1</next>
</phrase>

<phrase id="1">
<text>Задание для тебя есть. Возьмешься?</text>
<next>21</next>
<next>22</next>
</phrase>

<phrase id="21">
<text>Ну, давай.</text>
<next>3</next>
</phrase>

<phrase id="22">
<text>Не, иди к черту.</text>
<action>dialogs.break_dialog</action>
</phrase>

[...]

</phrase_list>
</dialog>
</xml>

Разберемся подробнее.

Во-первых, принадлежность фраз.
Они могут принадлежать или игроку, или NPC, причем:

* фраза, принадлежащая игроку, всегда идет первой, а за ней уже по древу диалога игра понимает, чья фраза кому принадлежит (например, у нас 0, 21, 22 - игрока; а 1, 3 - NPC)
* только у фразы, принадлежащей NPC, можно выбрать несколько вариантов ответа игрока

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

Во-вторых, структура фразы.
Простейшая фраза выглядит так:

<xml>
<phrase id="0"> -- открывающий тег с ID фразы
<text>Привет.</text> -- текст фразы
<next>1</next> -- ссылка на следующую фразу
</phrase> -- закрытие тега фразы
</xml>

Но есть возможность строить и такие фразы (в данном случае она принадлежит NPC, а игрок на неё будет давать ответ):

<xml>
<phrase id="1">
<give_info>propusk_given</give_info> -- выдача инфопорции (см. объяснение №1 ниже)
<text>Вот, держи пропуск. Теперь тебе охранник позволит войти.</text>
<action>dialogs.give_propusk_item</action> -- ссылка на скрипт (см. объяснение №2 ниже)
<next>21</next>
<next>22</next>
<next>23</next>
</phrase>
</xml>

* 1. Здесь у нас выдается [[Инфопорция|инфопорция]], которая может потом использоваться в различных местах (например, её наличие может проверяться каким-нибудь охранником - и если она есть, то он, скажем, отойдет и пропустит игрока внутрь). Важно понимать отличие инфопорции от предмета. Инфопорция - это ''факт наличия'' пропуска, а лежащий в инвентаре пропуск - ''материальный предмет''. Можно, кстати, обойтись и без инфопорций, впоследствии пользуясь скриптами, проверяющими инвентарь игрока и ищущими нужный предмет, но этот способ сложен и нам пока не понадобится.

* 2. Это скрипт, выдающий игроку предмет "пропуск" в инвентарь. Ссылка на скрипты дается в формате имя_файла.имя_функции.

Как видите, фраза, в которой некий NPC выдает игроку пропуск, позволяющий пройти дальше, достаточно сложна.

Вот еще один пример (здесь она принадлежит игроку):

<xml>
<phrase id="4">
<has_info>propusk_given</has_info> -- проверка на наличие инфопорции propusk_given
<text>Да, пропуск у меня есть.</text>
<action>dialogs.break_dialog</action> -- ссылка на скрипт, завершающий диалог
</phrase>
</xml>

Здесь у нас фраза из диалога игрока с NPC - та, что после вопроса NPC "А пропуск у тебя есть?". Это один из вариантов ответа на неё. Особенность в том, что этот вариант не появится, если пропуска у вас на самом деле нет - она появляется только при наличии нужной инфопорции (за это отвечает строка с <has_info>).

Далее, поподробнее остановимся на задании условий появления фразы. 
Способов это сделать - два.

* проверка на наличие инфопорций
* проверка через скриптовую функцию

Первый метод мы видели выше, а второй - гораздо более комплексный и многофункциональный. Он запускает скрипт, который проводит проверку определенных вещей, и возвращает true/false. Простой пример - NPC требует денег (скажем, 5000 рублей), а нам нужно, чтобы ответная фраза игрока "Вот, держи свои 5000.", могла быть доступна для выбора, только если у нас действительно есть эти деньги. Для этого пишем такую фразу:

<xml>
<phrase id="8">
<text>Вот, держи, ровно 5000.</text>
<precondition>dialogs.actor_have_5000</precondition> -- вызываем условие (см. объяснение №1 ниже)
<action>dialogs.transfer_5000</action> -- передача денег скриптом (см. объяснение №2 ниже)
<next>9</next>
</phrase>
</xml>

* 1. Этот скрипт который проверяет наличие денег: если было возвращено true, то фраза доступна.
* 2. Вызываем другой скрипт, действие - он осуществляет саму передачу денег.

Да, кстати, порядок расстановки тегов внутри фразы не играет никакой роли - они все выполняются одновременно. Единственное - <next> всегда последний. Еще одно - есть второй вид проверки на инфопорцию - он наоборот, проверяет её отсутствие. Применяется точно так же, но называется не has_info, а dont_has_info.

Итак, что у нас есть:

* '''<phrase id="..."></phrase>''' - общий тег фразы, задание номера фразы
* '''<nowiki><text>...</text></nowiki>''' - тег, содержащий текст фразы
* '''<give_info>...</give_info>''' - выдача инфопорции с именем, записанным в теге
* '''<has_info>...</has_info>''' - проверка на наличие инфопорции с именем, записанным в теге
* '''<dont_has_info>...</dont_has_info>''' - проверка на отсутствие инфопорции с именем, записанным в теге
* '''<precondition>...</precondition>''' - запуск скрипта, возвращающего true или false в зависимости от чего-либо (скриптовая проверка)
* '''<action>...</action>''' - запуск скрипта
* '''<next>...</next>''' - тег ссылки на следующую фразу

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

Номер фразы: '''12''' Текст: ''Да, там сейчас база военных. Я не в курсе, сколько их там точно, но могу сказать, не меньше, чем один два отряда.'' Выдать инфопорцию: '''info_about_military_base''' Проверить наличие инфопорции: '''info_1''' Проверить отсутствие инфопорции: '''нет''' Проверить через скрипт: '''dialogs.is_npc_a_friend''' Совершить действие: '''dialogs.break_dialog''' Номера следующих фраз: '''13''' 

Нам нужна вот такая запись:

<xml>
<phrase id="12">
<has_info>info_1</has_info>
<text>Да, там сейчас база военных. Я не в курсе, сколько их там точно [...]</text>
<precondition>dialogs.is_npc_a_friend</precondition>
<action>dialogs.break_dialog</action>
<give_info>info_about_military_base</give_info>
<next>13</next>
</phrase>
</xml>

===Текстовые (строковые) массивы===

Мы упустили один важный нюанс, критичный для крупных диалогов.

<xml>
<phrase id="54">
<text>Здравствуй, сталкер. Чем я могу помочь тебе?</text>
<next>55</next>
</phrase>
</xml>

Мы записывали текст фразы в <'''text>...</text>'''. Это, безусловно, удобно, но на самом деле - может привести к проблемам. Дело в том, что таким образом можно использовать только короткие фразы. Стоит ввести в тег длинный текст, и игра... так сказать, не переварит наш диалог.

Поэтому нужно использовать не тексты, а ссылки на них. Работает это так:

[[Изображение:Text massive explain.jpg]]

То есть фразу мы записываем так:

<xml>
<phrase id="54">
<text>my_text_1</text>
<next>55</next>
</phrase>
</xml>

А в игре видим нормальный текст - игра по названию my_text_1 находит его в массиве. 
Массивы (для русскоязычной версии игры) находятся в папке:

<pre>S.T.A.L.K.E.R\gamedata\config\text\rus</pre>

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

Запись текста происходит в такой форме:

<xml>
<string id="my_text_1"> -- в заголовке указывается имя текста, которое вызывается из диалога
<text>Здравствуй, сталкер. Чем я могу помочь тебе?</text> -- собственно, сам текст
</string>
</xml>

===Диалоги===

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

Откроем папку:

<pre>S.T.A.L.K.E.R\gamedata\config\gameplay</pre>

Сейчас нас интересует файл '''character_desc_escape.xml''', хранящий профили персонажей с локации "Кордон" (остальные файлы названы по аналогичной системе - вместо '''escape''', соответственно, идет название других уровней). Открываем его и видим профиль Сидоровича '''escape_trader''' - он находится в самом начале файла.

<code>
<specific_character id="escape_trader" no_random = "1">
<name>escape_trader_name</name>
<icon>ui_npc_u_trader</icon>
<bio>escape_trader_bio</bio>

<class>trader</class>
<community>trader</community>
<visual>actors\trader\trader</visual>

<rank>330</rank>
<reputation>23</reputation>
<money min="100000" max="100000" infinitive="1"/>
<supplies>
[spawn] \n
wpn_knife \n
</supplies>

<start_dialog>escape_trader_start_dialog</start_dialog>
<actor_dialog>escape_trader_talk_info</actor_dialog>
<actor_dialog>escape_trader_jobs</actor_dialog>
<actor_dialog>tm_trader_dialog</actor_dialog>
<actor_dialog>tm_trader_reward</actor_dialog>
<actor_dialog>escape_trader_done_blockpost_box</actor_dialog>
</specific_character>
</code>

Подробный разбор параметров профиля мы делать не будем - для этого существует [[Редактирование_NPC|отдельная статья]]. Сейчас нас интересуют теги <actor_dialog>...</actor_dialog>, ссылающиеся на доступные у этого NPC диалоги. Добавим в этот список и ссылку на наш будущий диалог:

<code>
<start_dialog>escape_trader_start_dialog</start_dialog>
<actor_dialog>my_dialog_1</actor_dialog>
<actor_dialog>escape_trader_talk_info</actor_dialog>
<actor_dialog>escape_trader_jobs</actor_dialog>
<actor_dialog>tm_trader_dialog</actor_dialog>
<actor_dialog>tm_trader_reward</actor_dialog>
<actor_dialog>escape_trader_done_blockpost_box</actor_dialog>
</code>

Далее добавим в любой диалоговый файл, например, в '''dialogs_escape.xml''', следующий диалог:

<code>
<dialog id="my_dialog_1">
<precondition>my_script_for_dialogs.my_function_1</precondition> -- условия можно вызывать и здесь
<phrase_list>
<phrase id="0"> -- фразы Меченого
<text>my_text_0</text> -- "Ага, вот эти ребята..."
<next>1</next>
</phrase>
<phrase id="1"> -- фразы Сидоровича
<text>my_text_1</text> -- "Ненене!!! Нет, Меченый, нет!"
<next>2</next>
</phrase>
<phrase id="2">
<text>my_text_2</text> -- "Я делаю особую, уличную магию. Кто хочет увидеть немного магии?"
<next>3</next>
</phrase>
<phrase id="3">
<text>my_text_3</text> -- "Что я тебе, Толик какой-нибудь? Целый день у этих идиотов из лагеря
<next>4</next> разный хлам скупал, устал, хочу просто отдохнуть..."
</phrase>
<phrase id="4">
<text>my_text_4</text> -- "И что купил?"
<next>5</next>
</phrase>
<phrase id="5">
<text>my_text_5</text> -- "Я купил зеленый свитер, если ты так хочешь знать! Сорок долларов,
<next>6</next> между прочим."
</phrase>
<phrase id="6">
<text>my_text_6</text> -- "Зеленый свитер? А ты уверен, что не купил тедди-бир?"
<next>7</next>
</phrase>
<phrase id="7">
<text>my_text_7</text> -- "Тедди-бир?... ТЕДДИ-БИР!!! Где мой зеленый свитер, ты что делаешь, демон?!"
<next>8</next>
</phrase>
<phrase id="8">
<text>my_text_8</text> -- "Ладно, ладно... еще один фокус. Будь добр, взгляни на телевизор
<next>9</next> рядом с тобой. Что он показывает?"
</phrase>
<phrase id="9">
<text>my_text_9</text> -- "Билд 1154!!! Ты что делаешь, демон, ты что делаешь?! Проваливай отсюда!"
<next>10</next>
</phrase>
<phrase id="10">
<text>my_text_10</text> -- "Ладно."
<action>dialogs.break_dialog</action> -- выход из диалога
</phrase>
</phrase_list>
</dialog>
</code>

Для начала лучше попробовать свои силы в простом линейном диалоге вроде этого. 
Да, и не забудьте добавить строки с текстовыми фразами в массив. 
* Если вам неясно, что за ахинея написана в текстах, вам [http://ru.youtube.com/watch?v=CdTIQ6BVlvw&feature=related сюда] xD

===Дополнительные сведения по диалогам===

===Скрипт-генерируемые диалоги===

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

Создание диалогов (полный обзор)

2008-08-10T16:11:08Z

89.178.50.109: /* Текстовые (строковые) массивы */

'''Статья в процессе написания...'''

===Общие данные===

В диалогах обычно задействуются три .xml-файла:

* character_desc_x.xml
* dialogs_x.xml
* stable_dialogs_x.xml

В них нам важны, соотвественно, списки присвоения диалогов персонажам, структуры диалогов и текстовые массивы для фраз.

===Структура фраз===

В общем виде диалог выглядит так:

'''диалог 001''' '''фраза 0''' 
''"Так, чего хотел-то?"'' 
следующие фразы: '''1''' '''фраза 1''' 
''"Задание для тебя есть. Возьмешься?"'' 
следующие фразы: '''21, 22''' '''фраза 21''' 
''"Ну, давай."'' 
следующие фразы: '''3''' '''фраза 22''' 
''"Не, иди к черту."'' 
следующие фразы: '''нет''' 
действие: '''выйти из диалога''' [фраза 3 и дальнейшее продолжение...] '''конец диалога'''

В файлах эта структура записывается следующим образом:

<xml>
<dialog id="escape_trader_letat_gusi">
<phrase_list>

<phrase id="0">
<text>Так, чего хотел-то?</text>
<next>1</next>
</phrase>

<phrase id="1">
<text>Задание для тебя есть. Возьмешься?</text>
<next>21</next>
<next>22</next>
</phrase>

<phrase id="21">
<text>Ну, давай.</text>
<next>3</next>
</phrase>

<phrase id="22">
<text>Не, иди к черту.</text>
<action>dialogs.break_dialog</action>
</phrase>

[...]

</phrase_list>
</dialog>
</xml>

Разберемся подробнее.

Во-первых, принадлежность фраз.
Они могут принадлежать или игроку, или NPC, причем:

* фраза, принадлежащая игроку, всегда идет первой, а за ней уже по древу диалога игра понимает, чья фраза кому принадлежит (например, у нас 0, 21, 22 - игрока; а 1, 3 - NPC)
* только у фразы, принадлежащей NPC, можно выбрать несколько вариантов ответа игрока

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

Во-вторых, структура фразы.
Простейшая фраза выглядит так:

<xml>
<phrase id="0"> -- открывающий тег с ID фразы
<text>Привет.</text> -- текст фразы
<next>1</next> -- ссылка на следующую фразу
</phrase> -- закрытие тега фразы
</xml>

Но есть возможность строить и такие фразы (в данном случае она принадлежит NPC, а игрок на неё будет давать ответ):

<xml>
<phrase id="1">
<give_info>propusk_given</give_info> -- выдача инфопорции (см. объяснение №1 ниже)
<text>Вот, держи пропуск. Теперь тебе охранник позволит войти.</text>
<action>dialogs.give_propusk_item</action> -- ссылка на скрипт (см. объяснение №2 ниже)
<next>21</next>
<next>22</next>
<next>23</next>
</phrase>
</xml>

* 1. Здесь у нас выдается [[Инфопорция|инфопорция]], которая может потом использоваться в различных местах (например, её наличие может проверяться каким-нибудь охранником - и если она есть, то он, скажем, отойдет и пропустит игрока внутрь). Важно понимать отличие инфопорции от предмета. Инфопорция - это ''факт наличия'' пропуска, а лежащий в инвентаре пропуск - ''материальный предмет''. Можно, кстати, обойтись и без инфопорций, впоследствии пользуясь скриптами, проверяющими инвентарь игрока и ищущими нужный предмет, но этот способ сложен и нам пока не понадобится.

* 2. Это скрипт, выдающий игроку предмет "пропуск" в инвентарь. Ссылка на скрипты дается в формате имя_файла.имя_функции.

Как видите, фраза, в которой некий NPC выдает игроку пропуск, позволяющий пройти дальше, достаточно сложна.

Вот еще один пример (здесь она принадлежит игроку):

<xml>
<phrase id="4">
<has_info>propusk_given</has_info> -- проверка на наличие инфопорции propusk_given
<text>Да, пропуск у меня есть.</text>
<action>dialogs.break_dialog</action> -- ссылка на скрипт, завершающий диалог
</phrase>
</xml>

Здесь у нас фраза из диалога игрока с NPC - та, что после вопроса NPC "А пропуск у тебя есть?". Это один из вариантов ответа на неё. Особенность в том, что этот вариант не появится, если пропуска у вас на самом деле нет - она появляется только при наличии нужной инфопорции (за это отвечает строка с <has_info>).

Далее, поподробнее остановимся на задании условий появления фразы. 
Способов это сделать - два.

* проверка на наличие инфопорций
* проверка через скриптовую функцию

Первый метод мы видели выше, а второй - гораздо более комплексный и многофункциональный. Он запускает скрипт, который проводит проверку определенных вещей, и возвращает true/false. Простой пример - NPC требует денег (скажем, 5000 рублей), а нам нужно, чтобы ответная фраза игрока "Вот, держи свои 5000.", могла быть доступна для выбора, только если у нас действительно есть эти деньги. Для этого пишем такую фразу:

<xml>
<phrase id="8">
<text>Вот, держи, ровно 5000.</text>
<precondition>dialogs.actor_have_5000</precondition> -- вызываем условие (см. объяснение №1 ниже)
<action>dialogs.transfer_5000</action> -- передача денег скриптом (см. объяснение №2 ниже)
<next>9</next>
</phrase>
</xml>

* 1. Этот скрипт который проверяет наличие денег: если было возвращено true, то фраза доступна.
* 2. Вызываем другой скрипт, действие - он осуществляет саму передачу денег.

Да, кстати, порядок расстановки тегов внутри фразы не играет никакой роли - они все выполняются одновременно. Единственное - <next> всегда последний. Еще одно - есть второй вид проверки на инфопорцию - он наоборот, проверяет её отсутствие. Применяется точно так же, но называется не has_info, а dont_has_info.

Итак, что у нас есть:

* '''<phrase id="..."></phrase>''' - общий тег фразы, задание номера фразы
* '''<text>...</text>''' - тег, содержащий текст фразы
* '''<give_info>...</give_info>''' - выдача инфопорции с именем, записанным в теге
* '''<has_info>...</has_info>''' - проверка на наличие инфопорции с именем, записанным в теге
* '''<dont_has_info>...</dont_has_info>''' - проверка на отсутствие инфопорции с именем, записанным в теге
* '''<precondition>...</precondition>''' - запуск скрипта, возвращающего true или false в зависимости от чего-либо (скриптовая проверка)
* '''<action>...</action>''' - запуск скрипта
* '''<next>...</next>''' - тег ссылки на следующую фразу

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

Номер фразы: '''12''' Текст: ''Да, там сейчас база военных. Я не в курсе, сколько их там точно, но могу сказать, не меньше, чем один два отряда.'' Выдать инфопорцию: '''info_about_military_base''' Проверить наличие инфопорции: '''info_1''' Проверить отсутствие инфопорции: '''нет''' Проверить через скрипт: '''dialogs.is_npc_a_friend''' Совершить действие: '''dialogs.break_dialog''' Номера следующих фраз: '''13''' 

Нам нужна вот такая запись:

<xml>
<phrase id="12">
<has_info>info_1</has_info>
<text>Да, там сейчас база военных. Я не в курсе, сколько их там точно [...]</text>
<precondition>dialogs.is_npc_a_friend</precondition>
<action>dialogs.break_dialog</action>
<give_info>info_about_military_base</give_info>
<next>13</next>
</phrase>
</xml>

===Текстовые (строковые) массивы===

Мы упустили один важный нюанс, критичный для крупных диалогов.

<xml>
<phrase id="54">
<text>Здравствуй, сталкер. Чем я могу помочь тебе?</text>
<next>55</next>
</phrase>
</xml>

Мы записывали текст фразы в <'''text>...</text>'''. Это, безусловно, удобно, но на самом деле - может привести к проблемам. Дело в том, что таким образом можно использовать только короткие фразы. Стоит ввести в тег длинный текст, и игра... так сказать, не переварит наш диалог.

Поэтому нужно использовать не тексты, а ссылки на них. Работает это так:

[[Изображение:Text massive explain.jpg]]

То есть фразу мы записываем так:

<xml>
<phrase id="54">
<text>my_text_1</text>
<next>55</next>
</phrase>
</xml>

А в игре видим нормальный текст - игра по названию my_text_1 находит его в массиве. 
Массивы (для русскоязычной версии игры) находятся в папке:

<pre>S.T.A.L.K.E.R\gamedata\config\text\rus</pre>

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

Запись текста происходит в такой форме:

<xml>
<string id="my_text_1"> -- в заголовке указывается имя текста, которое вызывается из диалога
<text>Здравствуй, сталкер. Чем я могу помочь тебе?</text> -- собственно, сам текст
</string>
</xml>

===Диалоги===

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

Откроем папку:

<pre>S.T.A.L.K.E.R\gamedata\config\gameplay</pre>

Сейчас нас интересует файл '''character_desc_escape.xml''', хранящий профили персонажей с локации "Кордон" (остальные файлы названы по аналогичной системе - вместо '''escape''', соответственно, идет название других уровней). Открываем его и видим профиль Сидоровича '''escape_trader''' - он находится в самом начале файла.

<code>
<specific_character id="escape_trader" no_random = "1">
<name>escape_trader_name</name>
<icon>ui_npc_u_trader</icon>
<bio>escape_trader_bio</bio>

<class>trader</class>
<community>trader</community>
<visual>actors\trader\trader</visual>

<rank>330</rank>
<reputation>23</reputation>
<money min="100000" max="100000" infinitive="1"/>
<supplies>
[spawn] \n
wpn_knife \n
</supplies>

<start_dialog>escape_trader_start_dialog</start_dialog>
<actor_dialog>escape_trader_talk_info</actor_dialog>
<actor_dialog>escape_trader_jobs</actor_dialog>
<actor_dialog>tm_trader_dialog</actor_dialog>
<actor_dialog>tm_trader_reward</actor_dialog>
<actor_dialog>escape_trader_done_blockpost_box</actor_dialog>
</specific_character>
</code>

Подробный разбор параметров профиля мы делать не будем - для этого существует [[Редактирование_NPC|отдельная статья]]. Сейчас нас интересуют теги <actor_dialog>...</actor_dialog>, ссылающиеся на доступные у этого NPC диалоги. Добавим в этот список и ссылку на наш будущий диалог:

<code>
<start_dialog>escape_trader_start_dialog</start_dialog>
<actor_dialog>my_dialog_1</actor_dialog>
<actor_dialog>escape_trader_talk_info</actor_dialog>
<actor_dialog>escape_trader_jobs</actor_dialog>
<actor_dialog>tm_trader_dialog</actor_dialog>
<actor_dialog>tm_trader_reward</actor_dialog>
<actor_dialog>escape_trader_done_blockpost_box</actor_dialog>
</code>

Далее добавим в любой диалоговый файл, например, в '''dialogs_escape.xml''', следующий диалог:

<code>
<dialog id="my_dialog_1">
<precondition>my_script_for_dialogs.my_function_1</precondition> -- условия можно вызывать и здесь
<phrase_list>
<phrase id="0"> -- фразы Меченого
<text>my_text_0</text> -- "Ага, вот эти ребята..."
<next>1</next>
</phrase>
<phrase id="1"> -- фразы Сидоровича
<text>my_text_1</text> -- "Ненене!!! Нет, Меченый, нет!"
<next>2</next>
</phrase>
<phrase id="2">
<text>my_text_2</text> -- "Я делаю особую, уличную магию. Кто хочет увидеть немного магии?"
<next>3</next>
</phrase>
<phrase id="3">
<text>my_text_3</text> -- "Что я тебе, Толик какой-нибудь? Целый день у этих идиотов из лагеря
<next>4</next> разный хлам скупал, устал, хочу просто отдохнуть..."
</phrase>
<phrase id="4">
<text>my_text_4</text> -- "И что купил?"
<next>5</next>
</phrase>
<phrase id="5">
<text>my_text_5</text> -- "Я купил зеленый свитер, если ты так хочешь знать! Сорок долларов,
<next>6</next> между прочим."
</phrase>
<phrase id="6">
<text>my_text_6</text> -- "Зеленый свитер? А ты уверен, что не купил тедди-бир?"
<next>7</next>
</phrase>
<phrase id="7">
<text>my_text_7</text> -- "Тедди-бир?... ТЕДДИ-БИР!!! Где мой зеленый свитер, ты что делаешь, демон?!"
<next>8</next>
</phrase>
<phrase id="8">
<text>my_text_8</text> -- "Ладно, ладно... еще один фокус. Будь добр, взгляни на телевизор
<next>9</next> рядом с тобой. Что он показывает?"
</phrase>
<phrase id="9">
<text>my_text_9</text> -- "Билд 1154!!! Ты что делаешь, демон, ты что делаешь?! Проваливай отсюда!"
<next>10</next>
</phrase>
<phrase id="10">
<text>my_text_10</text> -- "Ладно."
<action>dialogs.break_dialog</action> -- выход из диалога
</phrase>
</phrase_list>
</dialog>
</code>

Для начала лучше попробовать свои силы в простом линейном диалоге вроде этого. 
Да, и не забудьте добавить строки с текстовыми фразами в массив. 
* Если вам неясно, что за ахинея написана в текстах, вам [http://ru.youtube.com/watch?v=CdTIQ6BVlvw&feature=related сюда] xD

===Дополнительные сведения по диалогам===

===Скрипт-генерируемые диалоги===

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

Создание диалогов (полный обзор)

2008-08-10T16:10:27Z

89.178.50.109: /* Структура фраз */

'''Статья в процессе написания...'''

===Общие данные===

В диалогах обычно задействуются три .xml-файла:

* character_desc_x.xml
* dialogs_x.xml
* stable_dialogs_x.xml

В них нам важны, соотвественно, списки присвоения диалогов персонажам, структуры диалогов и текстовые массивы для фраз.

===Структура фраз===

В общем виде диалог выглядит так:

'''диалог 001''' '''фраза 0''' 
''"Так, чего хотел-то?"'' 
следующие фразы: '''1''' '''фраза 1''' 
''"Задание для тебя есть. Возьмешься?"'' 
следующие фразы: '''21, 22''' '''фраза 21''' 
''"Ну, давай."'' 
следующие фразы: '''3''' '''фраза 22''' 
''"Не, иди к черту."'' 
следующие фразы: '''нет''' 
действие: '''выйти из диалога''' [фраза 3 и дальнейшее продолжение...] '''конец диалога'''

В файлах эта структура записывается следующим образом:

<xml>
<dialog id="escape_trader_letat_gusi">
<phrase_list>

<phrase id="0">
<text>Так, чего хотел-то?</text>
<next>1</next>
</phrase>

<phrase id="1">
<text>Задание для тебя есть. Возьмешься?</text>
<next>21</next>
<next>22</next>
</phrase>

<phrase id="21">
<text>Ну, давай.</text>
<next>3</next>
</phrase>

<phrase id="22">
<text>Не, иди к черту.</text>
<action>dialogs.break_dialog</action>
</phrase>

[...]

</phrase_list>
</dialog>
</xml>

Разберемся подробнее.

Во-первых, принадлежность фраз.
Они могут принадлежать или игроку, или NPC, причем:

* фраза, принадлежащая игроку, всегда идет первой, а за ней уже по древу диалога игра понимает, чья фраза кому принадлежит (например, у нас 0, 21, 22 - игрока; а 1, 3 - NPC)
* только у фразы, принадлежащей NPC, можно выбрать несколько вариантов ответа игрока

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

Во-вторых, структура фразы.
Простейшая фраза выглядит так:

<xml>
<phrase id="0"> -- открывающий тег с ID фразы
<text>Привет.</text> -- текст фразы
<next>1</next> -- ссылка на следующую фразу
</phrase> -- закрытие тега фразы
</xml>

Но есть возможность строить и такие фразы (в данном случае она принадлежит NPC, а игрок на неё будет давать ответ):

<xml>
<phrase id="1">
<give_info>propusk_given</give_info> -- выдача инфопорции (см. объяснение №1 ниже)
<text>Вот, держи пропуск. Теперь тебе охранник позволит войти.</text>
<action>dialogs.give_propusk_item</action> -- ссылка на скрипт (см. объяснение №2 ниже)
<next>21</next>
<next>22</next>
<next>23</next>
</phrase>
</xml>

* 1. Здесь у нас выдается [[Инфопорция|инфопорция]], которая может потом использоваться в различных местах (например, её наличие может проверяться каким-нибудь охранником - и если она есть, то он, скажем, отойдет и пропустит игрока внутрь). Важно понимать отличие инфопорции от предмета. Инфопорция - это ''факт наличия'' пропуска, а лежащий в инвентаре пропуск - ''материальный предмет''. Можно, кстати, обойтись и без инфопорций, впоследствии пользуясь скриптами, проверяющими инвентарь игрока и ищущими нужный предмет, но этот способ сложен и нам пока не понадобится.

* 2. Это скрипт, выдающий игроку предмет "пропуск" в инвентарь. Ссылка на скрипты дается в формате имя_файла.имя_функции.

Как видите, фраза, в которой некий NPC выдает игроку пропуск, позволяющий пройти дальше, достаточно сложна.

Вот еще один пример (здесь она принадлежит игроку):

<xml>
<phrase id="4">
<has_info>propusk_given</has_info> -- проверка на наличие инфопорции propusk_given
<text>Да, пропуск у меня есть.</text>
<action>dialogs.break_dialog</action> -- ссылка на скрипт, завершающий диалог
</phrase>
</xml>

Здесь у нас фраза из диалога игрока с NPC - та, что после вопроса NPC "А пропуск у тебя есть?". Это один из вариантов ответа на неё. Особенность в том, что этот вариант не появится, если пропуска у вас на самом деле нет - она появляется только при наличии нужной инфопорции (за это отвечает строка с <has_info>).

Далее, поподробнее остановимся на задании условий появления фразы. 
Способов это сделать - два.

* проверка на наличие инфопорций
* проверка через скриптовую функцию

Первый метод мы видели выше, а второй - гораздо более комплексный и многофункциональный. Он запускает скрипт, который проводит проверку определенных вещей, и возвращает true/false. Простой пример - NPC требует денег (скажем, 5000 рублей), а нам нужно, чтобы ответная фраза игрока "Вот, держи свои 5000.", могла быть доступна для выбора, только если у нас действительно есть эти деньги. Для этого пишем такую фразу:

<xml>
<phrase id="8">
<text>Вот, держи, ровно 5000.</text>
<precondition>dialogs.actor_have_5000</precondition> -- вызываем условие (см. объяснение №1 ниже)
<action>dialogs.transfer_5000</action> -- передача денег скриптом (см. объяснение №2 ниже)
<next>9</next>
</phrase>
</xml>

* 1. Этот скрипт который проверяет наличие денег: если было возвращено true, то фраза доступна.
* 2. Вызываем другой скрипт, действие - он осуществляет саму передачу денег.

Да, кстати, порядок расстановки тегов внутри фразы не играет никакой роли - они все выполняются одновременно. Единственное - <next> всегда последний. Еще одно - есть второй вид проверки на инфопорцию - он наоборот, проверяет её отсутствие. Применяется точно так же, но называется не has_info, а dont_has_info.

Итак, что у нас есть:

* '''<phrase id="..."></phrase>''' - общий тег фразы, задание номера фразы
* '''<text>...</text>''' - тег, содержащий текст фразы
* '''<give_info>...</give_info>''' - выдача инфопорции с именем, записанным в теге
* '''<has_info>...</has_info>''' - проверка на наличие инфопорции с именем, записанным в теге
* '''<dont_has_info>...</dont_has_info>''' - проверка на отсутствие инфопорции с именем, записанным в теге
* '''<precondition>...</precondition>''' - запуск скрипта, возвращающего true или false в зависимости от чего-либо (скриптовая проверка)
* '''<action>...</action>''' - запуск скрипта
* '''<next>...</next>''' - тег ссылки на следующую фразу

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

Номер фразы: '''12''' Текст: ''Да, там сейчас база военных. Я не в курсе, сколько их там точно, но могу сказать, не меньше, чем один два отряда.'' Выдать инфопорцию: '''info_about_military_base''' Проверить наличие инфопорции: '''info_1''' Проверить отсутствие инфопорции: '''нет''' Проверить через скрипт: '''dialogs.is_npc_a_friend''' Совершить действие: '''dialogs.break_dialog''' Номера следующих фраз: '''13''' 

Нам нужна вот такая запись:

<xml>
<phrase id="12">
<has_info>info_1</has_info>
<text>Да, там сейчас база военных. Я не в курсе, сколько их там точно [...]</text>
<precondition>dialogs.is_npc_a_friend</precondition>
<action>dialogs.break_dialog</action>
<give_info>info_about_military_base</give_info>
<next>13</next>
</phrase>
</xml>

===Текстовые (строковые) массивы===

Мы упустили один важный нюанс, критичный для крупных диалогов.

<code>
<phrase id="54">
<text>Здравствуй, сталкер. Чем я могу помочь тебе?</text>
<next>55</next>
</phrase>
</code>

Мы записывали текст фразы в <'''text>...</text>'''. Это, безусловно, удобно, но на самом деле - может привести к проблемам. Дело в том, что таким образом можно использовать только короткие фразы. Стоит ввести в тег длинный текст, и игра... так сказать, не переварит наш диалог.

Поэтому нужно использовать не тексты, а ссылки на них. Работает это так:

[[Изображение:Text massive explain.jpg]]

То есть фразу мы записываем так:

<code>
<phrase id="54">
<text>my_text_1</text>
<next>55</next>
</phrase>
</code>

А в игре видим нормальный текст - игра по названию my_text_1 находит его в массиве. 
Массивы (для русскоязычной версии игры) находятся в папке:

<pre>S.T.A.L.K.E.R\gamedata\config\text\rus</pre>

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

Запись текста происходит в такой форме:

<code>
<string id="my_text_1"> -- в заголовке указывается имя текста, которое вызывается из диалога
<text>Здравствуй, сталкер. Чем я могу помочь тебе?</text> -- собственно, сам текст
</string>
</code>

===Диалоги===

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

Откроем папку:

<pre>S.T.A.L.K.E.R\gamedata\config\gameplay</pre>

Сейчас нас интересует файл '''character_desc_escape.xml''', хранящий профили персонажей с локации "Кордон" (остальные файлы названы по аналогичной системе - вместо '''escape''', соответственно, идет название других уровней). Открываем его и видим профиль Сидоровича '''escape_trader''' - он находится в самом начале файла.

<code>
<specific_character id="escape_trader" no_random = "1">
<name>escape_trader_name</name>
<icon>ui_npc_u_trader</icon>
<bio>escape_trader_bio</bio>

<class>trader</class>
<community>trader</community>
<visual>actors\trader\trader</visual>

<rank>330</rank>
<reputation>23</reputation>
<money min="100000" max="100000" infinitive="1"/>
<supplies>
[spawn] \n
wpn_knife \n
</supplies>

<start_dialog>escape_trader_start_dialog</start_dialog>
<actor_dialog>escape_trader_talk_info</actor_dialog>
<actor_dialog>escape_trader_jobs</actor_dialog>
<actor_dialog>tm_trader_dialog</actor_dialog>
<actor_dialog>tm_trader_reward</actor_dialog>
<actor_dialog>escape_trader_done_blockpost_box</actor_dialog>
</specific_character>
</code>

Подробный разбор параметров профиля мы делать не будем - для этого существует [[Редактирование_NPC|отдельная статья]]. Сейчас нас интересуют теги <actor_dialog>...</actor_dialog>, ссылающиеся на доступные у этого NPC диалоги. Добавим в этот список и ссылку на наш будущий диалог:

<code>
<start_dialog>escape_trader_start_dialog</start_dialog>
<actor_dialog>my_dialog_1</actor_dialog>
<actor_dialog>escape_trader_talk_info</actor_dialog>
<actor_dialog>escape_trader_jobs</actor_dialog>
<actor_dialog>tm_trader_dialog</actor_dialog>
<actor_dialog>tm_trader_reward</actor_dialog>
<actor_dialog>escape_trader_done_blockpost_box</actor_dialog>
</code>

Далее добавим в любой диалоговый файл, например, в '''dialogs_escape.xml''', следующий диалог:

<code>
<dialog id="my_dialog_1">
<precondition>my_script_for_dialogs.my_function_1</precondition> -- условия можно вызывать и здесь
<phrase_list>
<phrase id="0"> -- фразы Меченого
<text>my_text_0</text> -- "Ага, вот эти ребята..."
<next>1</next>
</phrase>
<phrase id="1"> -- фразы Сидоровича
<text>my_text_1</text> -- "Ненене!!! Нет, Меченый, нет!"
<next>2</next>
</phrase>
<phrase id="2">
<text>my_text_2</text> -- "Я делаю особую, уличную магию. Кто хочет увидеть немного магии?"
<next>3</next>
</phrase>
<phrase id="3">
<text>my_text_3</text> -- "Что я тебе, Толик какой-нибудь? Целый день у этих идиотов из лагеря
<next>4</next> разный хлам скупал, устал, хочу просто отдохнуть..."
</phrase>
<phrase id="4">
<text>my_text_4</text> -- "И что купил?"
<next>5</next>
</phrase>
<phrase id="5">
<text>my_text_5</text> -- "Я купил зеленый свитер, если ты так хочешь знать! Сорок долларов,
<next>6</next> между прочим."
</phrase>
<phrase id="6">
<text>my_text_6</text> -- "Зеленый свитер? А ты уверен, что не купил тедди-бир?"
<next>7</next>
</phrase>
<phrase id="7">
<text>my_text_7</text> -- "Тедди-бир?... ТЕДДИ-БИР!!! Где мой зеленый свитер, ты что делаешь, демон?!"
<next>8</next>
</phrase>
<phrase id="8">
<text>my_text_8</text> -- "Ладно, ладно... еще один фокус. Будь добр, взгляни на телевизор
<next>9</next> рядом с тобой. Что он показывает?"
</phrase>
<phrase id="9">
<text>my_text_9</text> -- "Билд 1154!!! Ты что делаешь, демон, ты что делаешь?! Проваливай отсюда!"
<next>10</next>
</phrase>
<phrase id="10">
<text>my_text_10</text> -- "Ладно."
<action>dialogs.break_dialog</action> -- выход из диалога
</phrase>
</phrase_list>
</dialog>
</code>

Для начала лучше попробовать свои силы в простом линейном диалоге вроде этого. 
Да, и не забудьте добавить строки с текстовыми фразами в массив. 
* Если вам неясно, что за ахинея написана в текстах, вам [http://ru.youtube.com/watch?v=CdTIQ6BVlvw&feature=related сюда] xD

===Дополнительные сведения по диалогам===

===Скрипт-генерируемые диалоги===

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

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

2008-08-10T15:50:56Z

89.178.50.109: /* Траспорт */

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

Поизучав мод от камрада 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_cheat()
elseif dik == DIK_keys.DIK_F1 then
self:OnButton_cheat()
end
</code>То есть при нажатии на '''S''' будет вызывать спавн меню, на '''Q''' - мгновенный выход из игры, ну а '''F1''' запустит функцию ''OnButton_cheat()''.
То есть, вот один из вариантов запуска, привязка к горячей клавише. Но еще нет самой ф-ии, поэтому допишем в конец файла:
<code lua>function main_menu:OnButton_cheat()
-- если еще ни разу не вызывали, то обозначим наш новый скрипт
if self.cheat_dlg == nil then
self.cheat_dlg = ui_cheat.cheat()
self.cheat_dlg.owner = self
end
-- останавливаем родительский элемент, запускаем свой, но родителя показываем.
self:GetHolder():start_stop_menu(self.cheat_dlg, true)
self:GetHolder():start_stop_menu(self, true)
self:Show(true)
end</code>
Запуск по кнопке уже есть, но нет возврата обратно. Исправим это, вернемся к файлу '''ui_cheat.script''' и сделаем там обработчик нажатий клавиш. В конец файла допишем:
<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()
-- на выход повесим Esc
if dik == DIK_keys.DIK_ESCAPE then
-- тут ничего не делаем
end
end
return true
end
</code>
Теперь надо проверить работоспособность. Запускаем игру, в главном меню жмем '''F1''', анимация должна тормознуть, мышь бегать. Если произошел вылет - открываем блокнот и вставляем из буфера предсмертное послание игры. (Надеюсь, все помнят, что при ошибке и краше в буфере остается лог ошибки?) Если вылета нет, то нажимаем '''Esc''' и возвращаемся в меню. Такую же проверку желательно провести и в самой игре. Визуально должен пропасть HUD, но должна остаться картинка. Можно снимать скриншоты :)

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

Теперь наша задача в том, чтобы в обработчик нажатий клавиш внести новые ф-ии. Начнем, например, со спавна предметов. Посмотрим, как спавнятся квестовые монстры и вещи и сделаем также (добаляем в конец '''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)
[[Категория:Скрипты]]

Maya. Глава 1: Hello World или первый кубик.

2008-08-10T15:50:01Z

89.178.50.109:

{{TOCright}}Естественно, первый раз взявшись за пакет, охото проверить его на работоспособность и получить первое представление о том, как происходит процесс создания объектов. Собственно для этого мы и создадим первую комнату с четырьмя стенами и полом. В данной главе не будут рассматриваться подробности процесса создания моделей, как я уже сказал, она для того, чтобы получить общее впечатление о том, с чем придётся иметь дело.

Если по ходу чтения статьи возникли вопросы или предложения, задать их можно на [[Обсуждение:Maya. Глава 1: Hello World или первый кубик.|страничке обсуждения этой статьи]].

== Шаг 1. Настраиваем плагины. ==

Важный шаг, но его рассписывать пока не буду, так как он описан в [http://sdk.stalker-game.com/ru/index.php/Docs:%D0%9D%D0%B0%D1%87%D0%B0%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5_%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8 официальном руководстве]. Дополнительная информация к официальной справке есть на этом сайте в статье [[Создание уровня, пошаговое руководство#Установка и настройка плагина|создание уровня, пошаговое руководство]]

== Шаг 2. Настраиваем сцену. ==

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

=== Единицы измерения ===

1. Открываем диалог настроек '''Window -> Settings/Preferences -> Preferences'''

[[Изображение:Maya tutor 001.jpg|center|250px|thumb|Рисунок 1. Открываем диалог редактирования настроек программы.]]

2. В открывшемся диалоге, в списке '''Categories''' выбираем пункт '''Settings'''

3. Изменяем параметр '''Linear''' на '''meter'''

[[Изображение:Maya tutor 002.jpg|center|500px|thumb|Рисунок 2. Меняем еденицы измерения на метры.]]

4. Нажимаем '''Save'''.

=== Настройка меню ===

Так как работать нам придётся с полигонами, то имеет смысл перевести меню в режим работы с полигонами. Делается это следующим образом: в том же окне редактирования настроек, что и
в предыдущем пункте, только в категории '''Interface''', опцию '''MenuSet''' изменяем на '''Polygons''' и нажимаем '''Save'''.

[[Изображение:Maya tutor 010.jpg|center|500px|thumb|Рисунок 3. Настройка меню для работы с полигонами.]]

=== Настройка камеры ===

Раз единицы измерения увеличились в 100 раз, то и дальность отображения камеры необходимо увеличить в 100 раз

Для этого в меню камеры выбираем '''View -> Camera Attribute Editor''' в открывшемся диалоге изменяем параметры:

* Near Clip Plane на 0.1 (!!! Внимание: десятичная дробная часть числа отделяется точкой, а не запятой)
* Far Clip Plane на 1000

[[Изображение:Maya tutor 003.jpg|center|500px|thumb|Рисунок 4. Настройка дальности видимости камеры.]]

Как вы, возможно, знаете, в игре есть два типа полигонов:

* односторонние — только одна сторона видимая, если посмотреть на этот полигон с обратной стороны, вы ничего не увидите.
* двусторонние — обе стороны видимы.

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

* Smooth Shade All
* Backface Culling

[[Изображение:Maya tutor 004.jpg|center|500px|thumb|Рисунок 5. Данные пункты необходимо отметить, чтобы не запутаться где лицевая, а где обратная сторона создаваемой модели.]]

== Шаг 3. Создаём кубик. ==

Ну вот, приступим:

1. Выбираем в меню '''Create -> Polygon Primitives -> Значок рядом с Cube'''. Выбираем именно значок рядом с Cube, как показано на скриншоте ниже, это открывает нам меню ручной настройки создаваемого примитива.

2. Для того, чтоб габариты созданного кубика были 5х5х5 м, в открывшемся окне параметры '''Width''' (ширина), '''Height''' (высота) и '''Depth''' (длина) устанавливаем на значение 5.

3. Кликаем в произвольном месте в окне камеры, желательно ближе к центру. В этом месте у нас появится кубик

[[Изображение:Maya tutor 005.jpg|center|500px|thumb|Рисунок 6. Ручная настройка габаритов кубика.]]

В результате, вы должны увидеть примерно следующее:

[[Изображение:Maya tutor 006.jpg|center|500px|thumb|Рисунок 7. Кубик 5х5х5 м.]]

Немножко отвлечёмся: как я раньше говорил, игра использует двусторонние и односторонние полигоны. В рассматриваемом сейчас примере мы будем использовать односторонние. Созданный кубик по умолчанию имеет полигоны видимые только снаружи. Для того чтобы нам поместить человека внутрь кубика необходимо вывернуть кубик наизнанку, то есть сделать так, чтобы видимые стороны полигонов, обращённые к игроку, были внутри кубика. Внимание, прежде чем продолжать удостоверьтесь ещё раз, что в тех настройках камеры, которые я описывал выше отмечена галочка на '''Backface Culling''' иначе для вас все полигоны будут отображаться как двусторонние.

Выворачиваем:

1. Выделяем кубик.

2. Выбираем в меню пункт '''Normals -> Reverse'''

[[Изображение:Maya tutor 008.jpg|center|500px|thumb|Рисунок 8. Данный пункт меню меняет лицевую и оборотную сторону полигона местами.]]

Должно получиться что-то наподобие этого:

[[Изображение:Maya tutor 009.jpg|center|500px|thumb|Рисунок 9. Теперь кубик вывернут наизнанку.]]

Всё, теперь нам, для получения желаемой модели кубика осталось только убрать у него верхнюю грань, для этого:

1. Кликаем на кубике правой кнопкой мыши, раскроется меню, в нём выбираем пункт '''Face''', теперь мы получаем возможность манипулировать гранями кубика:

[[Изображение:Maya tutor 007.jpg|center|500px|thumb|Рисунок 10. Переходим в режим редактирования Faces.]]

2. Кликаем по центру верхнего полигона, который теперь выделен синимквадратиком. Выделенный полигон кубика должен подсветиться.

3. Нажимаем на Delete на клавиатуре.

[[Изображение:Maya_tutor_011.png|center|530px|thumb|Рисунок 11. Удаляем верх у кубика.]]

Всё, желаемая модель получена, теперь время перейти к следующему этапу моделирования.

== Шаг 4. Текстурирование. ==

Для того, чтобы не усложнять пример, этот шаг пока мы пропустим.

== Шаг 5. Экспорт сцены из Maya. ==

Для экспорта:

1. Нажмите в меню '''File -> Export All...'''

[[Изображение:Maya_tutor_012.jpg|center|150px|thumb|Рисунок 12. File -> Export All....]]

2. Сохраняем файл в директорию '''X:\import\''' под именем '''mp_cube''' (Х - это диск который создаётся .bat файлом идущим в комплекте с SDK, если он у вас не создан, тогда зайдите в меню пуск и в меню программ запустите следующий файл: '''X-Ray SDK \ Map X-Drive''')

[[Изображение:Maya_tutor_013.jpg|center|300px|thumb|Рисунок 13. Экспортируем в mp_cube.]]

== Шаг 6. Импорт объекта в LevelEditor и настройка сцены ==

=== Импорт и настройка свойств объекта ===

Экспорт объектов хорошо рассмотрен в официальной справке, но на всякий случай я дам порядок выполнения операций с краткими комментариями.

1. Выбираем в меню пункт '''Object -> Object Lybrary'''.

2. Создаём папку для объектов нашего уровня, я назвал её ''mp_test_cube'' (можно сделать с помощью правой кнопки мыщи, в раскрывшемся меню выбрать '''Create Folder''').

3. Выбираем нашу папку и жмём '''Import Object''', выбираем сохранённый нами файл '''X:\import\mp_cube'''. Импортированный файл должен появиться в библиотеке объектов.

4. Выбираем в библиотеке импортированный нами объект и жмём '''Properties'''.

5. Откроется меню свойств объекта, там нас интересует пункт '''Texture''', жмём на троеточие рядом с этим пунктом (см. скриншот ниже). Откроется меню выбора текстур, выбираем любую понравившуюся и жмём ОК.

6. Сохраняем изменения в библиотеке объектов.

[[Изображение:Maya_tutor_016.jpg|center|650px|thumb|Рисунок 14. Назначаем текстуру нашему объекту.]]

=== Добавляем объект в уровень ===

1. Жмём '''Multiple Append'''.

2. В открывшемся окне ставим галочку на нашем объекте.

3. Жмём ОК, наш объект должен появиться в создаваемом нами уровне.

[[Изображение:Maya_tutor_018.jpg|center|400px|thumb|Рисунок 15. Добавляем объект в уровень.]]

=== Добавляем необходимые объекты ===

Для того чтобы запустить уровень нам необходимо добавить следующие 3 объекта:
# Респаун игрока ('''$rpoint''')
# Объект '''Light'''
# Объект '''Glow'''

И так добавляем:
# Респаун:[[Изображение:Maya_tutor_019.jpg|center|500px|thumb|Рисунок 16. Добавляем респаун игрока.]]
# Light:[[Изображение:Maya_tutor_021.jpg|center|500px|thumb|Рисунок 17. Добавляем Light.]]
# Glow:[[Изображение:Maya_tutor_020.jpg|center|500px|thumb|Рисунок 18. Добавляем Glow.]]

=== Настраиваем сцену ===

# Заходим в меню '''Scene -> Options'''
# Правим параметры отмеченные на скриншоте:[[Изображение:Maya_tutor_022.jpg|center|500px|thumb|Рисунок 19. Настраиваем сцену.]]
# Теперь сохраняем сцену как '''mp_test_cube'''
# Всё жмём '''Compile -> Build''', после того как билд закончится закрываем едитор и приступаем к следующему шагу

== Шаг 7. Компиляция ==

1. Заходим в меню '''Пуск -> Выполнить'''
2. Набираем X:\xrLC.bat mp_test_cube [[Изображение:Maya_tutor_023.jpg|347px|center|thumb|Рисунок 20. Запускаем компиляцию.]]
3. По окончании компиляции нажмите ОК. [[Изображение:Maya_tutor_024.jpg|500px|center|thumb|Рисунок 21. Компиляция окончена.]]

Добавил Haron 04.02.2008 01:11
ПРИМЕЧАНИЕ!

Есть такое число, - ограничение на количество полигонов в отдельном объекте на карте, это ~150000. На самом деле, это число на порядок ниже. Экспериментально установлено, что если количество полигонов в каком-либо объекте на карте превышает ~ 80000 - 90000, компилятор уровня (xrLC.exe) при компиляции, - тупо слетает на фазе Build UW Mapping.

== Шаг 8. Запускаем уровень ==

Для запуска нам необходимо:
# Скопировать следующие файлы:
## Файл '''level_editor\gamedata\config\mp\map_list.ltx''' в папку '''S.T.A.L.K.E.R\gamedata\config\mp\'''
## Содержимое папки '''level_editor\gamedata\levels\mp_test_cube\''' в папку '''S.T.A.L.K.E.R\gamedata\levels\mp_test_cube\'''
# Добавить в список карт '''S.T.A.L.K.E.R\gamedata\config\mp\map_list.ltx''' (файл можно открыть обычным блокнотом) нашу карту [[Изображение:Maya_tutor_015.jpg|250px|center|thumb|Рисунок 22. Добавляем нашу карту в список доступных.]]

Всё карту можно пробовать:

<center>
{|
|-
|[[Изображение:Maya_tutor1_screen1.jpg|center|250px|thumb|Скрин 1.]]||[[Изображение:Maya_tutor1_screen2.jpg|center|250px|thumb|Скрин 2.]]
|}
</center>

Перенёс твой вопрос на страничку обсуждения стаьи (см выше)

== Полезные ссылки ==

# [http://sdk.stalker-game.com/ru/index.php/MOD-%D0%BF%D0%BE%D1%80%D1%82%D0%B0%D0%BB_S.T.A.L.K.E.R.:_Shadow_of_Chernobyl MOD-портал S.T.A.L.K.E.R.: Shadow of Chernobyl]
# [http://usa.autodesk.com/adsk/servlet/index?siteID=123112&id=8782084 Офицальный хэлп Maya]
# [[Создание уровня, пошаговое руководство]]

[[Категория:SDK]]

Maya. Глава 3: Полезные советы, которые трудно привязать к урокам.

2008-08-10T15:49:38Z

89.178.50.109:

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

== Считаем полигоны ==

Все мы помним что весь уровень должен быть не больше 150 тысяч треугольников, и чтоб не проворонить это магическое число, отметьте галочкой в меню следующий пункт: '''Display -> Heads Up Display -> Poly Count'''

В результате вы увидете детальную статистику по вашей сцене (первая колонка статистика - на всей сцене, вторая - в текущем окне, третья - по выделенным объектам), треугольники - '''Tris''': [[Изображение:Maya_tutor3_1.jpg|400px|center|thumb|Рисунок 1. Статистика сцены.]]

[[Категория:SDK]][[Категория:Незаконченные статьи]]

Maya. Глава 2: Необходимые основы моделирования или проламываем стенку.

2008-08-10T15:49:21Z

89.178.50.109:

{{TOCright}}В этой статье я опишу как быстро (у меня создание этой сцены, вместе с рисованием текстуры заняло меньше 10 минут) сцену дома с проломом в стене, выглядящую примерно следующим образом: [[Изображение:Maya_tutor2_1.jpg|350px|center|thumb|Рисунок 1. Так будет выглядеть созданная нами сцена.]]

== Шаг 1. Настраиваем сцену. ==

О [[Maya. Глава 1: Hello World или первый кубик.#Шаг 2. Настраиваем сцену.|настройках котрые я упоминал в предидущей главе]] повторяться не буду, сразу перейду к тем, котрые мы ещё не рассматривали.

Для удобства работы настроим сетку и привязку к ней:

=== Настраиваем сетку ===

Включить сетку можно поставив галочку в меню '''Display -> Grid'''
[[Изображение:Maya_tutor2_3.jpg|180px|center|thumb|Рисунок 2. Включаем сетку.]]

В том же меню, нажав на расширенные настройки мы можем настроить её:[[Изображение:Maya_tutor2_4.jpg|174px|center|thumb|Рисунок 3. Заходим в настройку.]]

Я, для удобства, сделал это следующим образом:[[Изображение:Maya_tutor2_2.jpg|400px|center|thumb|Рисунок 4. Настраиваем сетку.]]

=== Включаем привязку к сетке ===

Для того, чтобы включить привязку к сетке нужно нажать на следующий значок, на понели инструментов:[[Изображение:Maya_tutor_014.jpg|145px|center|thumb|Рисунок 5. Включаем привязку.]]

== Шаг 2. Моделируем сцену ==

=== Создаём полигон ===

# Создаём объект '''Plane''' (меню '''Create -> Polygon Primitives -> Кубик рядом с Plane'''), с параметрами:
#* '''Width''': 8
#* '''Height''': 8[[Изображение:Maya_tutor2_5.jpg|250px|center|thumb|Рисунок 6. Создаём объект Plane.]]
# Помещаем объект на сцену
# Теперь нам необходимо изменить координаты центра объекта на (0,0,0), для этого в '''Channel Box''' установите (не снимая выделения с объекта) значения свойств '''Translate X,Y,Z''' в 0. Как попасть в Channel Box изображено на рисунке ниже[[Изображение:Maya_tutor2_6.jpg|200px|center|thumb|Рисунок 7. Устанавливаем объект в положение (0,0,0).]]

Всё площадка готова к тому, чтобы мы её превратили в желаемый объект. Но сначала немного теории:

=== Немножко теории ===

# Теоретически можно выделить три метода построения полигональных моделей, которые могут применяться как в чистом виде, так и в разнообразных комбинациях. Модель может строиться:
#* вытягиванием из одного-единственного исходного полигона, при этом каждый новый полигон вытягивается из предыдущего и, в ряде случаев, сваривается с каким-то соседним полигоном через вершины;
#* на основе полигональных примитивов, когда берется примитив (куб, сфера и т.п.), а затем из него вытягиваются те или иные подобъекты и при необходимости делятся отдельные грани. Данный метод пользуется наибольшей популярностью;
#* модель создается с нуля, а входящие в нее полигоны не вытягиваются, а рисуются вручную.
#Для создания и редактирования полигональных моделей предназначены командные меню '''Polygons''' и '''Edit Polygons''', содержащие очень большое количество команд. Однако самыми важными в полигональном моделировании являются команды:
#* '''Split Polygon Tool''' (Разбить полигон) из меню '''Edit Polygons''' — приводит к разбиению каждой грани на несколько новых граней, что реализуется путем создания новых ребер;
#* '''Extrude Face/Extrude Edge/Extrude Vertex''' (Выдавить грань/Выдавить ребро/Выдавить вершину) из меню '''Edit Polygons''' — обеспечивает перемещение выделенных граней, ребер и вершин и изменение в итоге формы модели;
#* '''Smooth''' (Сгладить) из меню '''Polygons''' — увеличивает детализацию объекта благодаря переразбиению на большее число граней; может выполняться как для всего объекта в целом, так и для его отдельных подобъектов.
#Чтобы результат моделирования оказался удачным, стоит придерживаться следующих правил:
#* многие модели симметричны, поэтому, как правило, создается лишь одна их половина, а затем генерируется ее зеркальная копия (команда '''Polygons -> Mirror Geometry''' — Полигоны -> Зеркальная геометрия), по окончании обе половинки модели сшиваются, например путем булева объединения, а затем полученная модель сглаживается;
#* модели не должны иметь в своем составе лишних подобъектов, которые не нужны для формирования задуманной поверхности, — это лишь усложняет модель и может стать причиной неправильного выполнения тех или иных операций. Поэтому от лишних подобъектов нужно сразу же избавляться — например для уничтожения лишних вершин достаточно переключиться в режим редактирования вершин и удалить ненужные;
#* нередко воспользоваться нужным инструментом не получается, например при попытке создания новой грани не удается провести новое ребро от ребра A к ребру B. Причиной возникновения таких ситуаций является невозможность выполнения операции в данном конкретном случае, так как происходит нарушение существующей полигональной системы плоскостей. Можно попытаться провести ту же операцию, но в обратном порядке, то есть соединить ребро B с ребром A, иначе придется придумывать какое-то иное решение;
#* операция сглаживания ('''Smooth''') существенно увеличивает количество полигонов модели, поэтому не стоит злоупотреблять ею — в противном случае модель может стать слишком сложной: из-за большого числа полигонов с ней трудно будет работать, время визуализации сильно вырастет, а недостаточно мощный компьютер может при ее обработке зависать.

=== Обрабатываем полигон ===

И так, тяжело в учении легко в бою, приступим.
# Включаем вид сверху, для этого на компасе нажимаем на указатель с надписью Y: [[Изображение:Maya_tutor2_7.jpg|71px|center|thumb|Рисунок 7. Переключаемся на вид сверху.]]
# В меню выбираем настройки инструмента '''Split Polygon Tool (разделение полигона)''' ('''Edit Mesh -> Квадратик рядом с Split Polygon Tool'''), для того чтобы включить привязку у этого инструмента к сетке, настраиваем как у меня: [[Изображение:Maya_tutor2_8.jpg|250px|center|thumb|Рисунок 8. Включаем привязку к сетке у инструмента Split Polygon Tool.]]
# Теперь для того, чтобы поделить наш полигон на две части нам нужно кликнуть на теместа края полигона, где будет начинаться и заканчиваться разделительная линия. Затем нажать '''Enter''': [[Изображение:Maya_tutor2_9.jpg|250px|center|thumb|Рисунок 9. Режим наш полигон.]]
# Такимже образом нарезаем наш полигон в следующую заготовку: [[Изображение:Maya_tutor2_10.jpg|350px|center|thumb|Рисунок 10. Готовая заготовка.]]

=== Вытягиваем стены из полигона ===

Всё теперь вид переключаем на перспективу (жмём кубик на компасе) и переключаемся в режим редактирования фэйсов (для тех, кто забыл первый урок: жмём правой кнопкой на объекте в раскрывшемся списке выбираем '''Face''').
# Выделям фэйсы как у меня: [[Изображение:Maya_tutor2_11.jpg|250px|center|thumb|Рисунок 11. Выделяем вытягиваемые полигоны.]]
# Жмём в меню '''Edit Mesh -> Extrude (вытягивание)''' (не снимая выделения с фэйсов)
# Открываем '''Attribute Editor'''
# Указываем в параметре '''Translate (Y)''' значение '''2''', это должно вытянуть выделенные нами полигоны на 2 метра вверх: [[Изображение:Maya_tutor2_12.jpg|600px|center|thumb|Рисунок 12. Вытягиваем стены из полигона.]]

Всё, стены для того чтобы их проламывать готовы.

=== Делаем пробоину ===

''В процессе, пишу..''

[[Категория:SDK]][[Категория:Незаконченные статьи]]

Maya. Глава 2: Необходимые основы моделирования или проламываем стенку.

2008-08-10T15:48:26Z

89.178.50.109:

3dsmax. Создание текстуры террейна и прочих

2008-08-10T11:00:25Z

89.178.50.109:

{{TOCright}}
==ВВЕДЕНИЕ==

Статья рассчитана на достаточно опытных юзеров '''3Ds Max'''. С вопросами типа "как создать кубик" и иже с ними - идём сюда ([http://www.3domen.com www.3domen.com]) и учимся работать.

Рассмотрим способ создания текстуры террейна, при этом она будет на 100 % отвечать следующим требованиям:
<code>- Готова для использования в качестве, собственно основной текстуры террейна
- Пригодна в качестве базовой текстуры для генерации детальных объектов (Добавляем траву на уровень)
- Пригодна для генерации маски. Маска необходима для корректного рапределения шейдеров по ландшафту.</code>

==СОЗДАНИЕ ТЕКСТУРЫ==

Нам понадобятся:
<code>Autodesk 3DsMax
Adobe Photoshop
Две специальных текстуры: "Трава" и "Асфальт".</code>

[http://www.lproject.3dn.ru/tutorials/Soft/Textures.7z СКАЧАТЬ ТЕКСТУРЫ]

Итак: Допустим у нас имеется готовый террейн. На нём смоделена дорога. Как его затекстурить:
Идём в '''Material Editor''' и делаем два "'''Standart'''" материала, обзываем их как хотим, например '''Grass''' и '''Asphalt'''.

[[Изображение:Landshaft 1.JPG]]

[[Изображение:Landshaft 2.JPG]]

Полученными материалами мы будем затекстуривать наш террейн. Настоятельно рекомендуется предварительно отделить всё, что относится к асфальту или земле от общего меша, для экспорта в СДК - это суровая необходимость, да и текстурить будет проще.
Итак: Материал "'''Asphalt'''" накладываем на всё, что относится к асфальту. Аналогично поступаем с материалом '''Grass''' и с землёй. В результате должно получиться вот это:

[[Изображение:Landshaft 3.JPG]]

Аттачим все объекты, и сверху всё это дело "прессуем" модификатором '''Unwrap UWV''' :). С свитке модификатора переходим в режим Face и выделяем ВСЕ фейсы модели. Ниже в настройках модификатора ищем кнопку '''Planar Mapping''', нажимаем, и жмём кнопку рядом - '''Align Z Axis'''. Отжимаем кнопку '''Planar Mapping''', и конвертируем в '''Edit Poly'''.

[[Изображение:Landshaft 4.JPG]]

Любуемся полученной идеалистической и профессиональной картинкой :)

[[Изображение:Landshaft 5.JPG]]

А вот теперь - начинается самое интересное. Генерация текстуры.
Открываем окно '''Rendering in Texture''' (Вызывается нажатием "0" (ноль) на клаве), и настраиваем параметры рендеринга следующим образом:

[[Изображение:Landshaft 6.JPG]]

[[Изображение:Landshaft 7.JPG]]

[[Изображение:Landshaft 8.JPG]]

Рендерим! На выходе, в указанной папке - появится текстура в формате '''TGA'''. Текстуру уже можно экспортить в '''X-Ray SDK''', предварительно убив альфа-канал в фотошопе и дав нормальное имя (terrain_МОЯКАРТА.tga)

==НАЗНАЧЕНИЕ ГОТОВОЙ ТЕКСТУРЫ НА ТЕРРЕЙН==

Итак, после экспорта в '''SDK''' у нас в папке .'''..SDK\gamedata\textures\terrain\''' появится аналог нашей текстурки в формате '''DDS'''. Вот её и заюзаем для этого. Создаём на базе данной текстуры ещё два одинаковых материала, обозвав их '''terrain_aspalt''' и '''terrain_grass'''. Убиваем на нашем террейне вспомогательные материалы. Сделать это можно, воспользовавшись утилитой '''UWV Remove''' (Найти её можно на вкладке '''Utilites''' правого тулбара '''3DsMax'''). Выделив объекты террейна - запускаем утилиту и жмём кнопку '''Clear >> Materials''' (НЕ UWV!!!!). Теперь назначаем террейну - новые материалы. На асфальт - '''terrain_asphalt'''... и так-же с землёй и '''terrain_grass'''. Теперь можете аттачить асфальт и землю в один меш, и спокойно экспортить в СДК. После экспорта объекта - не забываем прописать нашу текстуру в файле '''textures.ltx'''
Прописываем её так:

<code>
terrain\terrain_НАШАКАРТА = detail\detail_grnd_grass, **.000000, usage[diffuse]
</code>

Вместо '''**''' - указываем уровень детализации (ориентировочно от 40 до 90) От него зависит детальность шейдера поверхности террейна. Чем выше число - тем выше детальность. Я ставлю где-то 65-80. Прописать необходимо в ''НУЖНОЕ'' место файла '''textures.ltx''', для этого юзаем "поиск" в редакторе, и ищем где прописаны остальные "террейны".

==СОЗДАНИЕ ДЕТАЛЬНОЙ ТЕКСТУРЫ==

Юзаем фотошоп для этого. Открываем TGA-вариант текстуры, и заливаем "асфальт" жёлтым цветом
'''(R:G:B индекс - 240:240:1)'''. Это "Штатный" СДК-шный цветоиндекс, ему соотвествуют "листья на асфальте".

{{Message_box|
id =pseudoscience|
align = left|
backgroundcolor = #f9f9f9|
image =Lamp.gif|
heading = Важный момент -- Haron|
message = Не меняйте стандартные цвета В DTI-ФАЙЛЕ! УБЪЁТЕ ВСЁ И НАСМЕРТЬ. Дело в том, что для текстур террейна используется тот же набор цветов что и в DTI-файле.
}}
 
Теперь подбираем интенсивность альфа-канала текстуры в нужных местах. ''(100%-альфа - травы НЕ будет! Без альфы - всё заросшее)''. Сохраняем в TGA, обозвав '''terrain_МОЯКАРТА_det.TGA''' и экспортим в СДК. Получившуюся текстуру в '''DDS''' формате юзаем на детальные объекты.

==СОЗДАНИЕ МАСКИ==

Юзаем фотошоп.

Вот таблица цветов под разные участки маски: Заливать - ими.
<code>
Асфальт: RGB - 0:252:0
Земля: RGB - 248:0:0
Овраги, вода RGB - 0:0:248
Под домами: Просто чёрный цвет
</code>

Сохраняем под именем '''terrain_МОЯКАРТА_mask.TGA''' И экспортим в СДК.

Вроде усё =)
Запарилсо =)

====Дополнение Сахарова====
Тайлинг детальных текстур, зависит в принципе "не от балды", а от размера карты(для кордона например 140, для мп атп 40 и т.п.)

и какбы надо написать что маска юзается только после финальной компиляции уровня на макс настройках.
QUOTE
Теперь назначаем террейну - новые материалы. На асфальт - terrain_asphalt... и так-же с землёй и terrain_grass. Теперь можете аттачить асфальт и землю в один меш, и спокойно экспортить в СДК. После экспорта объекта - не забываем прописать нашу текстуру в файле textures.ltx

Енжин шейдер только из папки levels, материалы какие угодно(хоть металл), на остальных маска не юзается(ибо нефик), в идеале нужно создать для своего уровня персональный шейдер с набором текстур для маски (всего 4 текстуры максимум, ибо ARGB.. +1 дитеил текстура, ака дитейл бамп(онли р2 рендер))
terrain_grass и т.п., это для всяких декораций на заднем плане(см, мп_атп и иже сними)

[[Категория: SDK]]

--[[Участник:Haron|Haron]] '''17:20, 13 июля 2008 (MSD)'''

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

2008-08-10T10:45:14Z

89.178.50.109:

В данной категории содержатся статьи, освещающие работу с конфигурационными файлами игры.

Основная статья [[Теория_модостроения|Теория модостроения]]
[[Категория:Руководства]]

Теория модостроения

2008-08-10T10:44:43Z

89.178.50.109:

==О модифицировании игры==

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

На фоне вырезанного контента и огромного количества несоответствий игры обещаниям разработчиков стали формироваться моддерские команды. К счастью, разработчики оставили возможность простого модифицирования игры. Благодаря [[Распаковщик архивов|распаковщику игровых архивов]] мы получили полный доступ к ресурсам игры. Сверх того, разработчики оставили в финальном билде 2947 (и билдах после него) высший приоритет распакованной папки gamedata.

Итак, что же мы имеем?

==Звуки==

Звуки в игре записаны в формате ogg. Хочу заметить, что OGG Vorbis является признанным игровым форматом звука.

Проблем со звуком вообщем-то не возникает. Если Вы пользуетесь редактором звука, который не поддерживает OGG Vorbis, для Вас существует множество платных и бесплатных конвертеров.

Видео в игре также в формат Vorbis, расширения видео файлов - OGM. Для просмотра видео рекомендую Media Player Classic и CCCP Codec Pack ([http://cccp-project.net/ сайт проекта]).

==Текстуры==

Текстуры в игре имеют формат DDS (Direct Draw Surface). Для их редактирования рекомендую Adobe Photoshop CS 8.0 и NVidia Developer's Photoshop DDS Plugins (скачать его можно [http://developer.nvidia.com/object/photoshop_dds_plugins.html здесь]).

При этом учтите следующее:

* Вы можете использовать сторонние конвертеры. К таким относится Lister Total Commander, который умеет сохранять и просматривать DDS текстуры в других форматах. Это расширенная сборка Total Commander'a (платный файловый менеджер Кристиана Гислера) версии 6.55. Приобрести его можно [http://www.ghisler.com/ здесь].

* Также, Вы можете воспользоваться специальными DDS конвертером. Но при конвертации может исчезнуть альфа-канал текстуры, он очень важен для игры. Поэтому настоятельно рекомендую использовать Photoshop CS 8.0 с плагинами.

Внимание! После работы в Photoshop над тестурами, при сохранении не забудьте отметить пункт "Alpha Channels" и в открывшемся окне (после нажатия на кнопку "Сохранить"), выберите режим "DXT5 ARGB 8 bpp | interpolated alpha".

Также, в папке с игрой есть дополнительные текстуры с приписанным в конце имени файла словом "bump". Это бамп-карты текстур, используемые для придания модели некоторой объемности, которую ещё называют "псевдорельефностью".

Бамп-карты текстур используются только при игре на втором рендере (динамическое освещение, то есть DirectX9-рендер.

==Модели==

Следующий немаловажный компонент игры - OGF модели.

Модели расположены в папке meshes.

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

Для просмотра моделей незаменимой утилитой является OGF Viewer ([http://www.g3ddev.com/ сайт]) от batya.
На данный момент возможен только просмотр и конвертирование моделей в формат obj.

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

==Уровни==

Следующим компонентом игры являются игровые уровни. Уровни можно разделить на мультиплеерные и сингловые.

MP-уровни отличаются от уровней одиночной игры отсутствием некоторых компонентов и несколько иной структурой/набором файлов. Например, на мультиплеерных уровнях отсутствует координатная сетка для A-Life.

Перед релизом бета-версии SDK (Software Development Kit от GSC Game World) я несколько недель тестировал его и сделал несколько печальных выводов.

Во-первых, при помощи MP-SDK невозможно не только редактировать, но и даже просматривать уже откомпилированные уровни.
Дело в том, что MP-SDK требует исходников уровней. К тому же, пора прекращать мечтать о SDK и выкрикивать: "Дайте мне СДК я вам новое оружие сделаю и движок поменяю!!!". MP-SDK - всего лишь маппер для мультиплеера. Возможно, будет маппер и для сингловой версии игры, но исходников уровней от GSC Game World даже и ждать не стоит.

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

Уровни из сингловой версии игры можно портировать под мультиплеер. Алгоритм действий:

* Скопировать содержание папки уровня в новую папку с именем типа mp_yantar.
* Удалить файлы level.game, level.ai, level.som. Скопировать level.game из любой мультиплеерной карты и вставить в переделываемую карту.
* Открыть конфигурационный файл config\mp\maplist.ltx и добавить карту в список.

==Скрипты==

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

В скриптах используется язык Lua. Язык не очень сложный, с помощью него можно многое делать, в том числе и спаунить (от англ. "spawn" - размещать на карте) объекты.

К тому же, скрипты можно вызывать в spawn-файле, о нём подробнее будет рассказано ниже.

==Конфиги==

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

В игре существуют конфигурационные файлы существ, мультиплеера, погоды, оружия, объектов, геймплея, моделей, конфигурационные скрипты и конфигурация интерфейса.

Также существует множество других конфигурационных файлов.

О некоторых из них подробнее.
Конфигурации существ - одним из самых важных конфигурационных файлов является actor.ltx. В нём заданы параметры актора - т.е. главного героя игры.

На его примере рассмотрим структуру конфигурационного файла.

[actor] - пример entity. Конфигурацию актора вызывают при помощи названия entity. В данном случае - actor.
В других конфигурационных файлах мы можем найти пример ссылки на entity. Например: [burer_arena]:m_burer_e.

В данном случае существо "burer_arena" ссылается на существо "m_burer_e" и является его прототипом.
Также могут быть и ссылки на entity, обозначающей набор параметров. Например: damage = m_burer_damage.

Комментарии в ltx файлах начинаются с символа ";". Все, что расположено за этим знаком, игрой не учитывается.

Также очень интересна система так называемых инклудов (включений).

Инклуд обозначается строкой "#include "имя_файла.ltx""

Инклуды означают, что в файл, в котором написана вышеуказанная строка, вставляется содержание файла, указанного как аргумент к функции #include.

Получается так, что конфигурационные файлы монстров (к примеру) объединяются в файле monsters.ltx, файлы сталкеров - в stalkers.ltx. А файлы monsters.ltx, stalkers.ltx и все остальные файлы объединяются в файле system.ltx, в котором прописано около 20 инклудов. Таким образом, всё содержание ltx-файлов объединено в system.ltx.

Помните - когда создаёте новый конфигурационный файл - не забудьте вставить его методом инклуда в общий конфигурационный список в system.ltx.

==Спавн-файл==

Последнее, о чём пойдёт речь - папка spawns.

В ней расположен файл all.spawn. В этом файле обозначены почти все динамические объекты, которые содержатся в игровой Зоне. Это как монстры и сталкеры, так и приёмник "Горизонт" на столе у торговца, и даже ящик рядом с блокпостом.

Формат спаун-файла долго разбирался специалистами и благодаря товарищу Zeed'у разобран. И им же была написана специальная программа [[xrSpawner]] для спауна динамических объектов.

==Дополнительно==

Кроме файлов спауна в директории gamedata также присутствует папка с шейдерами, папка с анимациями камеры, папка с некоторыми файлами A-life и несколько файлов в формате xr.

В файле gamemtl.xr лежат настройки материалов, текстур и hit_fx эффектов.
В режиме HEX файл более или менее читаем.

И последнее.
Не пробуйте искать где указаны классы типа AI_CROW.
Все классы существ находятся в xrGame.dll и попытки извлечь их или изменить бессмыслены.

==Авторы==

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

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

2008-08-10T10:44:18Z

89.178.50.109:

В данной категории содержатся статьи, освещающие работу со скриптами игры.

Основная статья [[Теория_модостроения|Теория модостроения]]
[[Категория:Руководства]]

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

2008-08-10T10:44:01Z

89.178.50.109:

В данной категории содержатся статьи, освещающие работу со скриптами игры.
Основная статья [[Теория_модостроения|Теория модостроения]]
[[Категория:Руководства]]

Создание партиклов

2008-08-10T10:41:34Z

89.178.50.109:

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

Запускаем Particle Editor и создаем в общей директории свою папку, в ней создаем новый партикл-эффект.

[[Изображение:Particle01.jpg|470px]]

Даем название своему партиклу и находим кнопку Append, в появившемся окне выбираем source - это база для любого партикла. Теперь настроим его. Находим пункт Color -> Alpha, назначаем текстуре прозрачность.

[[Изображение:Particle02.jpg|700px]]

Далее, нужно указать размер текстуры (Size -> Center). Теперь прокручиваем список вверх к пункту Max particles - задаём ограничение в 50 партиклов и спускаемся на строчку ниже к пункту Sprite - ставим напротив него галочку, появится 4 подпункта. Нас пока интересует первый пункт - Texture, выбираем текстуру для своего партикла.

[[Изображение:Particle03.jpg|700px]]

Также, выбираем шейдер. Теперь можно нажать F5 для запуска превью своего партикла.

[[Изображение:Particle04.jpg|700px]]

Далее, есть ещё одна обязательная вещь для нашего эффекта: нажимаем Append и выбираем Kill Old. Эта функция убирает старые партиклы. В настройках указываем время жизни (Age limit).

Если наш партикл задумывается движущимся, нужно также приаттачить ещё один итем - Move, этот итем базируется на параметре Velocity.

[[Изображение:Particle05.jpg|500px]]

Теперь настроим Domain - базовый параметр партикла.

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

Я выбрал диск. Снова жмём F5 для просмотра.

[[Изображение:Particle06.jpg|700px]]

Мы получили что то вроде огненного диска, который медленно поднимается вверх. Частота кадров указывается в пункте Source -> Rate (чем больше это значение, тем быстрей обновляются наши партиклы).

Ну теперь можно добавлять ещё разных итемов и смотреть на эффект.

Копируем фаил particles.xr в геймдату игровую из геймдаты редактора, прописываем этот эффект чему-нибудь - и всё.

[[Изображение:Particle07.jpg|700px]]

==Авторы==

Статья создана:
[[Участник:Сахаров|Сахаров]] ([[Team:SRP Team|SRP Team]])

[[Категория:SDK]]

Спавн новых предметов

2008-08-10T10:39:56Z

89.178.50.109:

В этой статье я расскажу как создавать новые предметы:

Для начал находим файл items.ltx, находящийся в папке config/misc/, и копируем какой-нибудь предмет, я, например, взял:

<pre>[bread]:identity_immunities
GroupControlSection = spawn_group
discovery_dependency =
$spawn = "food and drugs\bread"
;$prefetch = 32
class = II_FOOD
cform = skeleton
visual = weapons\bred\bred.ogf
description = enc_equipment_food_bread1

inv_name = Bread
inv_name_short = Bread
inv_weight = 0.3 ;0.2

inv_grid_width = 1
inv_grid_height = 1
inv_grid_x = 11
inv_grid_y = 9
cost = 20

attach_angle_offset = -0.287979, 1.560923, 1.544060
attach_position_offset = 0.096910, -0.013594, 0.107925
attach_bone_name = bip01_r_hand
auto_attach = false

// should be deleted after update
bone_name = bip01_r_hand
position_offset = 0.0,0.0,0.0
angle_offset = 1.570790,1.570790,3.92699

; eatable item
eat_health = 0.05
eat_satiety = 0.2
eat_power = 0
eat_radiation = 0
wounds_heal_perc = 0
eat_portions_num = -1

; food item
slot = 4
animation_slot = 4

;hud item
hud = wpn_vodka_hud</pre>

Вставляем его копию в конец, меняем название:

[bread]

На:

[test]

А также:

inv_name = Bread
inv_name_short = Bread

На:

inv_name = test
inv_name_short = test

И description = enc_equipment_food_bread1 на description = enc_equipment_food_bread1_test

И, также, "по желанию":

eat_health = 0.05
eat_satiety = 0.2
eat_power = 0
eat_radiation = 0
wounds_heal_perc = 0
eat_portions_num = -1

Всё, в item.ltx работа закончена, теперь переходим к редактированию описания, открываем string_table_enc_equipment "Блокнотом". Что мы там видим: все описания и названия прописаны по тегам:

<string id="название из inv_name">
<text>Название в игре</text>
</string>

И:

<string id="описание из description">
<text>Описание в игре</text>
</string>

Пишем:

<string id="test">
<text>Тестовый предмет</text>
</string>

И:

<string id="enc_equipment_food_bread1_test">

<text>Тестовый предмет, разработанный в сверхсекретных лабораториях Зоны :)</text>

</string>

Сохраняем... Все! Основная работа завершена! Теперь добавим предмет торговцам, например, Сидоровичу.

Открываем trade_trader из папки config/misc (работа с ним подробно описана в [[Редактирование торговцев|этой статье]]), прописываем:

test = 0.3, 0.5

В секции:

[trader_generic_buy]

И далее в:

[supplies_start]

test = 10, 1

В [supplies_after_fabric]

test = 10, 1

В [trader_start_sell]

И в:

[trader_after_fabric_sell]

test = 1. 3

Сохраняем, запускаем игру, торгуем с Сидоровичем и видим у него два вида хлеба: один из них - наш :)

О том как, делать иконки для новых предметов, детально описано в [[Изменение текстур|статье BAC9-FLCL.]]

==Авторы==

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

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

Создание новой группировки

2008-08-10T10:39:01Z

89.178.50.109:

==Новая группировка==

Сегодня мы создадим новую группировку. Назовем её, скажем, "Ветер". Не суть важно.

==Практика==

===Базовый уровень===

'''1.''' Для начала в '''game_relations.ltx''' и в таблицу отношений группировок в конце и в заголовке добавляем название своей группировки и коэффициенты отношений к ней у других группировок. Также, не забываем прописать её собственное отношение к другим группировкам:

<pre>[communities_relations]
;|actor |act_dol|act_fre|stalker|monolit|militar|killer |ecolog |dolg |freedom|bandit |zombied|strange|trader|arena_enemy|wind|
;=================================================================================================================================
actor = 0, 0, 0, 0, -5000, -5000, -5000, 0, 0, 0, -5000, -5000, 0, 0, -5000, 0
actor_dolg = 0, 0, 0, 0, -5000, -500, -5000, 5000, 600, -5000, -5000, -5000, 0, 0, -5000
actor_freedom = 0, 0, 0, 0, -5000, -5000, -5000, -1500, -5000, 5000, 0, -5000, 0, 0, -5000, 0

stalker = 0, 0, 0, 0, -5000, -5000, -5000, 0, 0, 0, -5000, -5000, 0, 0, -5000, 0
monolith = -5000, -5000, -5000, -5000, 5000, -5000, -5000, -5000, -5000, -5000, 5000, 5000, -5000, 0, -5000, 0
military = -5000, -5000, -5000, -5000, -5000, 5000, -5000, 0, -5000, -5000, -5000, -5000, 0, 0, -5000, 0
killer = -5000, -5000, 0, -5000, -5000, -5000, 5000, -5000, -5000, -5000, 0, -5000, -5000, 0, -5000, 0
ecolog = 0, 600, -5000, 0, -5000, 1000, -5000, 5000, 500, -5000, -500, -5000, 0, 0, 0, 0
dolg = 0, 600, -5000, 0, -5000, -500, -5000, 5000, 5000, -5000, -5000, -5000, 0, 0, 0, 0
freedom = 0, -5000, 600, 0, -5000, -5000, -5000, -1500, -5000, 5000, 0, -5000, 0, 0, 0, 0
bandit = -5000, -5000, 0, -5000, -5000, -500, 0, -5000, -5000, 0, 0, -5000, -5000, 0, -5000, 0
zombied = -5000, -5000, -5000, -5000, 5000, -5000, -5000, -5000, -5000, -5000, -5000, 5000, -5000, 0, -5000, 0
stranger = 0, 0, 0, 0, -5000, -5000, -5000, 0, 0, 0, -500, -5000, 0, 0, 0, 0
trader = 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
arena_enemy = -5000, -5000, -5000, -5000, -5000, -5000, 0, 0, 0, -5000, -5000, 0, 0, 0, 0, 0

wind = 0, 0, 0, 0, -5000, -5000, -5000, 0, 0, 0, -5000, -5000, 0, 0, -5000, 0</pre>

Также, изменим эту строку, добавив туда имя и номер группировки:

<pre>;названия группировок
communities = actor, 0, actor_dolg, 1, actor_freedom, 2, stalker, 5, monolith, 6, military, 7, killer, 8, ecolog, 9, dolg, 10,
freedom, 11, bandit, 12, zombied, 13, stranger, 14, trader, 15, arena_enemy, 16, wind, 18,</pre>

Отсчет идет построчно начиная сверху. Хотя есть небольшой нюанс. У первых трех строк - нумерация начинается с нуля, с остальных группировок она идет как надо. Для wind выставили 18, так как мы эту группировку отделили от других.

Далее, в разделе ''[communities_sympathy]'' в конце добавляем свою группировку и коэффициент "впечатлительности" - чем он меньше, тем меньше отношение группировки будет меняться к вам в целом:

<pre>[communities_sympathy]
actor = 0.0
actor_dolg = 0.0
actor_freedom = 0.0
stalker = 0.0
monolith = 0.0
military = 0.0
killer = 0.0
ecolog = 0.0
dolg = 0.1
freedom = 0.1
bandit = 0.0
zombied = 0.0
trader = 0.0
stranger = 0.0
arena_enemy = 0.0
wind = 0.0</pre>

'''2.''' После этого в файле '''death_manager.script''' ищем строку ''local community_list'' и в скобках добавляем название своей группировки:

<pre>function init_drop_settings()
local community_list = { "stalker", "dolg", "freedom", "bandit", "military", "zombied", "ecolog", "killer", "monolith",
"arena_enemy", "actor_dolg", "wind" }</pre>

'''3.''' В файле '''death_items_by_communities.ltx''' пишем ''[x]:stalker'' (вместо ''x'' - название вашей группировки):

<pre>[...]
af_dummy_spring = 0
af_fuzz_kolobok = 0

;Еда
vodka = 0

[arena_enemy]
[actor_dolg]

[wind]: stalker
bread = 0
kolbasa = 0
vodka = 0
energy_drink = 0.3
</pre>

'''4.''' Если предусматривается респавн бойцов новой группировки, в '''se_respawn.script''' прописываем в '''local simMaxCount = {''' после строчек с зомбированными сталкерами строку:

<pre>
wind_novice = 20, wind_regular = 20, wind_veteran = 20, wind_master = 6,
</pre>

'''5.''' Чтобы при убийстве непися новой группировки игра не вылетала в '''xr_statistic.script''',

после строки:

<pre>zombied_novice = 1, zombied_experienced = 2, zombied_veteran = 3, zombied_master = 4,</pre>

пишем

<pre>dark_stalker_novice = 1, dark_stalker_experienced = 2, dark_stalker_veteran = 3, dark_stalker_master = 4,</pre>

'''6.''' Ну а в '''character_desk_x.xml''' выбираем любого NPC (или группу) и меняем группировку на свою:

<pre>
<specific_character id="esc_wolf" team_default = "1">
<name>esc_wolf_name</name>
<icon>ui_npc_u_stalker_neytral_balon_1</icon>
<bio>esc_wolf_bio</bio>

<class>esc_wolf</class>
<community>wind</community>
[...]</pre>

'''7.''' Чтобы у персонажа в графе "Группировка" отображалось не "wind", а "Ветер", зарегистрируем соответствующую строку в файле string_table_general.xml:

<pre><?xml version="1.0" encoding="windows-1251" ?>
<string_table>
<string id="wind">
<text>Ветер</text>
</string>
<string id="actor">
<text>Одиночка</text>
</string>
[...]</pre>

'''8.''' Существует возможность создать для нашей новой группировки места, где они будут ходить (''*_terrain'' брать из '''m_stalker.ltx'''):

То есть, к примеру, существует секция:
<pre>
[stalker_terrain]
255,000,255,255
008,001,255,255 ;Разрешено ходить по опасным местам на баре
012,001,255,255 ;Разрешено ходить по опасным местам на Милитари
</pre>

Тогда можно создать новую, по аналогии:

<pre>
[wind_terrain]
255,000,255,255
008,001,255,255 ;Разрешено ходить по опасным местам на баре
012,001,255,255 ;Разрешено ходить по опасным местам на Милитари
010,001,255,255 ;Разрешено ходить по опасным местам на янтаре
</pre>

Здесь, очевидно, указаны координаты самого уровня. Для каждого уровня существует своя начальная координата.

===Продвинутый уровень===

Такой метод достаточно примитивен. Это не полноценная группировка. Нам нужны соответствующие диалоги, возможность получения квестов и вступления в группировку, уникальные NPC.

====Квесты====

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

Во-первых, пропишите в список диалогов персонажа следующие строки:

<pre> <actor_dialog>[что-нибудь]_dialog</actor_dialog>
<actor_dialog>[что-нибудь]_reward</actor_dialog></pre>

Примеры названий: ''tm_trader_dialog'', ''tm_wolf_dialog''...

Внимание! Метод не проверен.

Этим мы добавили ему ветку диалога "Есть работа?", а также ветку для награды за квест/отказа от него. Теперь зарегистрируем в '''task_manager.ltx''' набор новых заданий.

<pre>[list]

[...]

;--------Wind------------------------
;----------Kill Stalker----
wind_kill_stalker
;----------Find Item----
wind_find_item

[...]

;tasks for Wind

[wind_find_item]
type = find_item
community = actor
text = [ссылка на текст с рассказом заказчика о задании]
description = [ссылка на текст с описанием задания]
parent = [имя NPC-заказчика]
target = scientific_outfit
reward_money = 5000
reward_reputation = +5
reward_rank = 4
reward_item = wpn_sig_m1
time = 86400

[wind_kill_stalker]
type = kill_stalker
community = actor
text = [ссылка на текст с рассказом заказчика о задании]
description = [ссылка на текст с описанием задания]
parent = [имя NPC-заказчика]
target = sim_stalker_master_master
reward_money = 4000
reward_reputation = +5
reward_rank = 9
reward_item = ammo_5.56x45_ap, ammo_5.56x45_ap, ammo_5.56x45_ap
time = 86400</pre>

Не забудьте прописать описания заданий в текстовые массивы. Подробнее о редактировании '''task_manager.ltx''' читайте в [[Однотипные квесты|уроке]], посвященном однотипным квестам.

Да, и зарегистрируйте сами ветки диалогов в файле '''dialogs.xml'''. Вот пример того, как это сделано для заданий "Долга":

<pre> <dialog id="tm_dolg_dialog" priority="-1">
<init_func>task_manager.init_dolg_task_dialog</init_func>
</dialog>
<dialog id="tm_dolg_reward" priority="0">
<init_func>task_manager.init_dolg_reward_dialog</init_func>
<precondition>task_manager.has_active_vendor_task</precondition>
</dialog></pre>

Соответственно, пройдем туда, куда указывает строка ''task_manager.init_dolg_task_dialog'' - в '''task_manager.script''':

<pre>function init_dolg_task_dialog(dlg)
get_random_task():init_task_dialog(dlg, "dolg")</pre>

По аналогии делаем и с нашим "Ветром".

====Вступление в группировку====

Реализуем возможность вступления в группировку.

Прописываем в '''dialogs.script''' такие action'ы:
<pre>-----------------------------------------------------------------------------------
-- Community
-----------------------------------------------------------------------------------

[...]

function actor_set_wind (actor, npc)
printf ("ACTOR NOW IN WIND COMMUNITY"
if db.actor then
db.actor:set_character_community ("actor_wind", 0, 0)
end
return true
end</pre>

После чего создадим диалог, и сделаем в нем фразу с action'ом вида ''<action>actor_set_wind</action>''. Советую изучить [[Создание диалогов|урок]], посвященный диалогам.

====Новые NPC====

Лучше всего всё вышеприведенное повесить на нового, уникального персонажа. Способ его спавна описан [[Cпавн через скрипт#Спавн NPC|здесь]].

==Авторы==

Статья [[Участник:BAC9-FLCL|BAC9-FLCL]]. 
Способ открыт [[Участник:Arhet|Arhet]] ([[Team:SRP Team|SRP Team]]).

Альтернатива - статья [[Участник:SenseyVit|SenseyVit]] ([http://stalkerhunt.ucoz.ru/publ/1-1-0-2 открыть]).

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

Создание нового оружия

2008-08-10T10:38:25Z

89.178.50.109:

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

Добавим в игру '''АК101'''.

==Внешний вид==

Позаботимся о том, чтобы наше оружие отличалось внешне от того же '''АК74'''.

===Текстуры===

Нарисуем для оружия новую текстуру. Подробно останавливаться на этом процессе не буду, ознакомьтесь с примером, приведенным [[Изменение текстур#Изменение текстур моделей|здесь]]. Итак, основываясь на текстуре '''АК74''', мы сделали вот такую текстуру:

[[Изображение:500px-AK101 texture.jpg]]

Файлы текстур мы назвали:

* '''wpn_ak10.dds'''
* '''wpn_ak10_bump#.dds'''
* '''wpn_ak10_bump.dds'''

===Модели===

Новых моделей мы пока делать не станем, просто воспользуемся дублированными моделями от '''АК74'''. Скопируем папку:

'''gamedata\meshes\weapons\ak47\'''

И назовем её '''ak-101'''. Содержимое, соответственно, переименуем в:

* '''wpn_ak101.ogf'''
* '''wpn_ak101_hud.ogf'''.

Теперь пропишем в эти модели созданные нами текстуры. Способ описан [[Изменение текстур#Создание новых visual для использования с новыми объектами|здесь]]'''.

===Иконки===

Добавим в игру иконки, которыми оружие будет отображаться в инвентаре. Способ подробно описан [[Изменение текстур#Изменение иконок предметов|здесь]].

Вот, что получилось в конечном итоге:

[[Изображение:500px-AK101 icon.jpg]]

==Конфиги==

Новое оружие мы будем делать на базе оригинальных конфигурационных файлов. Создадим '''АК101''' на базе конфигов '''АК74'''.

===Свойства оружия===

Скопируем файл из папки:

'''gamedata\config\weapons\ak74.ltx'''

Назовем его '''ak101.ltx'''.

Отредактируем свойства по своему усмотрению (но лучше - в соответствии с достоверной информацией о характеристиках оружия, т.к. '''АК101''' - всё-таки оружие реально существующее). Редактирование конфигов оружия подробно описано в отдельном [[Редактирование оружия|уроке]]. В данном случае конфиг был составлен таким образом:

<pre>;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
[wpn_ak101]:identity_immunities
GroupControlSection = spawn_group
discovery_dependency =
$spawn = "weapons\ak-101" ; name and section in level editor
$npc = on
$prefetch = 8
scheduled = off ;[] option for ALife Simulator
cform = skeleton
class = WP_AK74 ; class of the weapon that corresponding to CPP class
min_radius = 30 ; [] for AI
max_radius = 100 ; [] for AI
description = enc_weapons1_wpn-ak101

ef_main_weapon_type = 2
ef_weapon_type = 6

;-----------------------------------------------------------------------------------
holder_range_modifier = 1.0 ; во сколько раз увеличивается eye_range
holder_fov_modifier = 0.7 ; во сколько раз увеличивается eye_fov
;-----------------------------------------------------------------------------------

cost = 2;4000
weapon_class = assault_rifle

ammo_limit = 210
ammo_elapsed = 30

ammo_mag_size = 30
fire_modes = 1, -1

ammo_class = ammo_5.56x45_ss190, ammo_5.56x45_ap
grenade_class = ammo_vog-25, ammo_vog-25p
launch_speed = 0

hand_dependence = 1
single_handed = 0

slot = 2
animation_slot = 2
inv_name = wpn-ak101
inv_name_short = wpn-ak101
inv_weight = 3.3

inv_grid_width = 5
inv_grid_height = 2
inv_grid_x = 11
inv_grid_y = 29

kill_msg_x = 0
kill_msg_y = 28
kill_msg_width = 84
kill_msg_height = 28

;-----------------------------------------------------------------------------------
;params of weapon recoil

fire_dispersion_base = 0.15;0.2
control_inertion_factor = 1.1f;1.25f

;отдача
cam_relax_speed =6;5;3.5; 0.15
cam_dispersion = 0.1;0.15
cam_dispersion_inc = 0.2;0.3
cam_dispertion_frac = 0.8;0.9
cam_max_angle = 10.0
cam_max_angle_horz = 20.0
cam_step_angle_horz = 1.1;1

fire_dispersion_condition_factor = 5.7;5
misfire_probability = 0.0055;0.003
misfire_condition_k = 0.06;0.05
condition_shot_dec = 0.00035;0.0001
;-----------------------------------------------------------------------------------

fire_point = 0,0.216,0.638
fire_point2 = 0,0.216,0.730

flame_particles = weapons\generic_weapon05
smoke_particles = weapons\generic_shoot_00
grenade_flame_particles = weapons\generic_weapon01

shell_point = 0,0.216,0.174
shell_particles = weapons\generic_shells

PDM_disp_base = 1.0
PDM_disp_vel_factor = 1.3
PDM_disp_accel_factor = 1.3
PDM_crouch = 1.0
PDM_crouch_no_acc = 1.0

; ttc
hit_power = 0.36, 0.4, 0.43, 0.46
hit_impulse = 140
hit_type = fire_wound
fire_distance = 1700
bullet_speed = 1000
rpm = 750

use_aim_bullet = true
time_to_aim = 1.0

;params when silencer is attached
;similar to corresponding params without prefix silencer_

silencer_hit_power = 0.38
silencer_hit_impulse = 120
silencer_fire_distance = 250
silencer_bullet_speed = 600

hud = wpn_ak101_hud

position = -0.026,-0.172,0
orientation = 0,0,0

;--STRAP PARAMETERS-----------------------------------------------------------------
strap_position = -0.16,-0.40,0.15
strap_orientation = -10,-5,10
strap_bone0 = bip01_spine2
strap_bone1 = bip01_spine1

visual = weapons\ak-101\wpn_ak101

light_color = 0.6,0.5,0.3
light_range = 5
light_var_color = 0.05
light_var_range = 0.5
light_time = 0.2

ph_mass = 5

;addons
scope_status = 2
silencer_status = 2
grenade_launcher_status = 0;2

zoom_enabled = true
scope_zoom_factor = 50

scope_name = wpn_addon_scope
scope_x = 42
scope_y = 3
silencer_name = wpn_addon_silencer
silencer_x = 218
silencer_y = 13
grenade_launcher_name = wpn_addon_grenade_launcher
grenade_launcher_x = 116
grenade_launcher_y = 23

;sounds (name of the sound, volume (0.0 - 1.0), delay (sec))
snd_draw = weapons\ak74_draw
snd_holster = weapons\generic_holster
snd_shoot = weapons\ak74_shot_0
snd_shoot1 = weapons\ak74_shot_1
snd_shoot2 = weapons\ak74_shot_2
snd_shoot3 = weapons\ak74_shot_3
snd_empty = weapons\gen_empty, 0.5
snd_reload = weapons\ak74_reload, 0.7, 0.35
snd_shoot_grenade = weapons\gen_grenshoot
snd_reload_grenade = weapons\gen_grenload, 1.0, 0.8
snd_switch = weapons\groza_switch, 1.0, 0.5

;params when silencer is attached
;similar to corresponding params without prefix silencer_

;silencer_flame_particles = weapons\generic_weapon01
silencer_smoke_particles = weapons\generic_shoot_00

snd_silncer_shot = weapons\w_ak74_shot1

silencer_light_color = 0.6,0.5,0.3
silencer_light_range = 0.01
silencer_light_var_color = 0.05
silencer_light_var_range = 0.5
silencer_light_time = 0.2

;-----------------------------------------------------------------------------
;-- HUD DESCRIPTION
;-----------------------------------------------------------------------------

[wpn_ak101_hud]
allow_inertion = true

;similar to corresponding params in weapon section but for 1st person view

shell_point = -0.065000,0.000000,-0.045000
shell_dir = 0.0, 1.0, 0.0

fire_point = 0.09,0.020,-0.06
fire_point2 = 0.30, 0.00, 0.05
fire_bone = wpn_body

orientation = 0, 0, 0
position = 0, 0, 0.05
visual = weapons\ak-101\wpn_ak101_hud

grenade_bone = wpn_grenade

; animation names

anim_idle = idle
anim_idle_aim = idle_aim
anim_reload = reload
anim_draw = draw_wo_gl
anim_holster = holster_wo_gl
anim_shoot = shoot

; animation names
; attached grenade launcher [GRENADE fire mode]
anim_idle_g = idle_grenade
anim_idle_g_aim = idle_g_aim
anim_reload_g = reload_grenade
anim_shoot_g = shoot_grenade
anim_switch_grenade_on = switch_grenade
anim_switch_grenade_off = switch_grenade_off
anim_draw_g = draw_grenade_mode
anim_holster_g = holster_grenade_mode

; attached grenade launcher [NORMAL fire mode]
anim_idle_gl = idle_w_gl
anim_idle_gl_aim = idle_w_gl_aim
anim_reload_gl = reload_w_gl
anim_draw_gl = draw_w_gl
anim_holster_gl = holster_w_gl
anim_shoot_gl = shoot_w_gl
anim_idle_sprint = idle_sprint

;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;HUD offset in zoom mode (to all)
;(use CONSOLE: hud_adjust_mode 0,1,2, then keys WSADQE and P to show current value in console)

zoom_offset = -0.112400,0.016800,-0.115000
zoom_rotate_x = 0.000200
zoom_rotate_y = 0.017500

zoom_hide_crosshair = true

; same as above, but for attached grenade launcher for
; in NORMAL shoot mode

grenade_normal_zoom_offset = -0.112500,0.014000,0.000000
grenade_normal_zoom_rotate_x = -0.000900
grenade_normal_zoom_rotate_y = 0.017200

; same as above, but for attached grenade launcher for
; in GRENADE mode

grenade_zoom_offset = -0.039600,-0.433100,0.000000
grenade_zoom_rotate_x = -0.538700
grenade_zoom_rotate_y = -0.033800</pre>

===Регистрация===

Итак, с характеристиками разобрались. Теперь зарегистрируем оружие в файле '''weapons.ltx'''. Для этого пропишем в него строку следующего вида:

<pre>#include "w_ak101.ltx"</pre>

Также, необходимо прописать модели, используемые для отображения оружия, в '''prefetch.ltx''':

<pre>[...]
weapons\abakan\wpn_abakan
weapons\abakan\wpn_abakan_hud
weapons\ak-101\wpn_ak101
weapons\ak-101\wpn_ak101_hud
weapons\ak74\wpn_ak74
weapons\ak74\wpn_ak74_hud
[...]</pre>

Так же не забудте в файле '''mp_ranks.ltx''' прописать после '''available_items''' (которое внизу)
прописать название своего оружия. Это предотвратит вылет при убийстве ГГ.

==Добавление в игру==

Осталось добавить оружие в игру.

Выдайте его некоторым NPC ([[Редактирование NPC#Практика|как это сделать?]]), расширьте ассортимент торговцев ([[Редактирование торговцев#Расширяем ассортимент|как это сделать?]]).

А вот как оно будет выглядеть в игре:

[[Изображение:Russian_Guns_3.jpeg]]

==Авторы==

Статья создана:
*[[Участник:BAC9-FLCL|BAC9-FLCL]]

По материалам мода [[Mod:Russian Guns|Russian Guns]] за авторством:
*[[Участник:Tony|Tony]]
*[[Участник:lez0|lez0]]

[[Категория:Скрипты|Скрипты]][[Категория:Конфигурационные_файлы]]

Создание нового оружия

2008-08-10T10:37:39Z

89.178.50.109:

3dsmax. Создание колёсной техники

2008-08-10T10:30:12Z

89.178.50.109:

==Создание колёсной техники==
===1. Вступление===

Данный урок посвящен созданию моделей транспорта (авто или что-то другое решать Вам). Статья рассчитана на опытных пользователей 3DSMax.

Перед прочтением этой статьи советую еще раз ознакомится с [[Создание моделей и их добавление в игру|этим]] уроком.

===2. Создание примитов===

Для начала - откроем 3DSMax. Создадим что-то похожее на машину. Далее необходимо создать материал, настроить его и затекстурить модель.

[[Изображение:Untitled-2.jpg|300px]][[Изображение:Untitled-1.jpg|300px]]

На этом скриншоте показаны '''ID''' материалов назначаемых разным частям машины и подписаны сами части.

===3. Создание хелперов===

Поскольку лично я костями не пользуюсь, ставим Хелперы ('''Dummy''').

[[Изображение:Untitled-4.jpg|300px]]

Называть хелперы можно в процессе создания или после установки всех хелперов. Называть можно как Вам самим будет удобно и понятно, '''НО''' хелперы '''root''', '''front_axle''', '''back_axle''' не советую. Это именно те хелперы которые нельзя определить в конфига (*.ltx) и может случиться так что игра будет вылетать с нулевым логом.

[[Изображение:Untitled-5.jpg|300px]]

Тоже самое вид сбоку.

Затем надо развернуть некоторые хелперы в нужную сторону. Поскольку это не кости по ним невидно куда они ориентированы, это создает излишние сложности. Нам необходимо провернуть хелперы колёс (*_*_wheel), руля (stearing_wheel), сидения (seat_left), выхлопной трубы (exhausts), фар (*_light) и дверей (*_door). Конечные хелперы (вида *_end) вращать не надо.

Вращение хелперов осуществляется также как и любых других объектов в 3DSMax, а для проверки приходится пользоваться меню '''Hierarchy''' > '''Adjust Pivot''' > '''Affect Pivot Only'''.

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

[[Изображение:Untitled-8.jpg|300px]]

Здесь все хелперы уже повёрнуты в нужные стороны.
И более подробно каждый в отдельности.

[[Изображение:Untitled-9a.jpg|300px]][[Изображение:Untitled-9b.jpg|300px]][[Изображение:Untitled-9c.jpg|300px]][[Изображение:Untitled-9d.jpg|300px]][[Изображение:Untitled-9e.jpg|300px]][[Изображение:Untitled-9f.jpg|300px]]

Некоторые пояснения: вращение колёс происходит вокруг зелёной оси (хелпера) по направлению синей оси, водитель сидит лицом по зеленой оси (хелпера) тело снизу вверх направлено по синей оси (хелпера), фары светят по зелёной оси, выхлопная труба - дым направлен по зелёной оси, двери - выход из машины осуществляется по зелёной оси (хотя с этим надо поэкспериментировать).

И после всего этого необходимо создать Линки ('''Link''') между хелперами. Лункуются они начиная с конечного (end) к головному (root).
Итог должен выглядеть примерно вот так.

[[Изображение:Untitled-6.jpg|300px]] [[Изображение:Untitled-7.jpg|300px]]

Естественно жёлтых связей вы не увидите, но так выглядит более наглядно.

===4. Привязка скелета к модели===

После расстановки и линковки хелперов выбираем наш объект (mesh), применяем к нему модификатор '''Physique''', жмем кнопку '''Attach to node''' root –> '''Rigid''' –> '''Initialize'''. Скелет готов к привязке.

[[Изображение:Untitled-7.jpg|300px]]

Это действо уже описывалось в других уроках, поэтому останавливаться на этом подробно не буду.

Окончив привязку, можно экспортировать модель. Необходимо поставить галочку Allow Dummy.

[[Изображение:Untitled-3.jpg|100px]]

===4. Настройка модели в Actor Editor===

Здесь необходимо, вписать в раздел '''Object''' > '''User Data''' ссылку на файл конфиг (*.ltx), в моём случае строка имеет такой вид: #include "models\vehicles\veh_niva_u_01.ltx"

[[Изображение:Untitled-11a.jpg|300px]]

Вот так.

После этого неплохо проверить настойки материалов ('''Surfaces''').
Шейдеры для свечения и блеска models\lightplanes, def_shaders\def_ghost (или другие использующие прозрачность альфа канала), material\fake (по большому счёту материал неважен).
Шейдеры для колёс model\model, def_shaders\def_vertex, objects\car_wheel.
Шейдеры для кузова и прочих частей model\model, def_shaders\def_vertex, objects\car_cabine.

Далее необходимо настроить некоторые кости. В меню (слева) '''Object Items''' выбираем '''Bones''', далее '''Generate Shape''' > '''All'''. Ждём, в зависимости от компа и модели может занять минуту.
Раскрываем список, ищем оси машины '''back_axle''', '''back_axle2''', '''front_axle''', '''front_axle2''' и выбираем первую из них.
Смотрим ниже по списку (также слева) ищем раздел '''Shape''' в нём '''Type''', сейчас там стоит None надо поставить Cylinder (или Box кому что нравится).
Ползём ниже, раздел '''Joint''' в нём '''Rigid''', меняем на '''Joint'''. Ингода вместо человеческих цифр (в графах ниже), могут появляться бешеные числа такого типа 9999876455.0 вместо них ставим 0 (нуль).

[[Изображение:Untitled-11b.jpg|300px]]

Следующим выбираем '''back_left_wheel''', так же '''Shape''' > '''Type''' > '''None''' сменить на '''Cylinder'''. Далее раздел '''Joint''' в нём выбираем '''Wheel Steer-X,Roll-Z'''. Так же вместо человеческих цифр (в графах ниже), могут появляться бешеные числа такого типа 9999876455.0 вместо них ставим 0 (нуль).

[[Изображение:Untitled-11c.jpg|300px]]

Проделываем выше описанное для всех оставшихся осей и колёс.
Не забудьте для передних (рулевых) колес указать в разделе '''Joint''' > '''Steer''' > параметры '''Limits Min''' и '''Limits Max''' - это углы поворота колёс. Примерно минимум -20, максимум 20.

[[Изображение:Untitled-11d.jpg|300px]]

Далее необходимо проставить у всех остальных костей тип Box или более подходящий по месту (раздел '''Shape''' в нём '''Type''').
Если про экспорте ругается на нулевой шейп какой-либо кости, то её тип необходимо поставить в None.

Вот что в итоге получилось у меня.

[[Изображение:Untitled-11e.jpg|300px]]

Жуть редкостная, но ездит :)

[[Изображение:Untitled-12 (car test).jpg|300px]] [[Изображение:Untitled-12a (car test).jpg|300px]]

Удачи!

===6. Исходники===

Исходники можно не скачивать. Их просто нет (

==Авторы==

'''Статья создана:''' [[Участник:NOsoft|NOsoft]] 
'''Благодарности:''' [[Участник:Neo|Neo]], [[Участник:Zeed|Zeed]] и многие другие хорошие люди

[[Категория:SDK]]

3ds Max. Создание HUD-модели оружия

2008-08-10T10:27:40Z

89.178.50.109:

==Создание HUD-модели==
===1. Вступление===

Данный урок посвящен созданию HUD-моделей для оружия. Статья рассчитана на опытных пользователей 3DSMax, так что вопросы вида "Как создать сферу?" - не принимаются.

Вот так наш HUD будет выглядеть в конечном итоге (в 3DSMax):

[[Image:Hud lesson 1.jpg|400px]]

Перед прочтением этой статьи советую еще раз ознакомится с [[Создание моделей и их добавление в игру|этим]] уроком.

Для экспорта моделей лучше всего воспользоваться плагином '''ogf2smd''', т.к. встроенная функция экспорта из '''OGFViewer''' создает по 11 полигонов на одной координате, что крайне затрудняет процесс моделлинга и экспорта в игру.

===2. Работа с материалом===

Для начала - откроем 3DSMax.

Импортируем модель, открываем редактор материалов (по умолчанию - кнопка М). Нажимаем на кнопку '''Standart''', выбираем '''STALKER Mtl'''.

[[Изображение:Hud lesson 2.jpg]]

Кликнем по маленькой кнопочке напротив '''Diffuse''', выбираем '''Bitmap''', и находим нашу текстуру. Далее, присвоим её нашей модели. Все, с текстурированием покончено.

===3. Создание костей===

Для работы с костями удобно использовать утилиту '''Bone Tools''', которая находится в меню '''Character'''.

Как будет выглядеть расстановка костей в HUD-модели, вы увидите в исходнике, но главное – надо создать одну главную кость, и от нее уже вести скелет для рук и оружия. А сами кости создаются через '''Create''' -> '''Systems''' -> '''Bones'''.

===4. Привязка скелета к модели===

После расстановки костей выбираем наш объект, применяем к нему модификатор '''Physique''', жмем кнопку '''Attach to node''' –> '''Rigid\Deformable''' –> '''Initialize'''. Скелет готов к привязке.
*Важная деталь: К модели оружия обязательно должна быть привязана кость wpn_body, если ее не будет, то игра обязательно вылетит что бы вы не вписывали в конфигах!

[[Изображение:Hud lesson 3.jpg]]

Включаем режим '''Vertex''' и при нажатой кнопке '''Select''' и синем плюсе выбираем нужные вершины, жмем '''Attach to link'''. Далее, при выбранном красном (или зеленом, если объект твердый) плюсе кликнем по косточке и жмем '''Lock Assignment'''. Повторяем для всех костей.

[[Изображение:Hud lesson 4.jpg]]

3) Закончив привязку вершин для рук, в корне модификатора '''Physique''' сохраняем привязку в файл с помощью кнопки '''Save to *.phy''' , чтобы потом, загрузив этот файл при следующей привязке, сэкономить уйму времени.

[[Изображение:Hud lesson 5.jpg]]

Окончив привязку, можно приступать к анимированию.

===4. Анимация HUD-модели===

Анимировать можно в режиме '''Set Key''', и в режиме '''Auto Key''', но в данном случае удобнее будет все-таки во втором режиме.

Нажимаем кнопку '''Auto Key''', выбираем именно кость (для удобства анимации можно выполнить команду '''ПКМ''' –> '''Freeze selected''' в любом видовом окне), фиксируем ее положение нажатием ключа, переводим ползунок кадров в любое положение - траектория движения и ключи в промежутке кадров просчитаются автоматически.

[[Image:Hud lesson 6.jpg|400px]]

После того, как мы экспортировали модель без анимации, выбираем нашу анимацию и в утилите '''Stalker Export''' выбираем E'''xport Motion''', после чего экспортим анимацию формат '''*.skl'''
*Если игра вылетает с логом "cannot find anim [название_аним-и]_r" или с чем-то подобным, то создавайте копии существующих анимаций с окончанием '''_r''' и добавляйте их вместе с обычными.

[[Изображение:Hud lesson 7.jpg]]

===5. Настройка параметров в Actor Editor===

Открываем Actor Editor. Настраиваем параметры в свитке '''Surface'''. Я ставил такие:

* '''models\weapons'''
* '''def_shader\def_vertex'''
* '''game mtl\objects\small_weapon'''

[[Изображение:Hud lesson 8.jpg]]

В принципе, можно попробовать и другие.

Далее, настроим кости в свитке '''Bones'''. В параметрах свитка выделяем все кости, ставим '''Type''' -> '''XXXX''', нет никакой разницы, а также '''Game mtl\objects\small_weapon''', и нажимаем '''Generate shape''' -> '''All'''

Также чтобы анимации не "заедались" во время игры надо поставить галки напротив пунктов '''Stop at End''' и '''Sync Part'''.

[[Изображение:Hud lesson 9.jpg]]

После этого - настройка анимации. Открываем свиток '''Motions''', нажимаем кнопку '''Append''', выделяем все наши '''*.skl''' – анимации и вставляем в модель. Редактируем в параметрах скорость, плавность и проигрывание анимации. В оружии типа MP5 есть семь стандартных анимаций:

* idle
* idle_aim
* idle_sprint
* shoot
* draw
* holster
* reload

[[Изображение:Hud lesson 10.jpg]]

Берем с главной кости координаты и градус поворота худа, и вписываем их в конфиг.

В разделе конфига '''wpn_..._hud''' редактируются также параметры точки вылета гильзы из оружия, а также партикла выстрела. Чтобы облегчить себе работу с этими параметрами, можно создать в 3DSMax вспомогательные кости и сразу получить их координаты при настройке HUD'а в Actor Editor. Если в логе при импорте или экспорте вашего творения есть какие-то ошибки – значит, вы что-то сделали не так.

Рекомендую сразу не хвататься за сложный HUD, а просто сделать анимированное штурмового–наступательное оружие под названием "Кубик". Удачи!

===6. Исходники===

Вариант 1 - модель рук привязана к скелету Biped http://www.sendspace.com/file/k9yihh/

Вариант 2 - модель привязана к обычным костям http://www.sendspace.com/file/bsbht9/

==Авторы==

'''Статья создана:''' [[Участник:Egorych|Egorych]] 
'''Благодарности:''' [[Участник:Haron|Haron]], [[Участник:tambovski|tambovski]] 
'''Редактировано:''' [[Участник:Alwen|Alwen]] 16.02.2008

[[Категория:SDK]]

3ds Max. Создание HUD-модели оружия

2008-08-10T10:18:03Z

89.178.50.109:

==Создание HUD-модели==
===1. Вступление===

Данный урок посвящен созданию HUD-моделей для оружия. Статья рассчитана на опытных пользователей 3DSMax, так что вопросы вида "Как создать сферу?" - не принимаются.

Вот так наш HUD будет выглядеть в конечном итоге (в 3DSMax):

Hud lesson 1.jpg|600px

Перед прочтением этой статьи советую еще раз ознакомится с [[Создание моделей и их добавление в игру|этим]] уроком.

Для экспорта моделей лучше всего воспользоваться плагином '''ogf2smd''', т.к. встроенная функция экспорта из '''OGFViewer''' создает по 11 полигонов на одной координате, что крайне затрудняет процесс моделлинга и экспорта в игру.

===2. Работа с материалом===

Для начала - откроем 3DSMax.

Импортируем модель, открываем редактор материалов (по умолчанию - кнопка М). Нажимаем на кнопку '''Standart''', выбираем '''STALKER Mtl'''.

Hud lesson 2.jpg

Кликнем по маленькой кнопочке напротив '''Diffuse''', выбираем '''Bitmap''', и находим нашу текстуру. Далее, присвоим её нашей модели. Все, с текстурированием покончено.

===3. Создание костей===

Для работы с костями удобно использовать утилиту '''Bone Tools''', которая находится в меню '''Character'''.

Как будет выглядеть расстановка костей в HUD-модели, вы увидите в исходнике, но главное – надо создать одну главную кость, и от нее уже вести скелет для рук и оружия. А сами кости создаются через '''Create''' -> '''Systems''' -> '''Bones'''.

===4. Привязка скелета к модели===

После расстановки костей выбираем наш объект, применяем к нему модификатор '''Physique''', жмем кнопку '''Attach to node''' –> '''Rigid\Deformable''' –> '''Initialize'''. Скелет готов к привязке.
*Важная деталь: К модели оружия обязательно должна быть привязана кость wpn_body, если ее не будет, то игра обязательно вылетит что бы вы не вписывали в конфигах!

Hud lesson 3.jpg

Включаем режим '''Vertex''' и при нажатой кнопке '''Select''' и синем плюсе выбираем нужные вершины, жмем '''Attach to link'''. Далее, при выбранном красном (или зеленом, если объект твердый) плюсе кликнем по косточке и жмем '''Lock Assignment'''. Повторяем для всех костей.

Hud lesson 4.jpg

3) Закончив привязку вершин для рук, в корне модификатора '''Physique''' сохраняем привязку в файл с помощью кнопки '''Save to *.phy''' , чтобы потом, загрузив этот файл при следующей привязке, сэкономить уйму времени.

Hud lesson 5.jpg

Окончив привязку, можно приступать к анимированию.

===4. Анимация HUD-модели===

Анимировать можно в режиме '''Set Key''', и в режиме '''Auto Key''', но в данном случае удобнее будет все-таки во втором режиме.

Нажимаем кнопку '''Auto Key''', выбираем именно кость (для удобства анимации можно выполнить команду '''ПКМ''' –> '''Freeze selected''' в любом видовом окне), фиксируем ее положение нажатием ключа, переводим ползунок кадров в любое положение - траектория движения и ключи в промежутке кадров просчитаются автоматически.

Hud lesson 6.jpg|600px

После того, как мы экспортировали модель без анимации, выбираем нашу анимацию и в утилите '''Stalker Export''' выбираем E'''xport Motion''', после чего экспортим анимацию формат '''*.skl'''
*Если игра вылетает с логом "cannot find anim [название_аним-и]_r" или с чем-то подобным, то создавайте копии существующих анимаций с окончанием '''_r''' и добавляйте их вместе с обычными.

Hud lesson 7.jpg

===5. Настройка параметров в Actor Editor===

Открываем Actor Editor. Настраиваем параметры в свитке '''Surface'''. Я ставил такие:

* '''models\weapons'''
* '''def_shader\def_vertex'''
* '''game mtl\objects\small_weapon'''

Hud lesson 8.jpg

В принципе, можно попробовать и другие.

Далее, настроим кости в свитке '''Bones'''. В параметрах свитка выделяем все кости, ставим '''Type''' -> '''XXXX''', нет никакой разницы, а также '''Game mtl\objects\small_weapon''', и нажимаем '''Generate shape''' -> '''All'''

Также чтобы анимации не "заедались" во время игры надо поставить галки напротив пунктов '''Stop at End''' и '''Sync Part'''.

[[Изображение:Hud lesson 9.jpg]]

После этого - настройка анимации. Открываем свиток '''Motions''', нажимаем кнопку '''Append''', выделяем все наши '''*.skl''' – анимации и вставляем в модель. Редактируем в параметрах скорость, плавность и проигрывание анимации. В оружии типа MP5 есть семь стандартных анимаций:

* idle
* idle_aim
* idle_sprint
* shoot
* draw
* holster
* reload

[[Изображение:Hud lesson 10.jpg]]

Берем с главной кости координаты и градус поворота худа, и вписываем их в конфиг.

В разделе конфига '''wpn_..._hud''' редактируются также параметры точки вылета гильзы из оружия, а также партикла выстрела. Чтобы облегчить себе работу с этими параметрами, можно создать в 3DSMax вспомогательные кости и сразу получить их координаты при настройке HUD'а в Actor Editor. Если в логе при импорте или экспорте вашего творения есть какие-то ошибки – значит, вы что-то сделали не так.

Рекомендую сразу не хвататься за сложный HUD, а просто сделать анимированное штурмового–наступательное оружие под названием "Кубик". Удачи!

===6. Исходники===

Вариант 1 - модель рук привязана к скелету Biped http://www.sendspace.com/file/k9yihh/

Вариант 2 - модель привязана к обычным костям http://www.sendspace.com/file/bsbht9/

==Авторы==

'''Статья создана:''' [[Участник:Egorych|Egorych]] 
'''Благодарности:''' [[Участник:Haron|Haron]], [[Участник:tambovski|tambovski]] 
'''Редактировано:''' [[Участник:Alwen|Alwen]] 16.02.2008

[[Категория:SDK]]

Создаём HOM, порталы и сектора

2008-08-10T10:01:16Z

89.178.50.109:

[[Категория:Статьи участников]]

Для работы нам понадобится X-Ray SDK.

'''Для начала, зачем оно нужно:'''

HOM - расшифровывается как Hierarchical Occlusion Mapping, или маппинг иерархических отсечений. Что это значит: упрощённо говоря, с помощью HOM, можно повысить производительность рендеринга сложных уровней на ~20%.

'''Как работает HOM:''' Не вдаваясь в технические подробности, объясню упрощённо: то, что закрыто от игрока Occlusion'ом - процессор не обрабатывает, а видеокарта не рендерит - а значит, система экономит свои ресурсы, производительность при этом, естественно, возрастает.

'''Секторы и порталы:''' про них - читаем [http://www.gamedev.ru/articles/?id=30131 здесь] - разъяснено очень просто и доступно. Могу лишь добавить, что в X-Ray 3D Engine, геометрия уровня в построении секторов не участвует, он использует для этого HOM-объекты.

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

{{Message_box|
id =pseudoscience|
align = left|
backgroundcolor = #f9f9f9|
image =Lamp.gif|
heading = Важные моменты|
message = 1. Делать всё это, актуально для действительно сложных и мощных карт, так как не только поднимет скорость в итоге,
но и позволит напихать в карту, побольше всякой интересной геометрии.

2. Изложенные выше принципы, актуальны не только для сталкера, но и для подавляющего большинства современных игр.
Например, лучше всего это всё дело с порталами и секторами продумано на играх на движке Sourse (Half-Life 2 и т. д.)
}}
 

'''Итак, приступаем к креативу!'''

Допустим, есть у вас карта, на которой надо сделать всё вышеперечисленное. Как это сделать, я объясню на примере старого доброго кубика, сделаем ему HOM, поставим на карту, и создадим порталы с секторами.

Начнём с HOM.

Вот наша карта, на ней кубик, надо для него сделать HOM.

[[Изображение:100.JPG|400px]]

Чтобы сделать HOM, сбрасываем сцену, и идём в Библиотеку статической геометрии, находим там наш кубик. У меня он находится по адресу '''editor\shadertest_box''', вы можете заюзать свой.

[[Изображение:200.JPG|400px]]

Теперь, этот кубик, там же, в библиотеке, экспортим в формат LWO, чтобы стереть все настройки материалов, на базе экспортированного объекта мы и сделаем HOM, и материалы с шейдерами ему ни к чему: обозвал я его '''shadertest_box_occ''', (OCC - значит окклюдер, отсекатель).

[[Изображение:300.JPG|400px]]

Всё, экспортировали. Теперь импортируем его обратно, заходим в настройки объекта, в поле '''Object Type''' (тип объекта), меняем его тип со '''Static''' на '''HOM''', выходим с настроек и сохраняем изменения. Тут же - видим, вид нашего кубика - изменился, теперь - он стал HOM-объектом.

[[Изображение:400.JPG|400px]]

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

[[Изображение:500.JPG|400px]]

Осталось только "подогнать" (двигая, вращая и т. д...) окклюдер под имеющийся кубик как можно точнее.

[[Изображение:600.JPG|400px]]

Всё! HOM-окклюдер для объекта успешно создан. Таким-же образом, можно (и нужно) поступить со всеми объектами на карте, но создавать окклюдеры лучше всего - ещё в '''3DSMax''', в виде неких "упрощённых муляжей" для создаваемых объектов. Хотя можно и так как я описал выше.

Секторы и порталы необходимо генерировать ''после'' того, как сборка карты закончена, все объекты на месте, окклюдеры установлены, и т.д. Короче, перед самой прекомпиляцией. Делаются они очень просто, так как в SDK - возможности по ним весьма убогие, а многие так и вообще "временно отключены". Но создавать их можно.

Итак:

Переходим в режим '''Секторы''' и создаём базовые порталы, нажав соответствующую кнопку. Если объектов много, целесообразно "проверить на правильность" одноимённой кнопкой. Сектора созданы.

[[Изображение:700.JPG|400px]]

'''Переходим в режим "порталы"''' и "вычисляем все порталы".

[[Изображение:800.JPG|400px]]

Всё. Occlusion Mapping - сделан, сектора созданы, а порталы к ним вычислены. Спасибо за внимание.

==Авторы==

Статья создана: [[Участник:Haron|Haron]] 
Коррекция: [[Участник:BAC9-FLCL|BAC9-FLCL]]

[[Категория:SDK]]

Редактирование костюмов

2008-08-10T09:54:42Z

89.178.50.109:

===Разбор параметров===

В этой статье мы рассмотрим значения параметров костюмов. 
Все параметры, не упомянутые ниже, изменять '''строго не рекомендуется'''!

Итак, секции с параметрами находятся в файле: 
'''config\misc\outfit.ltx'''

Разберем, например, параметры классического костюма сталкера.

<pre>[stalker_outfit]:outfit_base

; название секции костюма. именно к нему игра будет обращаться. outfit_base -
базовая (наследуемая) секция (изменять строго не рекомендуется).

visual = equipments\stalker_suit ; модель, используемая для сложенного костюма,
лежащего на земле.

actor_visual = actors\hero\stalker_hood.ogf ; модель, используемая для игрока, когда
на нем надет костюм.

inv_name = stalker_outfit_name ; название в инвентаре.

inv_name_short = stalker_outfit_name ; название в инвентаре (в принципе, можно
здесь продублировать значение предыдущего параметра - так чаще всего и делают).

description = stalker_outfit_description ; ссылка на текстовую строку
с описанием.

inv_weight = 5.0 ; вес.

; далее идут параметры иконки в инвентаре (см. примечание 1).

inv_grid_width = 2
inv_grid_height = 3
inv_grid_x = 6
inv_grid_y = 15

full_icon_name = npc_icon_stalker_outfit ; название иконки.

cost = 15000 ; базовая цена (см. примечание 2).

full_scale_icon = 14,11 ; иконка сталкера в костюме в полный
рост (отображается в инвентаре справа).

nightvision_sect = effector_nightvision_bad ; тип ПНВ
("плохой" - зеленый, "хороший" - синий).

; ниже идут параметры защиты владельца от различных типов воздействий,
обеспечиваемые костюмом.

burn_protection = 0.5 ; защита от воздействия
огня (костры, аномалия "Жарка" и т.д.).

strike_protection = 0.5 ; защита от ударов
(наносятся мутантами, например, псевдогигантом).

shock_protection = 0.5 ; защита от поражения
электричеством.

wound_protection = 0.4 ; защита от ранений
(наносятся мутантами, например, собаками, кровососами и т.д.).

radiation_protection = 0.5 ; защита от радиации.

telepatic_protection = 0.0 ; защита от пси-воздействия
(например, присутствие контроллера серьезно влияет на psy_health).

chemical_burn_protection = 0.5 ; защита от химического воздействия.

explosion_protection = 0.3 ; защита от взрывов/осколков.

fire_wound_protection = 0.3 ; защита от огнестрельного
оружия (наиболее важный параметр для большинства костюмов).

power_loss = 0.87
bones_koeff_protection = gilet_antigas_damage

[sect_stalker_outfit_immunities] ; коэффициенты иммунитета самого костюма, то
есть - то, насколько сильно он сам подвержен повреждениям от различных типов
воздействий. по значениям каждого типа - см. выше.

burn_immunity = 0.03
strike_immunity = 0.01
shock_immunity = 0.03
wound_immunity = 0.015
radiation_immunity = 0.00
telepatic_immunity = 0.00
chemical_burn_immunity = 0.03
explosion_immunity = 0.03
fire_wound_immunity = 0.01</pre>

===Примечания===

1. Подробнее о работе с иконками и текстурами - см. [[Редактирование торговцев|здесь]]. 
2. Подробнее о механизме работы цен - см. [[Изменение текстур|здесь]].

==Авторы==

Статья создана:

* [[Участник:BAC9-FLCL|BAC9-FLCL]]

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

Спавн через скрипт

2008-08-10T09:50:50Z

89.178.50.109: /* Спавн NPC */

==Теория==

В скриптах есть одна единственная функция, отвечающая за спавн объектов:
<pre>alife():create(section,position,levelvertex,gamevertex)</pre>

Строго говоря, их две: create create_ammo но различия между ними не существенны. [[Участник:Imp|Imp]] 22:45, 23 июля 2007 (EEST)

Первый параметр - секция в конфигурациях, описывающая объект, например "bolt","med_kit" - это простые секции, простых объектов
а есть объекты, которые переходят в онлайн/оффлайн, это неписи, монстры и так далее, например mil_killer_respawn_2 - спавнится снайпер группировки киллеров.

С позицией, думаю объяснять не надо, только существует нюанс - высота это Y, а не Z.
Задать позицию можно такой конструкцией vector():set(x,y,z), где x, y и z - координаты точки на уровне, где спавним объект.

Дальше сложнее, так как сам толком сформулировать не могу.

Начнем от простого к сложному. На каждом уровне много объектов, все объекты состоят из полигонов, у каждого полигона есть вершины – вертексы.

Именно они и должны здесь указываться, зачем - не особо понимаю, скорее всего для точного позиционирования объекта.
Например, можно получить вертекс ближайший к актору - db.actor:level_vertex()

Дальше идет гораздо более интересный параметр game_vertex, это почти то же самое, что и level_vertex, но (!) это глобальные величины!
Если level_vertex считается для уровня, то game_vertex - для всей игры, и нужен он для того, чтобы указать на какой карте спавнить объект (более вразумительного объяснения я не нашел).

Соответственно, чтобы заспавнить что-нибудь на другой карте, достаточно указать game_vertex в четвертом параметре
Например:
<pre>db.actor:game_vertex()</pre>

Итак, чтобы, например, заспавнить болт под ногами актора, пишем:
<pre>alife():create("bolt",db.actor():position(),1,db.actor:game_verte())</pre>

Почему 1, а не level_vertex? Проверено - разницы особой нет, какой level_vertex, хотя в некоторых случаях надо прописывать валидный вертекс, а то предмет может просто заспавнится не там, где планировалось... Но по большей части все проходит нормально и с единицей.
(Игнорирование level_vertex может приводить к проваливанию произведенных предметов/персонажей под землю.)
А вот game_vertex решает все - он указывает на каком уровне спавнить предмет, поэтому его надо указывать. Теоретически можно просто найти для каждого уровня по одному game_vertex'у и использовать их в скриптах.
На самом деле game_vertex показывает какой фрагмент карты используется (вся карта разбита на кусочки имеющие сквозную нумерацию по всем уровням и game_vertex выбирает нужный) соответсвенно неправильное использование черевато....

Кроме того - есть еще один параметр - ID объекта, если указать ID NPC или актора - то предмет заспавнится у него в инвентаре.

Пример (спавним артефакт Медуза в инвентаре у актора):
<pre>alife():create("af_medusa", db.actor():position(), 1, db.actor:game_vertex(), db.actor:id())</pre>

Функция спавна возвращает серверный объект, то есть ни NPC, ни монстра ни что-либо еще.

Серверный обьект позволяет свеже созданного NPC или тайник затарить разными рулезами/артефактами. Например, вот так создадим перед входом к Сидоровичу долговца и засунем в него пачку патронов:
<pre>
local obj
local a = vector() -- Задаем тип переменной
local dir = db.actor:direction()

a.x = -243.61 -- координата X
a.y = -19.52 -- высота Y
a.z = -127.17 -- координата Z

obj = alife():create("bar_dolg_respawn_3",a,13193,8,65535)
alife():create_ammo("ammo_9x18_fmj",
obj.position,
obj.m_level_vertex_id,
obj.m_game_vertex_id,
obj.id,
20) -- число патронов</pre>

Кстати, create_ammo - практически тоже самое, что и create, разница в том, что create_ammo предназначена специально для спавна патронов и позволяет создавать неполные пачки патронов. Возможно есть еще какие-то отличия. Стоит учесть, что сами авторы игры спавнят патроны исключительно через create_ammo. [[Участник:Imp|Imp]] 22:38, 23 июля 2007 (EEST)

Просто минимальный набор - координаты, ID, секция,а из него (серверного объекта) обычно нужен только ID, так как по ID можно получить этот самый серверный объект:
<pre>(alife():object(id))</pre>

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

Например надо решить следующую задачу - надо создать наемника, сменить ему группировку и изменить его инвентарь, ну и в нагрузку - сделать другом для игрока.

В определенный момент заспавненый объект переходит онлайн, в этот момент вызывается callback - net_spawn.

Что мы делаем? Сверяем ID онлайн объекта с сохраненным ID!

Если они совпадают, например так:
<pre>if obj:id()==saved_id then ...</pre>

Важно то, что у серверного объекта ID - это параметр, а у онлайнового объекта ID получается с помощью функции. Это важно, а то можно прогореть.

Итак, мы поймали нашего киллера по ID.

Далее все очень просто - вызываем команды для спавна гаусса и патронов к нему в инвентаре NPC (см. выше), меняем группировку специальной функцией, и делаем его другом.

Зачем такие сложности? Просто в оффлайне NPC как бы не существует, есть только косвенное упоминание о нем, и, плюс, все эти функции работают именно с объектом типа "NPC", а не с серверными объектами.

==Практика (часть 1)==

'''1.''' Чтобы не повторяться в описании создания нового квеста, просто изучите [[Создание квестов (Fr3nzy)|статью по созданию квестов]] от Fr3nzy – лучшей статьи на эту тему я просто не видел :) Мы просто свяжем все воедино и научимся спавнить объекты из скрипта.

Небольшое отступление:

Почему предпочтительнее делать спавн скриптом, а не через тот же xrSpawner? Программа xrSpawner, при всех своих достоинствах, обладает одним недостатком, а именно – она делает спавн через файл all.spawn, что приводит к:

* Невозможности совместить два мода, такой спавн использующих
* Необходимости каждый раз начинать новую игру

При спавне через скрипт ситуация иная: в подавляющем большинстве случаев, ранее сохраненные игры будут работать, что не может не радовать :)

Итак, определимся с квестом.

'''Задача:''' после разговора с Сидоровичем спавним зомби на территории фабрики в первой локации. Для того, чтобы не повредить оригинальный сюжет игры, задание будет выдаваться '''после''' прохождения квеста с флешкой Шустрого, так как появись там зомби одновременно с бандитами и Шустрым... я думаю, исход боя предрешен :)

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

В консоли введите команду:

<pre>rs_stats on или rs_stats 1 </pre>

Тем самым мы включаем вывод информации на экран.
Далее вводим еще одну команду:

<pre>demo_record 1 </pre>

И «летим» на фабрику. Нам нужно выбрать место для спавна объектов и данный режим как нельзя лучше подходит для реализации задуманного. Помещаем камеру в точке предполагаемого спавна и записываем координаты - у меня получились 115, -6, -16.

Для выхода из режима demo_record нажимаем Esc, в консоли пишем rs_stats off или rs_stats 0 (убираем вывод информации).

Другой способ получения тех же сведений - прийти в нужное место и запустить там скрипт, который выдаст все нужные координаты. Я пользуюсь следующим скриптом (вызываю общеизвестным способом, через main_menu):
<pre>
function main_menu:main_cheat_f3()
-- Выдадим сообщение о нашем местоположении
local text
local vid
local gvid
local a = vector() -- Тип переменной
local text

a = db.actor:position() -- Наше положение в координатах
vid = db.actor:level_vertex_id()
gvid = db.actor:game_vertex_id()
text = "Позиция:\\nX= "..a.x.."\\nY= "..a.y.."\\nZ= "..a.z.."\\nlevel_vertex= "..vid.."\\ngame_vertex_id= "..gvid
news_manager.send_tip(db.actor, text, nil, nil, 30000)
end
</pre>
В результате не нужно эксперементировать мы сразу получаем все, в том числе и level_vertex и game_vertex. [[Участник:Imp|Imp]] 22:38, 23 июля 2007 (EEST)

Выходим из игры, идем в папку с установленной игрой и создаем каталог gamedata (предполагается, что «лепим» свой «мод» на «чистую» игру, без установленных модов, и имеем распакованные ресурсы игры в папке, скажем, gamedata source).

В папке gamedata создаем папку config, а в ней - папку creatures. Скопируем из оригинальной папки файл m_zombie.ltx и откроем его на редактирование.

В файлах игры присутствуют 5 моделей гражданских зомби:

<pre>файлы zombi_1.ogf, zombi_1_ghost.ogf, zombi_2.ogf, zombi_trup.ogf, zombi_trup_2.ogf</pre>

Вернем в игру их всех :)

Уже имеются секции:

<pre>[zombie_weak]:m_zombie_e, [zombie_normal]:m_zombie_e, [zombie_strong]:m_zombie_e и [zombie_immortal]:zombie_strong. </pre>

Два последних типа используют одну и ту же модель zombi_trup.ogf, хм... непорядок, исправляем.
Последняя секция выглядит теперь так:

<pre>[zombie_immortal]:zombie_strong
$spawn = "monsters\zombies\zombie_immortal"
visual = monsters\zombi\zombi_trup_2
panic_threshold = 0.05 </pre>

Добавим пятую модель.

Для этого в конце файла создадим секцию:
<pre>[zombie_ghost]:zombie_strong</pre>

Это означает, что наш пятый зомби наследует все параметры zombie_strong, мы добавим лишь визуальное представление.

Пишем дальше:

<pre>$spawn = "monsters\zombies\zombie_ghost"
visual = monsters\zombi\zombi_1_ghost</pre>

Все. Сохраняем изменения и закрываем файл.

'''2.''' Пишем скрипт спавна. В папке gamedata создаем новую папку scripts, в ней создаем новый текстовый документ и называем его esc_zombie.script.

Отступление третье:

При написании статьи использовался оригинальный скрипт zombie_story.script из horror-mod’а. Концепция спавна перенесена практически без изменений, поэтому на авторство этого способа спавна я никоим образом не претендую :)

Итак, открываем наш пустой файл на редактирование, первой строкой объявляем переменную, в которой хранятся наши зомби:

<pre>local zombie_types = {"zombie_weak", "zombie_normal", "zombie_strong", "zombie_immortal", "zombie_ghost"}</pre>

Далее пишем функцию:

<pre>function spawn_zombies( position, total )
local zombie_index -- тип зомби из массива zombie_types
local new_pos, x_offset, z_offset -- объявляем переменные
for zombie_index=1, total do -- крутим цикл столько раз, сколько
задает переменная total
x_offset = math.random(5) -- случайное (рандомное) x от 1 до 5
z_offset = math.random(5) -- случайное (рандомное) z от 1 до 5
new_pos = position -- передаем координаты в функцию
new_pos.x = new_pos.x + x_offset -- прибавляем к указанной нами
координате x полученное выше рандомное x
new_pos.z = new_pos.z + z_offset -- прибавляем к указанной нами
координате z полученное выше рандомное z
-- Ниже, собственно и вызывается функция спавна случайного типа зомби
zombie_types[math.random(5)] привязанного к нашим координатам
alife():create(zombie_types[math.random(5)],new_pos,db.actor:level_vertex_id(),db.actor:game_vertex_id())
end
end </pre>

И последнее:

<pre>function zomby_story_1( actor, npc )
-- десять зомби на фабрике (Кордон)
local spawn_point = vector():set( 115, -6, -16 ) -- здесь указываем координаты,
выбранные нами для спавна, когда «летали» камерой :)
spawn_zombies( spawn_point, 10 ) -- собственно вызов предыдущей функции
с передачей ей координат и количества объектов
end</pre>

Все. Сохраняем и закрываем файл.

Продолжаем разговор :)

Для того, чтобы игра не вылетала после того, как мы добавили новый тип монстров, их нужно добавить в файл xr_statistic.script. Итак, скопируем этот файл из папки игры scripts в нашу папку к файлу esc_zombie.script и откроем на редактирование.

Добавим в local killCountProps к монстрам строчку:
<pre> zombie_weak = 1, zombie_normal = 2, zombie_strong = 3</pre>

В local sect_alias строчку:
<pre> zombie_weak = "zombie_weak", zombie_normal = "zombie_normal", zombie_strong = "zombie_strong"</pre>
А ниже в monster_classes строчку:
<pre> [clsid.zombie_s ] = "zombie"</pre>
В функцию getNpcType(npc) добавляем конструкцию:
<pre> elseif npc:character_community() == "zombie" then
community = "zombie"</pre>

Сохраняем изменения и закрываем файл.

Все будет работать на ура, пока мы не попробуем обыскать убитого зомби. Как только мы это сделаем, игра вылетит с примерно такой ошибкой.

<pre>Expression : fatal error
Function : CInifile::r_string
File : D:\xray-svn\xrCore\Xr_ini.cpp
Line : 351
Description : <no expression>
Arguments : Can't find variable icon in [zombie_weak]</pre>

Все верно – игра не знает какую иконку нам показывать для зомби. Иконки монстров хранятся в файле ui_npc_monster.dds. Здесь есть два варианта:

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

Вернемся к файлу m_zombie.ltx и в секцию [m_zombie_e]:monster_base впишем параметр
<pre> icon = ui_npc_monster_kontroler</pre>

Все. Вылетов не будет.

3. Тема данной статьи не предусматривает подробного описания того, как сделать новый диалог. В начале статьи я упомянул источник, где можно найти исчерпывающую информацию по созданию диалогов, могу также привести в пример [[Создание диалогов (BAC9-FLCL)|статью по созданию диалогов]] от BAC9-FLCL.

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

<pre> <dialog id="escape_trader_talk_info">
………
<phrase id="999">
<text>escape_trader_talk_info_999</text>
<next>7770</next>
<next>9991</next>
<next>9992</next>
<next>9993</next>
<next>9994</next>
<next>9995</next>
<next>9996</next>
</phrase>
<phrase id="9992">
<text>escape_trader_talk_info_9992</text>
<next>99922</next>
</phrase>
<phrase id="99922">
<text>escape_trader_talk_info_99922</text>
<next>9996</next>
<next>9995</next>
</phrase>
<phrase id="9993">
<text>escape_trader_talk_info_9993</text>
<next>99933</next>
</phrase>
<phrase id="9995">
<text>escape_trader_talk_info_9995</text>
</phrase>
<phrase id="3121">
<text>escape_trader_talk_info_3121</text>
<next>9996</next>
<next>9995</next>
</phrase>
<phrase id="3131">
<text>escape_trader_talk_info_3131</text>
<next>9996</next>
<next>9995</next>
</phrase>
<phrase id="41">
<text>escape_trader_talk_info_41</text>
<next>9996</next>
<next>9995</next>
</phrase>

<phrase id="7770">
<text>escape_trader_talk_info_7770</text>
<next>7771</next>
</phrase>
<phrase id="7771">
<text>escape_trader_talk_info_7771</text>
<next>7772</next>
<next>7773</next>
</phrase>
<phrase id="7772">
<text>escape_trader_talk_info_7772</text>
<next>7777</next>
</phrase>
<phrase id="7773">
<text>escape_trader_talk_info_7773</text>
<next>7779</next>
</phrase>
<phrase id="7779">
<text>escape_trader_talk_info_7779</text>
<next>9996</next>
<next>9995</next>
</phrase>
<phrase id="7777">
<text>escape_trader_talk_info_7777</text>
<action>esc_zombie.zombie_story_1</action>
<next>9996</next>
<next>9995</next>
</phrase>

<phrase id="51">
<text>escape_trader_talk_info_51</text>
<next>9996</next>
<next>9995</next>
</phrase>
……
</dialog></pre>

И также связанный с ним файл stable_dialogs_escape.xml.
В самом начале файла пишем следующее:

<pre> <string id="escape_trader_talk_info_7770">
<text>Происшествий никаких не было?</text>
</string>
<string id="escape_trader_talk_info_7771">
<text>Да знаешь... Вроде как тихо все у нас. Хотя, вот, вспомнил! Говорили мне
на днях, что на фабрике, ну, там, где бандюки околачиваются постоянно, видели какиих-то то ли
людей, то ли призраков... Мало ли что спьяну почудится - я и сказал этим паникерам, мол,
закусывать надо! Хех, блин, алкаши...</text>
</string>
<string id="escape_trader_talk_info_7772">
<text>Дык мне по любому мимо фабрики топать - заодно и посмотрю на этих
"людей-призраков".</text>
</string>
<string id="escape_trader_talk_info_7773">
<text>Да я как-то не собирался в ту сторону...</text>
</string>
<string id="escape_trader_talk_info_7779">
<text>Ну, смотри сам, все равно будь осторожен.</text>
</string>
<string id="escape_trader_talk_info_7777">
<text>Ага. Сходи, проветрись. Потом зайдешь, расскажешь, что там и как.</text>
</string>
<string id="esc_bridge_soldiers_start_11">
<text>Здесь проход воспрещён, сталкер.</text>
</string></pre>

Все. Можно запускать игру, идти на Кордон, после разговороа с Сидоровичем, в зависимости
от выбранного Меченным решения, бежим на фабрику и … смотрим сами :)

[http://www.sendspace.com/file/2kx7uf Готовые файлы примера](перезалито)
[http://slil.ru/24600587 Spawn Lib]
Домашнее задание - вернуть в игру 6-ой тип гражданского зомби :)

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

==Практика (часть 2)==

'''4.''' Сегодня мы закончим с зомби в полном объеме – добавим их описания в энциклопедию, добавим иконки, и разберемся с «домашним заданием»:) Думаю, что внимательно изучив эту статью, вы ''сами'' сможете через скриптовые функции восстановить любого персонажа, не вошедшего в финальный релиз игры. Если у кого хватит времени и желания, те могут даже написать что-то типа «Ночи живых мертвецов» :) - серию квестов, связанную своим собственным сюжетом.
Итак, «домашнее задание» - добавляем в игру шестого зомби.

* Создаем в папке gamedata папку meshes, в ней папку monsters, а там – папку zombi. В папке meshes хранятся модели персонажей, объектов, окружения, присутствующих в игре. Как я уже говорил выше, в игре представлено 5 моделей гражданских зомби, а вот текстур – 6. Также немного смутила нумерация моделей – 1, 2, 4... А где третий? Наверное, сбежал :)

* Скопируем из папки с оригинальными файлами игры в созданную нами папку zombi файл zombi_2.ogf и переименуем его в zombi_3.ogf. Откроем файл нашей новой модели любым HexEditor’ом, я использую BiEd (Binary Editor 1.00). Так как данная статья рассчитана не только на «продвинутых юзеров», но и на «обычных чайников», которые, тем не менее, хотят «что-нить замутить» и при этом не сильно «парить моск», я не буду рассказывать здесь про адресацию, двухбайтовую запись и т.д., я просто наглядно покажу, где что поправить :)

[http://www.golushkov.pp.net.ua/photo/11-0-717-3 Файл модели '''до''' редактирования]

[http://www.golushkov.pp.net.ua/photo/11-0-718-3 Файл модели '''после''' редактирования]

На скринах видно, что мы просто изменили для этой модели путь к текстуре. Все. Без использования 3D-редакторов и затраты кучи времени на обработку модели в них, мы получили абсолютно новую (на внешний вид) модель. :)

'''5.''' Теперь пропишем нашего нового зомби во все файлы, которые мы создали ранее. В файл m_zombie.ltx в самый конец добавляем секцию:

<pre>[zombie_old]:zombie_normal
$spawn = "monsters\zombies\zombie_old"
visual = monsters\zombi\zombi_3</pre>

в файле esc_zombie.script изменяем массив в первой строке:

<pre>local zombie_types = {"zombie_weak", "zombie_normal", "zombie_strong", "zombie_immortal",
"zombie_old", "zombie_ghost"}</pre>

В функции spawn_zombies изменяем строку спавна:

<pre> alife():create(zombie_types[math.random(6)],new_pos,
db.actor:level_vertex_id(),db.actor:game_vertex_id())</pre>
в функции zombie_story_1 меняем число объектов на кратное 6-ти (необязательно):

<pre> spawn_zombies( spawn_point, 12 )</pre>

Всё. Сохраняем и закрываем.

'''6.''' Копируем в папку gamedata\config\gameplay\ файл encyclopedia_mutants.xml, добавляем описание зомби в энциклопедию:

<pre> 

<article id="mutant_zombieg_general" name="Zombieg" group="Mutants">
<texture>ui_npc_monster_zombieg</texture>
<text>enc_mutant_zombieg_general</text>
</article>
</pre>

И в связанный с ним файл string_table_enc_mutants.xml в папке gamedata\config\text\rus\ добавляем:

<pre> <string id="Zombie">
<text>Зомби, гражданский</text>
</string>
<string id="Zombieg">
<text>Зомби-призрак, гражданский</text>
</string>
<string id="enc_mutant_zombieg_general">
<text>Зомби-привидение отличается от обычного зомби лишь тем, что
воздействие Выжигателя мозгов полностью разрушило не только структуру личности, но и
тело, поэтому зомби-призрак несколько более живуч по сравнению с обычным зомби.</text>
</string>
<string id="enc_mutant_zombie_general">
<text>Воздействие Выжигателя мозгов полностью разрушает структуру личности,
оставляя только телесную оболочку.\n\n Побродив немного по Зоне, лишённые разума тела
начинают превращаться в настоящих зомби. Из рефлексов у них остаются лишь самые примитивные,
оружие и экипировка скоро приходят в негодность. В результате зомби становятся собой ни чем
иным, как медлительными полутрупами, которых наличествуют лишь два эффективных раздражителя:
еда и сон. Зомби совершенно неразборчивы в выборе пищи и питья, поэтому их тела буквально
пропитаны радиацией и токсинами. Как правило, эти существа бесцельно бродят по Зоне или,
словно трупы, валяются внутри заброшенных построек. Однако, лишь только зомби почует близкое
присутствие живого человека, он сразу же пытается атаковать. Умудрённые опытом сталкеры
стараются обходить эти неуклюжие опустошённые оболочки.</text>
</string>
</pre>

Копируем сюда же файл stable_statistic_caption.xml и изменяем в нем 3 строчки:

<pre> <string id="zombie_normal">
<text>зомбированный, гражданский</text>
</string>
<string id="zombie_strong">
<text>зомби-призрак, гражданский</text>
</string>
<string id="zombie_weak">
<text>зомби, гражданский</text>
</string>
</pre>

Сохраняем и закрываем.

'''7.''' И последнее – добавим иконки. Скажу сразу, воспользовался готовым файлом, уже содержащим иконки зомби и других «восстановленных монстров» (спасибо Fr3nzy). Поэтому просто скопируйте файл ui_npc_monster.dds из архива в папку gamedata\textures\ui\, а файл ui_npc_monster.xml – в папку gamedata\config\ui\. Если вы хотите сделать собственные - прочитайте урок по [[Изменение текстур (BAC9-FLCL)|изменению текстур]].

Вкратце, что описывает файл ui_npc_monster.xml: в нем задаются координаты иконок, расположенных в файле ui_npc_monster.dds, применительно к каждому типу монстров в игре.

Заключительный штрих. Откройте файл m_zombie.ltx и в первой секции замените строку
<pre>icon = ui_npc_monster_kontroler</pre>
На:
<pre>icon = ui_npc_monster_zombie</pre>
В секцию [zombie_ghost] добавьте строку:
<pre>icon = ui_npc_monster_zombieg</pre>

Сохраняйте изменения. Всё.

Вот [http://data.cod.ru/1290894794 готовые файлы примера].
Удачи и спасибо за внимание :)

==Спавн NPC==

Эта часть статьи написана [[Участник:Arhet|Arhet]] и создана на примере того, как в SRP Mod были созданы NPC группировки "Грех".

Задействуем файлы:

* gamedata\config\gameplay\character_desc_escape.xml
* gamedata\config\gameplay\npc_profile.ltx
* gamedata\config\creatures\spawn_sections.ltx

Начнем с ''character_desc_escape.xml''. Описание что значит каждая строка писать не буду, так как все до меня уже сделано.

Тут создадим нового персонажа:

<pre><specific_character id="esc_dark_stalker_1" team_default = "1">
<name>GENERATE_NAME_bandit</name>
<icon>ui_npc_dark_1</icon>
<map_icon x="0" y="0"></map_icon>
<bio>sim_stalker_novice_bio</bio>

<class>esc_dark_stalker_01</class> - вот тут наш новый класс кстати.
<community>dark_stalker</community> <terrain_sect>stalker_terrain</terrain_sect>
<money min="200" max="600" infinitive="0"></money>

<rank>198</rank>
<reputation>-24</reputation>

<visual>actors\dark_stalker\dark_stalker_1</visual>
<snd_config>characters_voice\human_01\monolith\</snd_config>
<crouch_type>-1</crouch_type>
<panic_treshold>0</panic_treshold>
<supplies>
[spawn] \n
wpn_dark_colt1911 \n
ammo_11.43x23_hydro \n
#include "gameplay\character_items.xml" \n
#include "gameplay\character_drugs.xml" \n
#include "gameplay\character_food.xml"
</supplies>

#include "gameplay\character_criticals_3.xml"

<start_dialog>dm_hello_dialog</start_dialog>
<actor_dialog>dm_cool_info_dialog</actor_dialog>
</specific_character></pre>

Впишем наш код после какого-нибудь </specific_character>

Теперь идем в ''npc_profile.xml'' и туда вгоняем:

<pre><character id="esc_dark_stalker_1">
<class>esc_dark_stalker_01</class>
<specific_character>esc_dark_stalker_1</specific_character>
</character></pre>

Теперь надо заняться ''spawn_sections.ltx''. Скрипт будет «брать NPC» как раз из этого файла. Пишем туда:

* [esc_dark_stalker_1]:stalker – имя секции для скрипта..
* $spawn = "respawn\esc_dark_stalker_1"
* character_profile = esc_dark_stalker_1 – ссылка на описание нашего NPC
* spec_rank = regular – спец ранг
* community = dark_stalker – группировка.

Теперь берем любой скрипт спавна NPC, вгоняем туда имя секции из spawn_sections.ltx и ву-а-ля.

Тока забыли что данному НПС будет присвоенная дефолтовая логика (т.е. тупо хожу куда сам не знаю) забыли упомянуть про (ххх - лока): 
ххх gulag.script (действия НПС! Где можно: где можно присвоить статус кампера; волкера; и.д.т) 
ххх gulag.ltx (дублер логики т.е. дублирует кратко действия НПС)

==Авторы==

Статья создана:

* [[Участник:XStream|xStream]]
* [[Участник:RekLatS|OffBar]]
* [[Участник:Fr3nzy|Fr3nzy]]
* [[Участник:Imp|Imp]]
* [[Участник:Arhet|Arhet]]

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

Спавн через скрипт

2008-08-10T09:50:25Z

89.178.50.109: /* Спавн NPC */

==Теория==

В скриптах есть одна единственная функция, отвечающая за спавн объектов:
<pre>alife():create(section,position,levelvertex,gamevertex)</pre>

Строго говоря, их две: create create_ammo но различия между ними не существенны. [[Участник:Imp|Imp]] 22:45, 23 июля 2007 (EEST)

Первый параметр - секция в конфигурациях, описывающая объект, например "bolt","med_kit" - это простые секции, простых объектов
а есть объекты, которые переходят в онлайн/оффлайн, это неписи, монстры и так далее, например mil_killer_respawn_2 - спавнится снайпер группировки киллеров.

С позицией, думаю объяснять не надо, только существует нюанс - высота это Y, а не Z.
Задать позицию можно такой конструкцией vector():set(x,y,z), где x, y и z - координаты точки на уровне, где спавним объект.

Дальше сложнее, так как сам толком сформулировать не могу.

Начнем от простого к сложному. На каждом уровне много объектов, все объекты состоят из полигонов, у каждого полигона есть вершины – вертексы.

Именно они и должны здесь указываться, зачем - не особо понимаю, скорее всего для точного позиционирования объекта.
Например, можно получить вертекс ближайший к актору - db.actor:level_vertex()

Дальше идет гораздо более интересный параметр game_vertex, это почти то же самое, что и level_vertex, но (!) это глобальные величины!
Если level_vertex считается для уровня, то game_vertex - для всей игры, и нужен он для того, чтобы указать на какой карте спавнить объект (более вразумительного объяснения я не нашел).

Соответственно, чтобы заспавнить что-нибудь на другой карте, достаточно указать game_vertex в четвертом параметре
Например:
<pre>db.actor:game_vertex()</pre>

Итак, чтобы, например, заспавнить болт под ногами актора, пишем:
<pre>alife():create("bolt",db.actor():position(),1,db.actor:game_verte())</pre>

Почему 1, а не level_vertex? Проверено - разницы особой нет, какой level_vertex, хотя в некоторых случаях надо прописывать валидный вертекс, а то предмет может просто заспавнится не там, где планировалось... Но по большей части все проходит нормально и с единицей.
(Игнорирование level_vertex может приводить к проваливанию произведенных предметов/персонажей под землю.)
А вот game_vertex решает все - он указывает на каком уровне спавнить предмет, поэтому его надо указывать. Теоретически можно просто найти для каждого уровня по одному game_vertex'у и использовать их в скриптах.
На самом деле game_vertex показывает какой фрагмент карты используется (вся карта разбита на кусочки имеющие сквозную нумерацию по всем уровням и game_vertex выбирает нужный) соответсвенно неправильное использование черевато....

Кроме того - есть еще один параметр - ID объекта, если указать ID NPC или актора - то предмет заспавнится у него в инвентаре.

Пример (спавним артефакт Медуза в инвентаре у актора):
<pre>alife():create("af_medusa", db.actor():position(), 1, db.actor:game_vertex(), db.actor:id())</pre>

Функция спавна возвращает серверный объект, то есть ни NPC, ни монстра ни что-либо еще.

Серверный обьект позволяет свеже созданного NPC или тайник затарить разными рулезами/артефактами. Например, вот так создадим перед входом к Сидоровичу долговца и засунем в него пачку патронов:
<pre>
local obj
local a = vector() -- Задаем тип переменной
local dir = db.actor:direction()

a.x = -243.61 -- координата X
a.y = -19.52 -- высота Y
a.z = -127.17 -- координата Z

obj = alife():create("bar_dolg_respawn_3",a,13193,8,65535)
alife():create_ammo("ammo_9x18_fmj",
obj.position,
obj.m_level_vertex_id,
obj.m_game_vertex_id,
obj.id,
20) -- число патронов</pre>

Кстати, create_ammo - практически тоже самое, что и create, разница в том, что create_ammo предназначена специально для спавна патронов и позволяет создавать неполные пачки патронов. Возможно есть еще какие-то отличия. Стоит учесть, что сами авторы игры спавнят патроны исключительно через create_ammo. [[Участник:Imp|Imp]] 22:38, 23 июля 2007 (EEST)

Просто минимальный набор - координаты, ID, секция,а из него (серверного объекта) обычно нужен только ID, так как по ID можно получить этот самый серверный объект:
<pre>(alife():object(id))</pre>

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

Например надо решить следующую задачу - надо создать наемника, сменить ему группировку и изменить его инвентарь, ну и в нагрузку - сделать другом для игрока.

В определенный момент заспавненый объект переходит онлайн, в этот момент вызывается callback - net_spawn.

Что мы делаем? Сверяем ID онлайн объекта с сохраненным ID!

Если они совпадают, например так:
<pre>if obj:id()==saved_id then ...</pre>

Важно то, что у серверного объекта ID - это параметр, а у онлайнового объекта ID получается с помощью функции. Это важно, а то можно прогореть.

Итак, мы поймали нашего киллера по ID.

Далее все очень просто - вызываем команды для спавна гаусса и патронов к нему в инвентаре NPC (см. выше), меняем группировку специальной функцией, и делаем его другом.

Зачем такие сложности? Просто в оффлайне NPC как бы не существует, есть только косвенное упоминание о нем, и, плюс, все эти функции работают именно с объектом типа "NPC", а не с серверными объектами.

==Практика (часть 1)==

'''1.''' Чтобы не повторяться в описании создания нового квеста, просто изучите [[Создание квестов (Fr3nzy)|статью по созданию квестов]] от Fr3nzy – лучшей статьи на эту тему я просто не видел :) Мы просто свяжем все воедино и научимся спавнить объекты из скрипта.

Небольшое отступление:

Почему предпочтительнее делать спавн скриптом, а не через тот же xrSpawner? Программа xrSpawner, при всех своих достоинствах, обладает одним недостатком, а именно – она делает спавн через файл all.spawn, что приводит к:

* Невозможности совместить два мода, такой спавн использующих
* Необходимости каждый раз начинать новую игру

При спавне через скрипт ситуация иная: в подавляющем большинстве случаев, ранее сохраненные игры будут работать, что не может не радовать :)

Итак, определимся с квестом.

'''Задача:''' после разговора с Сидоровичем спавним зомби на территории фабрики в первой локации. Для того, чтобы не повредить оригинальный сюжет игры, задание будет выдаваться '''после''' прохождения квеста с флешкой Шустрого, так как появись там зомби одновременно с бандитами и Шустрым... я думаю, исход боя предрешен :)

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

В консоли введите команду:

<pre>rs_stats on или rs_stats 1 </pre>

Тем самым мы включаем вывод информации на экран.
Далее вводим еще одну команду:

<pre>demo_record 1 </pre>

И «летим» на фабрику. Нам нужно выбрать место для спавна объектов и данный режим как нельзя лучше подходит для реализации задуманного. Помещаем камеру в точке предполагаемого спавна и записываем координаты - у меня получились 115, -6, -16.

Для выхода из режима demo_record нажимаем Esc, в консоли пишем rs_stats off или rs_stats 0 (убираем вывод информации).

Другой способ получения тех же сведений - прийти в нужное место и запустить там скрипт, который выдаст все нужные координаты. Я пользуюсь следующим скриптом (вызываю общеизвестным способом, через main_menu):
<pre>
function main_menu:main_cheat_f3()
-- Выдадим сообщение о нашем местоположении
local text
local vid
local gvid
local a = vector() -- Тип переменной
local text

a = db.actor:position() -- Наше положение в координатах
vid = db.actor:level_vertex_id()
gvid = db.actor:game_vertex_id()
text = "Позиция:\\nX= "..a.x.."\\nY= "..a.y.."\\nZ= "..a.z.."\\nlevel_vertex= "..vid.."\\ngame_vertex_id= "..gvid
news_manager.send_tip(db.actor, text, nil, nil, 30000)
end
</pre>
В результате не нужно эксперементировать мы сразу получаем все, в том числе и level_vertex и game_vertex. [[Участник:Imp|Imp]] 22:38, 23 июля 2007 (EEST)

Выходим из игры, идем в папку с установленной игрой и создаем каталог gamedata (предполагается, что «лепим» свой «мод» на «чистую» игру, без установленных модов, и имеем распакованные ресурсы игры в папке, скажем, gamedata source).

В папке gamedata создаем папку config, а в ней - папку creatures. Скопируем из оригинальной папки файл m_zombie.ltx и откроем его на редактирование.

В файлах игры присутствуют 5 моделей гражданских зомби:

<pre>файлы zombi_1.ogf, zombi_1_ghost.ogf, zombi_2.ogf, zombi_trup.ogf, zombi_trup_2.ogf</pre>

Вернем в игру их всех :)

Уже имеются секции:

<pre>[zombie_weak]:m_zombie_e, [zombie_normal]:m_zombie_e, [zombie_strong]:m_zombie_e и [zombie_immortal]:zombie_strong. </pre>

Два последних типа используют одну и ту же модель zombi_trup.ogf, хм... непорядок, исправляем.
Последняя секция выглядит теперь так:

<pre>[zombie_immortal]:zombie_strong
$spawn = "monsters\zombies\zombie_immortal"
visual = monsters\zombi\zombi_trup_2
panic_threshold = 0.05 </pre>

Добавим пятую модель.

Для этого в конце файла создадим секцию:
<pre>[zombie_ghost]:zombie_strong</pre>

Это означает, что наш пятый зомби наследует все параметры zombie_strong, мы добавим лишь визуальное представление.

Пишем дальше:

<pre>$spawn = "monsters\zombies\zombie_ghost"
visual = monsters\zombi\zombi_1_ghost</pre>

Все. Сохраняем изменения и закрываем файл.

'''2.''' Пишем скрипт спавна. В папке gamedata создаем новую папку scripts, в ней создаем новый текстовый документ и называем его esc_zombie.script.

Отступление третье:

При написании статьи использовался оригинальный скрипт zombie_story.script из horror-mod’а. Концепция спавна перенесена практически без изменений, поэтому на авторство этого способа спавна я никоим образом не претендую :)

Итак, открываем наш пустой файл на редактирование, первой строкой объявляем переменную, в которой хранятся наши зомби:

<pre>local zombie_types = {"zombie_weak", "zombie_normal", "zombie_strong", "zombie_immortal", "zombie_ghost"}</pre>

Далее пишем функцию:

<pre>function spawn_zombies( position, total )
local zombie_index -- тип зомби из массива zombie_types
local new_pos, x_offset, z_offset -- объявляем переменные
for zombie_index=1, total do -- крутим цикл столько раз, сколько
задает переменная total
x_offset = math.random(5) -- случайное (рандомное) x от 1 до 5
z_offset = math.random(5) -- случайное (рандомное) z от 1 до 5
new_pos = position -- передаем координаты в функцию
new_pos.x = new_pos.x + x_offset -- прибавляем к указанной нами
координате x полученное выше рандомное x
new_pos.z = new_pos.z + z_offset -- прибавляем к указанной нами
координате z полученное выше рандомное z
-- Ниже, собственно и вызывается функция спавна случайного типа зомби
zombie_types[math.random(5)] привязанного к нашим координатам
alife():create(zombie_types[math.random(5)],new_pos,db.actor:level_vertex_id(),db.actor:game_vertex_id())
end
end </pre>

И последнее:

<pre>function zomby_story_1( actor, npc )
-- десять зомби на фабрике (Кордон)
local spawn_point = vector():set( 115, -6, -16 ) -- здесь указываем координаты,
выбранные нами для спавна, когда «летали» камерой :)
spawn_zombies( spawn_point, 10 ) -- собственно вызов предыдущей функции
с передачей ей координат и количества объектов
end</pre>

Все. Сохраняем и закрываем файл.

Продолжаем разговор :)

Для того, чтобы игра не вылетала после того, как мы добавили новый тип монстров, их нужно добавить в файл xr_statistic.script. Итак, скопируем этот файл из папки игры scripts в нашу папку к файлу esc_zombie.script и откроем на редактирование.

Добавим в local killCountProps к монстрам строчку:
<pre> zombie_weak = 1, zombie_normal = 2, zombie_strong = 3</pre>

В local sect_alias строчку:
<pre> zombie_weak = "zombie_weak", zombie_normal = "zombie_normal", zombie_strong = "zombie_strong"</pre>
А ниже в monster_classes строчку:
<pre> [clsid.zombie_s ] = "zombie"</pre>
В функцию getNpcType(npc) добавляем конструкцию:
<pre> elseif npc:character_community() == "zombie" then
community = "zombie"</pre>

Сохраняем изменения и закрываем файл.

Все будет работать на ура, пока мы не попробуем обыскать убитого зомби. Как только мы это сделаем, игра вылетит с примерно такой ошибкой.

<pre>Expression : fatal error
Function : CInifile::r_string
File : D:\xray-svn\xrCore\Xr_ini.cpp
Line : 351
Description : <no expression>
Arguments : Can't find variable icon in [zombie_weak]</pre>

Все верно – игра не знает какую иконку нам показывать для зомби. Иконки монстров хранятся в файле ui_npc_monster.dds. Здесь есть два варианта:

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

Вернемся к файлу m_zombie.ltx и в секцию [m_zombie_e]:monster_base впишем параметр
<pre> icon = ui_npc_monster_kontroler</pre>

Все. Вылетов не будет.

3. Тема данной статьи не предусматривает подробного описания того, как сделать новый диалог. В начале статьи я упомянул источник, где можно найти исчерпывающую информацию по созданию диалогов, могу также привести в пример [[Создание диалогов (BAC9-FLCL)|статью по созданию диалогов]] от BAC9-FLCL.

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

<pre> <dialog id="escape_trader_talk_info">
………
<phrase id="999">
<text>escape_trader_talk_info_999</text>
<next>7770</next>
<next>9991</next>
<next>9992</next>
<next>9993</next>
<next>9994</next>
<next>9995</next>
<next>9996</next>
</phrase>
<phrase id="9992">
<text>escape_trader_talk_info_9992</text>
<next>99922</next>
</phrase>
<phrase id="99922">
<text>escape_trader_talk_info_99922</text>
<next>9996</next>
<next>9995</next>
</phrase>
<phrase id="9993">
<text>escape_trader_talk_info_9993</text>
<next>99933</next>
</phrase>
<phrase id="9995">
<text>escape_trader_talk_info_9995</text>
</phrase>
<phrase id="3121">
<text>escape_trader_talk_info_3121</text>
<next>9996</next>
<next>9995</next>
</phrase>
<phrase id="3131">
<text>escape_trader_talk_info_3131</text>
<next>9996</next>
<next>9995</next>
</phrase>
<phrase id="41">
<text>escape_trader_talk_info_41</text>
<next>9996</next>
<next>9995</next>
</phrase>

<phrase id="7770">
<text>escape_trader_talk_info_7770</text>
<next>7771</next>
</phrase>
<phrase id="7771">
<text>escape_trader_talk_info_7771</text>
<next>7772</next>
<next>7773</next>
</phrase>
<phrase id="7772">
<text>escape_trader_talk_info_7772</text>
<next>7777</next>
</phrase>
<phrase id="7773">
<text>escape_trader_talk_info_7773</text>
<next>7779</next>
</phrase>
<phrase id="7779">
<text>escape_trader_talk_info_7779</text>
<next>9996</next>
<next>9995</next>
</phrase>
<phrase id="7777">
<text>escape_trader_talk_info_7777</text>
<action>esc_zombie.zombie_story_1</action>
<next>9996</next>
<next>9995</next>
</phrase>

<phrase id="51">
<text>escape_trader_talk_info_51</text>
<next>9996</next>
<next>9995</next>
</phrase>
……
</dialog></pre>

И также связанный с ним файл stable_dialogs_escape.xml.
В самом начале файла пишем следующее:

<pre> <string id="escape_trader_talk_info_7770">
<text>Происшествий никаких не было?</text>
</string>
<string id="escape_trader_talk_info_7771">
<text>Да знаешь... Вроде как тихо все у нас. Хотя, вот, вспомнил! Говорили мне
на днях, что на фабрике, ну, там, где бандюки околачиваются постоянно, видели какиих-то то ли
людей, то ли призраков... Мало ли что спьяну почудится - я и сказал этим паникерам, мол,
закусывать надо! Хех, блин, алкаши...</text>
</string>
<string id="escape_trader_talk_info_7772">
<text>Дык мне по любому мимо фабрики топать - заодно и посмотрю на этих
"людей-призраков".</text>
</string>
<string id="escape_trader_talk_info_7773">
<text>Да я как-то не собирался в ту сторону...</text>
</string>
<string id="escape_trader_talk_info_7779">
<text>Ну, смотри сам, все равно будь осторожен.</text>
</string>
<string id="escape_trader_talk_info_7777">
<text>Ага. Сходи, проветрись. Потом зайдешь, расскажешь, что там и как.</text>
</string>
<string id="esc_bridge_soldiers_start_11">
<text>Здесь проход воспрещён, сталкер.</text>
</string></pre>

Все. Можно запускать игру, идти на Кордон, после разговороа с Сидоровичем, в зависимости
от выбранного Меченным решения, бежим на фабрику и … смотрим сами :)

[http://www.sendspace.com/file/2kx7uf Готовые файлы примера](перезалито)
[http://slil.ru/24600587 Spawn Lib]
Домашнее задание - вернуть в игру 6-ой тип гражданского зомби :)

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

==Практика (часть 2)==

'''4.''' Сегодня мы закончим с зомби в полном объеме – добавим их описания в энциклопедию, добавим иконки, и разберемся с «домашним заданием»:) Думаю, что внимательно изучив эту статью, вы ''сами'' сможете через скриптовые функции восстановить любого персонажа, не вошедшего в финальный релиз игры. Если у кого хватит времени и желания, те могут даже написать что-то типа «Ночи живых мертвецов» :) - серию квестов, связанную своим собственным сюжетом.
Итак, «домашнее задание» - добавляем в игру шестого зомби.

* Создаем в папке gamedata папку meshes, в ней папку monsters, а там – папку zombi. В папке meshes хранятся модели персонажей, объектов, окружения, присутствующих в игре. Как я уже говорил выше, в игре представлено 5 моделей гражданских зомби, а вот текстур – 6. Также немного смутила нумерация моделей – 1, 2, 4... А где третий? Наверное, сбежал :)

* Скопируем из папки с оригинальными файлами игры в созданную нами папку zombi файл zombi_2.ogf и переименуем его в zombi_3.ogf. Откроем файл нашей новой модели любым HexEditor’ом, я использую BiEd (Binary Editor 1.00). Так как данная статья рассчитана не только на «продвинутых юзеров», но и на «обычных чайников», которые, тем не менее, хотят «что-нить замутить» и при этом не сильно «парить моск», я не буду рассказывать здесь про адресацию, двухбайтовую запись и т.д., я просто наглядно покажу, где что поправить :)

[http://www.golushkov.pp.net.ua/photo/11-0-717-3 Файл модели '''до''' редактирования]

[http://www.golushkov.pp.net.ua/photo/11-0-718-3 Файл модели '''после''' редактирования]

На скринах видно, что мы просто изменили для этой модели путь к текстуре. Все. Без использования 3D-редакторов и затраты кучи времени на обработку модели в них, мы получили абсолютно новую (на внешний вид) модель. :)

'''5.''' Теперь пропишем нашего нового зомби во все файлы, которые мы создали ранее. В файл m_zombie.ltx в самый конец добавляем секцию:

<pre>[zombie_old]:zombie_normal
$spawn = "monsters\zombies\zombie_old"
visual = monsters\zombi\zombi_3</pre>

в файле esc_zombie.script изменяем массив в первой строке:

<pre>local zombie_types = {"zombie_weak", "zombie_normal", "zombie_strong", "zombie_immortal",
"zombie_old", "zombie_ghost"}</pre>

В функции spawn_zombies изменяем строку спавна:

<pre> alife():create(zombie_types[math.random(6)],new_pos,
db.actor:level_vertex_id(),db.actor:game_vertex_id())</pre>
в функции zombie_story_1 меняем число объектов на кратное 6-ти (необязательно):

<pre> spawn_zombies( spawn_point, 12 )</pre>

Всё. Сохраняем и закрываем.

'''6.''' Копируем в папку gamedata\config\gameplay\ файл encyclopedia_mutants.xml, добавляем описание зомби в энциклопедию:

<pre> 

<article id="mutant_zombieg_general" name="Zombieg" group="Mutants">
<texture>ui_npc_monster_zombieg</texture>
<text>enc_mutant_zombieg_general</text>
</article>
</pre>

И в связанный с ним файл string_table_enc_mutants.xml в папке gamedata\config\text\rus\ добавляем:

<pre> <string id="Zombie">
<text>Зомби, гражданский</text>
</string>
<string id="Zombieg">
<text>Зомби-призрак, гражданский</text>
</string>
<string id="enc_mutant_zombieg_general">
<text>Зомби-привидение отличается от обычного зомби лишь тем, что
воздействие Выжигателя мозгов полностью разрушило не только структуру личности, но и
тело, поэтому зомби-призрак несколько более живуч по сравнению с обычным зомби.</text>
</string>
<string id="enc_mutant_zombie_general">
<text>Воздействие Выжигателя мозгов полностью разрушает структуру личности,
оставляя только телесную оболочку.\n\n Побродив немного по Зоне, лишённые разума тела
начинают превращаться в настоящих зомби. Из рефлексов у них остаются лишь самые примитивные,
оружие и экипировка скоро приходят в негодность. В результате зомби становятся собой ни чем
иным, как медлительными полутрупами, которых наличествуют лишь два эффективных раздражителя:
еда и сон. Зомби совершенно неразборчивы в выборе пищи и питья, поэтому их тела буквально
пропитаны радиацией и токсинами. Как правило, эти существа бесцельно бродят по Зоне или,
словно трупы, валяются внутри заброшенных построек. Однако, лишь только зомби почует близкое
присутствие живого человека, он сразу же пытается атаковать. Умудрённые опытом сталкеры
стараются обходить эти неуклюжие опустошённые оболочки.</text>
</string>
</pre>

Копируем сюда же файл stable_statistic_caption.xml и изменяем в нем 3 строчки:

<pre> <string id="zombie_normal">
<text>зомбированный, гражданский</text>
</string>
<string id="zombie_strong">
<text>зомби-призрак, гражданский</text>
</string>
<string id="zombie_weak">
<text>зомби, гражданский</text>
</string>
</pre>

Сохраняем и закрываем.

'''7.''' И последнее – добавим иконки. Скажу сразу, воспользовался готовым файлом, уже содержащим иконки зомби и других «восстановленных монстров» (спасибо Fr3nzy). Поэтому просто скопируйте файл ui_npc_monster.dds из архива в папку gamedata\textures\ui\, а файл ui_npc_monster.xml – в папку gamedata\config\ui\. Если вы хотите сделать собственные - прочитайте урок по [[Изменение текстур (BAC9-FLCL)|изменению текстур]].

Вкратце, что описывает файл ui_npc_monster.xml: в нем задаются координаты иконок, расположенных в файле ui_npc_monster.dds, применительно к каждому типу монстров в игре.

Заключительный штрих. Откройте файл m_zombie.ltx и в первой секции замените строку
<pre>icon = ui_npc_monster_kontroler</pre>
На:
<pre>icon = ui_npc_monster_zombie</pre>
В секцию [zombie_ghost] добавьте строку:
<pre>icon = ui_npc_monster_zombieg</pre>

Сохраняйте изменения. Всё.

Вот [http://data.cod.ru/1290894794 готовые файлы примера].
Удачи и спасибо за внимание :)

==Спавн NPC==

Эта часть статьи написана [[Участник:Arhet|Arhet]] и создана на примере того, как в SRP Mod были созданы NPC группировки "Грех".

Задействуем файлы:

* gamedata\config\gameplay\character_desc_escape.xml
* gamedata\config\gameplay\npc_profile.ltx
* gamedata\config\creatures\spawn_sections.ltx

Начнем с ''character_desc_escape.xml''. Описание что значит каждая строка писать не буду, так как все до меня уже сделано.

Тут создадим нового персонажа:

<pre><specific_character id="esc_dark_stalker_1" team_default = "1">
<name>GENERATE_NAME_bandit</name>
<icon>ui_npc_dark_1</icon>
<map_icon x="0" y="0"></map_icon>
<bio>sim_stalker_novice_bio</bio>

<class>esc_dark_stalker_01</class> - вот тут наш новый класс кстати.
<community>dark_stalker</community> <terrain_sect>stalker_terrain</terrain_sect>
<money min="200" max="600" infinitive="0"></money>

<rank>198</rank>
<reputation>-24</reputation>

<visual>actors\dark_stalker\dark_stalker_1</visual>
<snd_config>characters_voice\human_01\monolith\</snd_config>
<crouch_type>-1</crouch_type>
<panic_treshold>0</panic_treshold>
<supplies>
[spawn] \n
wpn_dark_colt1911 \n
ammo_11.43x23_hydro \n
#include "gameplay\character_items.xml" \n
#include "gameplay\character_drugs.xml" \n
#include "gameplay\character_food.xml"
</supplies>

#include "gameplay\character_criticals_3.xml"

<start_dialog>dm_hello_dialog</start_dialog>
<actor_dialog>dm_cool_info_dialog</actor_dialog>
</specific_character></pre>

Впишем наш код после какого-нибудь </specific_character>

Теперь идем в ''npc_profile.xml'' и туда вгоняем:

<pre><character id="esc_dark_stalker_1">
<class>esc_dark_stalker_01</class>
<specific_character>esc_dark_stalker_1</specific_character>
</character></pre>

Теперь надо заняться ''spawn_sections.ltx''. Скрипт будет «брать NPC» как раз из этого файла. Пишем туда:

* [esc_dark_stalker_1]:stalker – имя секции для скрипта..
* $spawn = "respawn\esc_dark_stalker_1"
* character_profile = esc_dark_stalker_1 – ссылка на описание нашего NPC
* spec_rank = regular – спец ранг
* community = dark_stalker – группировка.

Теперь берем любой скрипт спавна NPC, вгоняем туда имя секции из spawn_sections.ltx и ву-а-ля.

Тока забыли что данному НПС будет присвоенная дефолтовая логика (т.е. тупо хожу куда сам не знаю) забыли упомянуть про (ххх - лока): 
+ 
+ ххх gulag.script (действия НПС! Где можно: где можно присвоить статус кампера; волкера; и.д.т) 
+ 
+ ххх gulag.ltx (дублер логики т.е. дублирует кратко действия НПС)

==Авторы==

Статья создана:

* [[Участник:XStream|xStream]]
* [[Участник:RekLatS|OffBar]]
* [[Участник:Fr3nzy|Fr3nzy]]
* [[Участник:Imp|Imp]]
* [[Участник:Arhet|Arhet]]

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

Спавн через скрипт

2008-08-10T09:49:51Z

89.178.50.109: /* Спавн NPC */

==Теория==

В скриптах есть одна единственная функция, отвечающая за спавн объектов:
<pre>alife():create(section,position,levelvertex,gamevertex)</pre>

Строго говоря, их две: create create_ammo но различия между ними не существенны. [[Участник:Imp|Imp]] 22:45, 23 июля 2007 (EEST)

Первый параметр - секция в конфигурациях, описывающая объект, например "bolt","med_kit" - это простые секции, простых объектов
а есть объекты, которые переходят в онлайн/оффлайн, это неписи, монстры и так далее, например mil_killer_respawn_2 - спавнится снайпер группировки киллеров.

С позицией, думаю объяснять не надо, только существует нюанс - высота это Y, а не Z.
Задать позицию можно такой конструкцией vector():set(x,y,z), где x, y и z - координаты точки на уровне, где спавним объект.

Дальше сложнее, так как сам толком сформулировать не могу.

Начнем от простого к сложному. На каждом уровне много объектов, все объекты состоят из полигонов, у каждого полигона есть вершины – вертексы.

Именно они и должны здесь указываться, зачем - не особо понимаю, скорее всего для точного позиционирования объекта.
Например, можно получить вертекс ближайший к актору - db.actor:level_vertex()

Дальше идет гораздо более интересный параметр game_vertex, это почти то же самое, что и level_vertex, но (!) это глобальные величины!
Если level_vertex считается для уровня, то game_vertex - для всей игры, и нужен он для того, чтобы указать на какой карте спавнить объект (более вразумительного объяснения я не нашел).

Соответственно, чтобы заспавнить что-нибудь на другой карте, достаточно указать game_vertex в четвертом параметре
Например:
<pre>db.actor:game_vertex()</pre>

Итак, чтобы, например, заспавнить болт под ногами актора, пишем:
<pre>alife():create("bolt",db.actor():position(),1,db.actor:game_verte())</pre>

Почему 1, а не level_vertex? Проверено - разницы особой нет, какой level_vertex, хотя в некоторых случаях надо прописывать валидный вертекс, а то предмет может просто заспавнится не там, где планировалось... Но по большей части все проходит нормально и с единицей.
(Игнорирование level_vertex может приводить к проваливанию произведенных предметов/персонажей под землю.)
А вот game_vertex решает все - он указывает на каком уровне спавнить предмет, поэтому его надо указывать. Теоретически можно просто найти для каждого уровня по одному game_vertex'у и использовать их в скриптах.
На самом деле game_vertex показывает какой фрагмент карты используется (вся карта разбита на кусочки имеющие сквозную нумерацию по всем уровням и game_vertex выбирает нужный) соответсвенно неправильное использование черевато....

Кроме того - есть еще один параметр - ID объекта, если указать ID NPC или актора - то предмет заспавнится у него в инвентаре.

Пример (спавним артефакт Медуза в инвентаре у актора):
<pre>alife():create("af_medusa", db.actor():position(), 1, db.actor:game_vertex(), db.actor:id())</pre>

Функция спавна возвращает серверный объект, то есть ни NPC, ни монстра ни что-либо еще.

Серверный обьект позволяет свеже созданного NPC или тайник затарить разными рулезами/артефактами. Например, вот так создадим перед входом к Сидоровичу долговца и засунем в него пачку патронов:
<pre>
local obj
local a = vector() -- Задаем тип переменной
local dir = db.actor:direction()

a.x = -243.61 -- координата X
a.y = -19.52 -- высота Y
a.z = -127.17 -- координата Z

obj = alife():create("bar_dolg_respawn_3",a,13193,8,65535)
alife():create_ammo("ammo_9x18_fmj",
obj.position,
obj.m_level_vertex_id,
obj.m_game_vertex_id,
obj.id,
20) -- число патронов</pre>

Кстати, create_ammo - практически тоже самое, что и create, разница в том, что create_ammo предназначена специально для спавна патронов и позволяет создавать неполные пачки патронов. Возможно есть еще какие-то отличия. Стоит учесть, что сами авторы игры спавнят патроны исключительно через create_ammo. [[Участник:Imp|Imp]] 22:38, 23 июля 2007 (EEST)

Просто минимальный набор - координаты, ID, секция,а из него (серверного объекта) обычно нужен только ID, так как по ID можно получить этот самый серверный объект:
<pre>(alife():object(id))</pre>

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

Например надо решить следующую задачу - надо создать наемника, сменить ему группировку и изменить его инвентарь, ну и в нагрузку - сделать другом для игрока.

В определенный момент заспавненый объект переходит онлайн, в этот момент вызывается callback - net_spawn.

Что мы делаем? Сверяем ID онлайн объекта с сохраненным ID!

Если они совпадают, например так:
<pre>if obj:id()==saved_id then ...</pre>

Важно то, что у серверного объекта ID - это параметр, а у онлайнового объекта ID получается с помощью функции. Это важно, а то можно прогореть.

Итак, мы поймали нашего киллера по ID.

Далее все очень просто - вызываем команды для спавна гаусса и патронов к нему в инвентаре NPC (см. выше), меняем группировку специальной функцией, и делаем его другом.

Зачем такие сложности? Просто в оффлайне NPC как бы не существует, есть только косвенное упоминание о нем, и, плюс, все эти функции работают именно с объектом типа "NPC", а не с серверными объектами.

==Практика (часть 1)==

'''1.''' Чтобы не повторяться в описании создания нового квеста, просто изучите [[Создание квестов (Fr3nzy)|статью по созданию квестов]] от Fr3nzy – лучшей статьи на эту тему я просто не видел :) Мы просто свяжем все воедино и научимся спавнить объекты из скрипта.

Небольшое отступление:

Почему предпочтительнее делать спавн скриптом, а не через тот же xrSpawner? Программа xrSpawner, при всех своих достоинствах, обладает одним недостатком, а именно – она делает спавн через файл all.spawn, что приводит к:

* Невозможности совместить два мода, такой спавн использующих
* Необходимости каждый раз начинать новую игру

При спавне через скрипт ситуация иная: в подавляющем большинстве случаев, ранее сохраненные игры будут работать, что не может не радовать :)

Итак, определимся с квестом.

'''Задача:''' после разговора с Сидоровичем спавним зомби на территории фабрики в первой локации. Для того, чтобы не повредить оригинальный сюжет игры, задание будет выдаваться '''после''' прохождения квеста с флешкой Шустрого, так как появись там зомби одновременно с бандитами и Шустрым... я думаю, исход боя предрешен :)

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

В консоли введите команду:

<pre>rs_stats on или rs_stats 1 </pre>

Тем самым мы включаем вывод информации на экран.
Далее вводим еще одну команду:

<pre>demo_record 1 </pre>

И «летим» на фабрику. Нам нужно выбрать место для спавна объектов и данный режим как нельзя лучше подходит для реализации задуманного. Помещаем камеру в точке предполагаемого спавна и записываем координаты - у меня получились 115, -6, -16.

Для выхода из режима demo_record нажимаем Esc, в консоли пишем rs_stats off или rs_stats 0 (убираем вывод информации).

Другой способ получения тех же сведений - прийти в нужное место и запустить там скрипт, который выдаст все нужные координаты. Я пользуюсь следующим скриптом (вызываю общеизвестным способом, через main_menu):
<pre>
function main_menu:main_cheat_f3()
-- Выдадим сообщение о нашем местоположении
local text
local vid
local gvid
local a = vector() -- Тип переменной
local text

a = db.actor:position() -- Наше положение в координатах
vid = db.actor:level_vertex_id()
gvid = db.actor:game_vertex_id()
text = "Позиция:\\nX= "..a.x.."\\nY= "..a.y.."\\nZ= "..a.z.."\\nlevel_vertex= "..vid.."\\ngame_vertex_id= "..gvid
news_manager.send_tip(db.actor, text, nil, nil, 30000)
end
</pre>
В результате не нужно эксперементировать мы сразу получаем все, в том числе и level_vertex и game_vertex. [[Участник:Imp|Imp]] 22:38, 23 июля 2007 (EEST)

Выходим из игры, идем в папку с установленной игрой и создаем каталог gamedata (предполагается, что «лепим» свой «мод» на «чистую» игру, без установленных модов, и имеем распакованные ресурсы игры в папке, скажем, gamedata source).

В папке gamedata создаем папку config, а в ней - папку creatures. Скопируем из оригинальной папки файл m_zombie.ltx и откроем его на редактирование.

В файлах игры присутствуют 5 моделей гражданских зомби:

<pre>файлы zombi_1.ogf, zombi_1_ghost.ogf, zombi_2.ogf, zombi_trup.ogf, zombi_trup_2.ogf</pre>

Вернем в игру их всех :)

Уже имеются секции:

<pre>[zombie_weak]:m_zombie_e, [zombie_normal]:m_zombie_e, [zombie_strong]:m_zombie_e и [zombie_immortal]:zombie_strong. </pre>

Два последних типа используют одну и ту же модель zombi_trup.ogf, хм... непорядок, исправляем.
Последняя секция выглядит теперь так:

<pre>[zombie_immortal]:zombie_strong
$spawn = "monsters\zombies\zombie_immortal"
visual = monsters\zombi\zombi_trup_2
panic_threshold = 0.05 </pre>

Добавим пятую модель.

Для этого в конце файла создадим секцию:
<pre>[zombie_ghost]:zombie_strong</pre>

Это означает, что наш пятый зомби наследует все параметры zombie_strong, мы добавим лишь визуальное представление.

Пишем дальше:

<pre>$spawn = "monsters\zombies\zombie_ghost"
visual = monsters\zombi\zombi_1_ghost</pre>

Все. Сохраняем изменения и закрываем файл.

'''2.''' Пишем скрипт спавна. В папке gamedata создаем новую папку scripts, в ней создаем новый текстовый документ и называем его esc_zombie.script.

Отступление третье:

При написании статьи использовался оригинальный скрипт zombie_story.script из horror-mod’а. Концепция спавна перенесена практически без изменений, поэтому на авторство этого способа спавна я никоим образом не претендую :)

Итак, открываем наш пустой файл на редактирование, первой строкой объявляем переменную, в которой хранятся наши зомби:

<pre>local zombie_types = {"zombie_weak", "zombie_normal", "zombie_strong", "zombie_immortal", "zombie_ghost"}</pre>

Далее пишем функцию:

<pre>function spawn_zombies( position, total )
local zombie_index -- тип зомби из массива zombie_types
local new_pos, x_offset, z_offset -- объявляем переменные
for zombie_index=1, total do -- крутим цикл столько раз, сколько
задает переменная total
x_offset = math.random(5) -- случайное (рандомное) x от 1 до 5
z_offset = math.random(5) -- случайное (рандомное) z от 1 до 5
new_pos = position -- передаем координаты в функцию
new_pos.x = new_pos.x + x_offset -- прибавляем к указанной нами
координате x полученное выше рандомное x
new_pos.z = new_pos.z + z_offset -- прибавляем к указанной нами
координате z полученное выше рандомное z
-- Ниже, собственно и вызывается функция спавна случайного типа зомби
zombie_types[math.random(5)] привязанного к нашим координатам
alife():create(zombie_types[math.random(5)],new_pos,db.actor:level_vertex_id(),db.actor:game_vertex_id())
end
end </pre>

И последнее:

<pre>function zomby_story_1( actor, npc )
-- десять зомби на фабрике (Кордон)
local spawn_point = vector():set( 115, -6, -16 ) -- здесь указываем координаты,
выбранные нами для спавна, когда «летали» камерой :)
spawn_zombies( spawn_point, 10 ) -- собственно вызов предыдущей функции
с передачей ей координат и количества объектов
end</pre>

Все. Сохраняем и закрываем файл.

Продолжаем разговор :)

Для того, чтобы игра не вылетала после того, как мы добавили новый тип монстров, их нужно добавить в файл xr_statistic.script. Итак, скопируем этот файл из папки игры scripts в нашу папку к файлу esc_zombie.script и откроем на редактирование.

Добавим в local killCountProps к монстрам строчку:
<pre> zombie_weak = 1, zombie_normal = 2, zombie_strong = 3</pre>

В local sect_alias строчку:
<pre> zombie_weak = "zombie_weak", zombie_normal = "zombie_normal", zombie_strong = "zombie_strong"</pre>
А ниже в monster_classes строчку:
<pre> [clsid.zombie_s ] = "zombie"</pre>
В функцию getNpcType(npc) добавляем конструкцию:
<pre> elseif npc:character_community() == "zombie" then
community = "zombie"</pre>

Сохраняем изменения и закрываем файл.

Все будет работать на ура, пока мы не попробуем обыскать убитого зомби. Как только мы это сделаем, игра вылетит с примерно такой ошибкой.

<pre>Expression : fatal error
Function : CInifile::r_string
File : D:\xray-svn\xrCore\Xr_ini.cpp
Line : 351
Description : <no expression>
Arguments : Can't find variable icon in [zombie_weak]</pre>

Все верно – игра не знает какую иконку нам показывать для зомби. Иконки монстров хранятся в файле ui_npc_monster.dds. Здесь есть два варианта:

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

Вернемся к файлу m_zombie.ltx и в секцию [m_zombie_e]:monster_base впишем параметр
<pre> icon = ui_npc_monster_kontroler</pre>

Все. Вылетов не будет.

3. Тема данной статьи не предусматривает подробного описания того, как сделать новый диалог. В начале статьи я упомянул источник, где можно найти исчерпывающую информацию по созданию диалогов, могу также привести в пример [[Создание диалогов (BAC9-FLCL)|статью по созданию диалогов]] от BAC9-FLCL.

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

<pre> <dialog id="escape_trader_talk_info">
………
<phrase id="999">
<text>escape_trader_talk_info_999</text>
<next>7770</next>
<next>9991</next>
<next>9992</next>
<next>9993</next>
<next>9994</next>
<next>9995</next>
<next>9996</next>
</phrase>
<phrase id="9992">
<text>escape_trader_talk_info_9992</text>
<next>99922</next>
</phrase>
<phrase id="99922">
<text>escape_trader_talk_info_99922</text>
<next>9996</next>
<next>9995</next>
</phrase>
<phrase id="9993">
<text>escape_trader_talk_info_9993</text>
<next>99933</next>
</phrase>
<phrase id="9995">
<text>escape_trader_talk_info_9995</text>
</phrase>
<phrase id="3121">
<text>escape_trader_talk_info_3121</text>
<next>9996</next>
<next>9995</next>
</phrase>
<phrase id="3131">
<text>escape_trader_talk_info_3131</text>
<next>9996</next>
<next>9995</next>
</phrase>
<phrase id="41">
<text>escape_trader_talk_info_41</text>
<next>9996</next>
<next>9995</next>
</phrase>

<phrase id="7770">
<text>escape_trader_talk_info_7770</text>
<next>7771</next>
</phrase>
<phrase id="7771">
<text>escape_trader_talk_info_7771</text>
<next>7772</next>
<next>7773</next>
</phrase>
<phrase id="7772">
<text>escape_trader_talk_info_7772</text>
<next>7777</next>
</phrase>
<phrase id="7773">
<text>escape_trader_talk_info_7773</text>
<next>7779</next>
</phrase>
<phrase id="7779">
<text>escape_trader_talk_info_7779</text>
<next>9996</next>
<next>9995</next>
</phrase>
<phrase id="7777">
<text>escape_trader_talk_info_7777</text>
<action>esc_zombie.zombie_story_1</action>
<next>9996</next>
<next>9995</next>
</phrase>

<phrase id="51">
<text>escape_trader_talk_info_51</text>
<next>9996</next>
<next>9995</next>
</phrase>
……
</dialog></pre>

И также связанный с ним файл stable_dialogs_escape.xml.
В самом начале файла пишем следующее:

<pre> <string id="escape_trader_talk_info_7770">
<text>Происшествий никаких не было?</text>
</string>
<string id="escape_trader_talk_info_7771">
<text>Да знаешь... Вроде как тихо все у нас. Хотя, вот, вспомнил! Говорили мне
на днях, что на фабрике, ну, там, где бандюки околачиваются постоянно, видели какиих-то то ли
людей, то ли призраков... Мало ли что спьяну почудится - я и сказал этим паникерам, мол,
закусывать надо! Хех, блин, алкаши...</text>
</string>
<string id="escape_trader_talk_info_7772">
<text>Дык мне по любому мимо фабрики топать - заодно и посмотрю на этих
"людей-призраков".</text>
</string>
<string id="escape_trader_talk_info_7773">
<text>Да я как-то не собирался в ту сторону...</text>
</string>
<string id="escape_trader_talk_info_7779">
<text>Ну, смотри сам, все равно будь осторожен.</text>
</string>
<string id="escape_trader_talk_info_7777">
<text>Ага. Сходи, проветрись. Потом зайдешь, расскажешь, что там и как.</text>
</string>
<string id="esc_bridge_soldiers_start_11">
<text>Здесь проход воспрещён, сталкер.</text>
</string></pre>

Все. Можно запускать игру, идти на Кордон, после разговороа с Сидоровичем, в зависимости
от выбранного Меченным решения, бежим на фабрику и … смотрим сами :)

[http://www.sendspace.com/file/2kx7uf Готовые файлы примера](перезалито)
[http://slil.ru/24600587 Spawn Lib]
Домашнее задание - вернуть в игру 6-ой тип гражданского зомби :)

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

==Практика (часть 2)==

'''4.''' Сегодня мы закончим с зомби в полном объеме – добавим их описания в энциклопедию, добавим иконки, и разберемся с «домашним заданием»:) Думаю, что внимательно изучив эту статью, вы ''сами'' сможете через скриптовые функции восстановить любого персонажа, не вошедшего в финальный релиз игры. Если у кого хватит времени и желания, те могут даже написать что-то типа «Ночи живых мертвецов» :) - серию квестов, связанную своим собственным сюжетом.
Итак, «домашнее задание» - добавляем в игру шестого зомби.

* Создаем в папке gamedata папку meshes, в ней папку monsters, а там – папку zombi. В папке meshes хранятся модели персонажей, объектов, окружения, присутствующих в игре. Как я уже говорил выше, в игре представлено 5 моделей гражданских зомби, а вот текстур – 6. Также немного смутила нумерация моделей – 1, 2, 4... А где третий? Наверное, сбежал :)

* Скопируем из папки с оригинальными файлами игры в созданную нами папку zombi файл zombi_2.ogf и переименуем его в zombi_3.ogf. Откроем файл нашей новой модели любым HexEditor’ом, я использую BiEd (Binary Editor 1.00). Так как данная статья рассчитана не только на «продвинутых юзеров», но и на «обычных чайников», которые, тем не менее, хотят «что-нить замутить» и при этом не сильно «парить моск», я не буду рассказывать здесь про адресацию, двухбайтовую запись и т.д., я просто наглядно покажу, где что поправить :)

[http://www.golushkov.pp.net.ua/photo/11-0-717-3 Файл модели '''до''' редактирования]

[http://www.golushkov.pp.net.ua/photo/11-0-718-3 Файл модели '''после''' редактирования]

На скринах видно, что мы просто изменили для этой модели путь к текстуре. Все. Без использования 3D-редакторов и затраты кучи времени на обработку модели в них, мы получили абсолютно новую (на внешний вид) модель. :)

'''5.''' Теперь пропишем нашего нового зомби во все файлы, которые мы создали ранее. В файл m_zombie.ltx в самый конец добавляем секцию:

<pre>[zombie_old]:zombie_normal
$spawn = "monsters\zombies\zombie_old"
visual = monsters\zombi\zombi_3</pre>

в файле esc_zombie.script изменяем массив в первой строке:

<pre>local zombie_types = {"zombie_weak", "zombie_normal", "zombie_strong", "zombie_immortal",
"zombie_old", "zombie_ghost"}</pre>

В функции spawn_zombies изменяем строку спавна:

<pre> alife():create(zombie_types[math.random(6)],new_pos,
db.actor:level_vertex_id(),db.actor:game_vertex_id())</pre>
в функции zombie_story_1 меняем число объектов на кратное 6-ти (необязательно):

<pre> spawn_zombies( spawn_point, 12 )</pre>

Всё. Сохраняем и закрываем.

'''6.''' Копируем в папку gamedata\config\gameplay\ файл encyclopedia_mutants.xml, добавляем описание зомби в энциклопедию:

<pre> 

<article id="mutant_zombieg_general" name="Zombieg" group="Mutants">
<texture>ui_npc_monster_zombieg</texture>
<text>enc_mutant_zombieg_general</text>
</article>
</pre>

И в связанный с ним файл string_table_enc_mutants.xml в папке gamedata\config\text\rus\ добавляем:

<pre> <string id="Zombie">
<text>Зомби, гражданский</text>
</string>
<string id="Zombieg">
<text>Зомби-призрак, гражданский</text>
</string>
<string id="enc_mutant_zombieg_general">
<text>Зомби-привидение отличается от обычного зомби лишь тем, что
воздействие Выжигателя мозгов полностью разрушило не только структуру личности, но и
тело, поэтому зомби-призрак несколько более живуч по сравнению с обычным зомби.</text>
</string>
<string id="enc_mutant_zombie_general">
<text>Воздействие Выжигателя мозгов полностью разрушает структуру личности,
оставляя только телесную оболочку.\n\n Побродив немного по Зоне, лишённые разума тела
начинают превращаться в настоящих зомби. Из рефлексов у них остаются лишь самые примитивные,
оружие и экипировка скоро приходят в негодность. В результате зомби становятся собой ни чем
иным, как медлительными полутрупами, которых наличествуют лишь два эффективных раздражителя:
еда и сон. Зомби совершенно неразборчивы в выборе пищи и питья, поэтому их тела буквально
пропитаны радиацией и токсинами. Как правило, эти существа бесцельно бродят по Зоне или,
словно трупы, валяются внутри заброшенных построек. Однако, лишь только зомби почует близкое
присутствие живого человека, он сразу же пытается атаковать. Умудрённые опытом сталкеры
стараются обходить эти неуклюжие опустошённые оболочки.</text>
</string>
</pre>

Копируем сюда же файл stable_statistic_caption.xml и изменяем в нем 3 строчки:

<pre> <string id="zombie_normal">
<text>зомбированный, гражданский</text>
</string>
<string id="zombie_strong">
<text>зомби-призрак, гражданский</text>
</string>
<string id="zombie_weak">
<text>зомби, гражданский</text>
</string>
</pre>

Сохраняем и закрываем.

'''7.''' И последнее – добавим иконки. Скажу сразу, воспользовался готовым файлом, уже содержащим иконки зомби и других «восстановленных монстров» (спасибо Fr3nzy). Поэтому просто скопируйте файл ui_npc_monster.dds из архива в папку gamedata\textures\ui\, а файл ui_npc_monster.xml – в папку gamedata\config\ui\. Если вы хотите сделать собственные - прочитайте урок по [[Изменение текстур (BAC9-FLCL)|изменению текстур]].

Вкратце, что описывает файл ui_npc_monster.xml: в нем задаются координаты иконок, расположенных в файле ui_npc_monster.dds, применительно к каждому типу монстров в игре.

Заключительный штрих. Откройте файл m_zombie.ltx и в первой секции замените строку
<pre>icon = ui_npc_monster_kontroler</pre>
На:
<pre>icon = ui_npc_monster_zombie</pre>
В секцию [zombie_ghost] добавьте строку:
<pre>icon = ui_npc_monster_zombieg</pre>

Сохраняйте изменения. Всё.

Вот [http://data.cod.ru/1290894794 готовые файлы примера].
Удачи и спасибо за внимание :)

==Спавн NPC==

Эта часть статьи написана [[Участник:Arhet|Arhet]] и создана на примере того, как в SRP Mod были созданы NPC группировки "Грех".

Задействуем файлы:

* gamedata\config\gameplay\character_desc_escape.xml
* gamedata\config\gameplay\npc_profile.ltx
* gamedata\config\creatures\spawn_sections.ltx

Начнем с ''character_desc_escape.xml''. Описание что значит каждая строка писать не буду, так как все до меня уже сделано.

Тут создадим нового персонажа:

<pre><specific_character id="esc_dark_stalker_1" team_default = "1">
<name>GENERATE_NAME_bandit</name>
<icon>ui_npc_dark_1</icon>
<map_icon x="0" y="0"></map_icon>
<bio>sim_stalker_novice_bio</bio>

<class>esc_dark_stalker_01</class> - вот тут наш новый класс кстати.
<community>dark_stalker</community> <terrain_sect>stalker_terrain</terrain_sect>
<money min="200" max="600" infinitive="0"></money>

<rank>198</rank>
<reputation>-24</reputation>

<visual>actors\dark_stalker\dark_stalker_1</visual>
<snd_config>characters_voice\human_01\monolith\</snd_config>
<crouch_type>-1</crouch_type>
<panic_treshold>0</panic_treshold>
<supplies>
[spawn] \n
wpn_dark_colt1911 \n
ammo_11.43x23_hydro \n
#include "gameplay\character_items.xml" \n
#include "gameplay\character_drugs.xml" \n
#include "gameplay\character_food.xml"
</supplies>

#include "gameplay\character_criticals_3.xml"

<start_dialog>dm_hello_dialog</start_dialog>
<actor_dialog>dm_cool_info_dialog</actor_dialog>
</specific_character></pre>

Впишем наш код после какого-нибудь </specific_character>

Теперь идем в ''npc_profile.xml'' и туда вгоняем:

<pre><character id="esc_dark_stalker_1">
<class>esc_dark_stalker_01</class>
<specific_character>esc_dark_stalker_1</specific_character>
</character></pre>

Теперь надо заняться ''spawn_sections.ltx''. Скрипт будет «брать NPC» как раз из этого файла. Пишем туда:

* [esc_dark_stalker_1]:stalker – имя секции для скрипта..
* $spawn = "respawn\esc_dark_stalker_1"
* character_profile = esc_dark_stalker_1 – ссылка на описание нашего NPC
* spec_rank = regular – спец ранг
* community = dark_stalker – группировка.

Теперь берем любой скрипт спавна NPC, вгоняем туда имя секции из spawn_sections.ltx и ву-а-ля.

Тока забыли что данному НПС будет присвоенная дефолтовая логика (т.е. тупо хожу куда сам не знаю) забыли упомянуть про (ххх - лока):
+
+ ххх gulag.script (действия НПС! Где можно: где можно присвоить статус кампера; волкера; и.д.т)
+
+ ххх gulag.ltx (дублер логики т.е. дублирует кратко действия НПС)

==Авторы==

Статья создана:

* [[Участник:XStream|xStream]]
* [[Участник:RekLatS|OffBar]]
* [[Участник:Fr3nzy|Fr3nzy]]
* [[Участник:Imp|Imp]]
* [[Участник:Arhet|Arhet]]

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

Спавн через скрипт

2008-08-10T09:49:16Z

89.178.50.109:

==Теория==

В скриптах есть одна единственная функция, отвечающая за спавн объектов:
<pre>alife():create(section,position,levelvertex,gamevertex)</pre>

Строго говоря, их две: create create_ammo но различия между ними не существенны. [[Участник:Imp|Imp]] 22:45, 23 июля 2007 (EEST)

Первый параметр - секция в конфигурациях, описывающая объект, например "bolt","med_kit" - это простые секции, простых объектов
а есть объекты, которые переходят в онлайн/оффлайн, это неписи, монстры и так далее, например mil_killer_respawn_2 - спавнится снайпер группировки киллеров.

С позицией, думаю объяснять не надо, только существует нюанс - высота это Y, а не Z.
Задать позицию можно такой конструкцией vector():set(x,y,z), где x, y и z - координаты точки на уровне, где спавним объект.

Дальше сложнее, так как сам толком сформулировать не могу.

Начнем от простого к сложному. На каждом уровне много объектов, все объекты состоят из полигонов, у каждого полигона есть вершины – вертексы.

Именно они и должны здесь указываться, зачем - не особо понимаю, скорее всего для точного позиционирования объекта.
Например, можно получить вертекс ближайший к актору - db.actor:level_vertex()

Дальше идет гораздо более интересный параметр game_vertex, это почти то же самое, что и level_vertex, но (!) это глобальные величины!
Если level_vertex считается для уровня, то game_vertex - для всей игры, и нужен он для того, чтобы указать на какой карте спавнить объект (более вразумительного объяснения я не нашел).

Соответственно, чтобы заспавнить что-нибудь на другой карте, достаточно указать game_vertex в четвертом параметре
Например:
<pre>db.actor:game_vertex()</pre>

Итак, чтобы, например, заспавнить болт под ногами актора, пишем:
<pre>alife():create("bolt",db.actor():position(),1,db.actor:game_verte())</pre>

Почему 1, а не level_vertex? Проверено - разницы особой нет, какой level_vertex, хотя в некоторых случаях надо прописывать валидный вертекс, а то предмет может просто заспавнится не там, где планировалось... Но по большей части все проходит нормально и с единицей.
(Игнорирование level_vertex может приводить к проваливанию произведенных предметов/персонажей под землю.)
А вот game_vertex решает все - он указывает на каком уровне спавнить предмет, поэтому его надо указывать. Теоретически можно просто найти для каждого уровня по одному game_vertex'у и использовать их в скриптах.
На самом деле game_vertex показывает какой фрагмент карты используется (вся карта разбита на кусочки имеющие сквозную нумерацию по всем уровням и game_vertex выбирает нужный) соответсвенно неправильное использование черевато....

Кроме того - есть еще один параметр - ID объекта, если указать ID NPC или актора - то предмет заспавнится у него в инвентаре.

Пример (спавним артефакт Медуза в инвентаре у актора):
<pre>alife():create("af_medusa", db.actor():position(), 1, db.actor:game_vertex(), db.actor:id())</pre>

Функция спавна возвращает серверный объект, то есть ни NPC, ни монстра ни что-либо еще.

Серверный обьект позволяет свеже созданного NPC или тайник затарить разными рулезами/артефактами. Например, вот так создадим перед входом к Сидоровичу долговца и засунем в него пачку патронов:
<pre>
local obj
local a = vector() -- Задаем тип переменной
local dir = db.actor:direction()

a.x = -243.61 -- координата X
a.y = -19.52 -- высота Y
a.z = -127.17 -- координата Z

obj = alife():create("bar_dolg_respawn_3",a,13193,8,65535)
alife():create_ammo("ammo_9x18_fmj",
obj.position,
obj.m_level_vertex_id,
obj.m_game_vertex_id,
obj.id,
20) -- число патронов</pre>

Кстати, create_ammo - практически тоже самое, что и create, разница в том, что create_ammo предназначена специально для спавна патронов и позволяет создавать неполные пачки патронов. Возможно есть еще какие-то отличия. Стоит учесть, что сами авторы игры спавнят патроны исключительно через create_ammo. [[Участник:Imp|Imp]] 22:38, 23 июля 2007 (EEST)

Просто минимальный набор - координаты, ID, секция,а из него (серверного объекта) обычно нужен только ID, так как по ID можно получить этот самый серверный объект:
<pre>(alife():object(id))</pre>

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

Например надо решить следующую задачу - надо создать наемника, сменить ему группировку и изменить его инвентарь, ну и в нагрузку - сделать другом для игрока.

В определенный момент заспавненый объект переходит онлайн, в этот момент вызывается callback - net_spawn.

Что мы делаем? Сверяем ID онлайн объекта с сохраненным ID!

Если они совпадают, например так:
<pre>if obj:id()==saved_id then ...</pre>

Важно то, что у серверного объекта ID - это параметр, а у онлайнового объекта ID получается с помощью функции. Это важно, а то можно прогореть.

Итак, мы поймали нашего киллера по ID.

Далее все очень просто - вызываем команды для спавна гаусса и патронов к нему в инвентаре NPC (см. выше), меняем группировку специальной функцией, и делаем его другом.

Зачем такие сложности? Просто в оффлайне NPC как бы не существует, есть только косвенное упоминание о нем, и, плюс, все эти функции работают именно с объектом типа "NPC", а не с серверными объектами.

==Практика (часть 1)==

'''1.''' Чтобы не повторяться в описании создания нового квеста, просто изучите [[Создание квестов (Fr3nzy)|статью по созданию квестов]] от Fr3nzy – лучшей статьи на эту тему я просто не видел :) Мы просто свяжем все воедино и научимся спавнить объекты из скрипта.

Небольшое отступление:

Почему предпочтительнее делать спавн скриптом, а не через тот же xrSpawner? Программа xrSpawner, при всех своих достоинствах, обладает одним недостатком, а именно – она делает спавн через файл all.spawn, что приводит к:

* Невозможности совместить два мода, такой спавн использующих
* Необходимости каждый раз начинать новую игру

При спавне через скрипт ситуация иная: в подавляющем большинстве случаев, ранее сохраненные игры будут работать, что не может не радовать :)

Итак, определимся с квестом.

'''Задача:''' после разговора с Сидоровичем спавним зомби на территории фабрики в первой локации. Для того, чтобы не повредить оригинальный сюжет игры, задание будет выдаваться '''после''' прохождения квеста с флешкой Шустрого, так как появись там зомби одновременно с бандитами и Шустрым... я думаю, исход боя предрешен :)

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

В консоли введите команду:

<pre>rs_stats on или rs_stats 1 </pre>

Тем самым мы включаем вывод информации на экран.
Далее вводим еще одну команду:

<pre>demo_record 1 </pre>

И «летим» на фабрику. Нам нужно выбрать место для спавна объектов и данный режим как нельзя лучше подходит для реализации задуманного. Помещаем камеру в точке предполагаемого спавна и записываем координаты - у меня получились 115, -6, -16.

Для выхода из режима demo_record нажимаем Esc, в консоли пишем rs_stats off или rs_stats 0 (убираем вывод информации).

Другой способ получения тех же сведений - прийти в нужное место и запустить там скрипт, который выдаст все нужные координаты. Я пользуюсь следующим скриптом (вызываю общеизвестным способом, через main_menu):
<pre>
function main_menu:main_cheat_f3()
-- Выдадим сообщение о нашем местоположении
local text
local vid
local gvid
local a = vector() -- Тип переменной
local text

a = db.actor:position() -- Наше положение в координатах
vid = db.actor:level_vertex_id()
gvid = db.actor:game_vertex_id()
text = "Позиция:\\nX= "..a.x.."\\nY= "..a.y.."\\nZ= "..a.z.."\\nlevel_vertex= "..vid.."\\ngame_vertex_id= "..gvid
news_manager.send_tip(db.actor, text, nil, nil, 30000)
end
</pre>
В результате не нужно эксперементировать мы сразу получаем все, в том числе и level_vertex и game_vertex. [[Участник:Imp|Imp]] 22:38, 23 июля 2007 (EEST)

Выходим из игры, идем в папку с установленной игрой и создаем каталог gamedata (предполагается, что «лепим» свой «мод» на «чистую» игру, без установленных модов, и имеем распакованные ресурсы игры в папке, скажем, gamedata source).

В папке gamedata создаем папку config, а в ней - папку creatures. Скопируем из оригинальной папки файл m_zombie.ltx и откроем его на редактирование.

В файлах игры присутствуют 5 моделей гражданских зомби:

<pre>файлы zombi_1.ogf, zombi_1_ghost.ogf, zombi_2.ogf, zombi_trup.ogf, zombi_trup_2.ogf</pre>

Вернем в игру их всех :)

Уже имеются секции:

<pre>[zombie_weak]:m_zombie_e, [zombie_normal]:m_zombie_e, [zombie_strong]:m_zombie_e и [zombie_immortal]:zombie_strong. </pre>

Два последних типа используют одну и ту же модель zombi_trup.ogf, хм... непорядок, исправляем.
Последняя секция выглядит теперь так:

<pre>[zombie_immortal]:zombie_strong
$spawn = "monsters\zombies\zombie_immortal"
visual = monsters\zombi\zombi_trup_2
panic_threshold = 0.05 </pre>

Добавим пятую модель.

Для этого в конце файла создадим секцию:
<pre>[zombie_ghost]:zombie_strong</pre>

Это означает, что наш пятый зомби наследует все параметры zombie_strong, мы добавим лишь визуальное представление.

Пишем дальше:

<pre>$spawn = "monsters\zombies\zombie_ghost"
visual = monsters\zombi\zombi_1_ghost</pre>

Все. Сохраняем изменения и закрываем файл.

'''2.''' Пишем скрипт спавна. В папке gamedata создаем новую папку scripts, в ней создаем новый текстовый документ и называем его esc_zombie.script.

Отступление третье:

При написании статьи использовался оригинальный скрипт zombie_story.script из horror-mod’а. Концепция спавна перенесена практически без изменений, поэтому на авторство этого способа спавна я никоим образом не претендую :)

Итак, открываем наш пустой файл на редактирование, первой строкой объявляем переменную, в которой хранятся наши зомби:

<pre>local zombie_types = {"zombie_weak", "zombie_normal", "zombie_strong", "zombie_immortal", "zombie_ghost"}</pre>

Далее пишем функцию:

<pre>function spawn_zombies( position, total )
local zombie_index -- тип зомби из массива zombie_types
local new_pos, x_offset, z_offset -- объявляем переменные
for zombie_index=1, total do -- крутим цикл столько раз, сколько
задает переменная total
x_offset = math.random(5) -- случайное (рандомное) x от 1 до 5
z_offset = math.random(5) -- случайное (рандомное) z от 1 до 5
new_pos = position -- передаем координаты в функцию
new_pos.x = new_pos.x + x_offset -- прибавляем к указанной нами
координате x полученное выше рандомное x
new_pos.z = new_pos.z + z_offset -- прибавляем к указанной нами
координате z полученное выше рандомное z
-- Ниже, собственно и вызывается функция спавна случайного типа зомби
zombie_types[math.random(5)] привязанного к нашим координатам
alife():create(zombie_types[math.random(5)],new_pos,db.actor:level_vertex_id(),db.actor:game_vertex_id())
end
end </pre>

И последнее:

<pre>function zomby_story_1( actor, npc )
-- десять зомби на фабрике (Кордон)
local spawn_point = vector():set( 115, -6, -16 ) -- здесь указываем координаты,
выбранные нами для спавна, когда «летали» камерой :)
spawn_zombies( spawn_point, 10 ) -- собственно вызов предыдущей функции
с передачей ей координат и количества объектов
end</pre>

Все. Сохраняем и закрываем файл.

Продолжаем разговор :)

Для того, чтобы игра не вылетала после того, как мы добавили новый тип монстров, их нужно добавить в файл xr_statistic.script. Итак, скопируем этот файл из папки игры scripts в нашу папку к файлу esc_zombie.script и откроем на редактирование.

Добавим в local killCountProps к монстрам строчку:
<pre> zombie_weak = 1, zombie_normal = 2, zombie_strong = 3</pre>

В local sect_alias строчку:
<pre> zombie_weak = "zombie_weak", zombie_normal = "zombie_normal", zombie_strong = "zombie_strong"</pre>
А ниже в monster_classes строчку:
<pre> [clsid.zombie_s ] = "zombie"</pre>
В функцию getNpcType(npc) добавляем конструкцию:
<pre> elseif npc:character_community() == "zombie" then
community = "zombie"</pre>

Сохраняем изменения и закрываем файл.

Все будет работать на ура, пока мы не попробуем обыскать убитого зомби. Как только мы это сделаем, игра вылетит с примерно такой ошибкой.

<pre>Expression : fatal error
Function : CInifile::r_string
File : D:\xray-svn\xrCore\Xr_ini.cpp
Line : 351
Description : <no expression>
Arguments : Can't find variable icon in [zombie_weak]</pre>

Все верно – игра не знает какую иконку нам показывать для зомби. Иконки монстров хранятся в файле ui_npc_monster.dds. Здесь есть два варианта:

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

Вернемся к файлу m_zombie.ltx и в секцию [m_zombie_e]:monster_base впишем параметр
<pre> icon = ui_npc_monster_kontroler</pre>

Все. Вылетов не будет.

3. Тема данной статьи не предусматривает подробного описания того, как сделать новый диалог. В начале статьи я упомянул источник, где можно найти исчерпывающую информацию по созданию диалогов, могу также привести в пример [[Создание диалогов (BAC9-FLCL)|статью по созданию диалогов]] от BAC9-FLCL.

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

<pre> <dialog id="escape_trader_talk_info">
………
<phrase id="999">
<text>escape_trader_talk_info_999</text>
<next>7770</next>
<next>9991</next>
<next>9992</next>
<next>9993</next>
<next>9994</next>
<next>9995</next>
<next>9996</next>
</phrase>
<phrase id="9992">
<text>escape_trader_talk_info_9992</text>
<next>99922</next>
</phrase>
<phrase id="99922">
<text>escape_trader_talk_info_99922</text>
<next>9996</next>
<next>9995</next>
</phrase>
<phrase id="9993">
<text>escape_trader_talk_info_9993</text>
<next>99933</next>
</phrase>
<phrase id="9995">
<text>escape_trader_talk_info_9995</text>
</phrase>
<phrase id="3121">
<text>escape_trader_talk_info_3121</text>
<next>9996</next>
<next>9995</next>
</phrase>
<phrase id="3131">
<text>escape_trader_talk_info_3131</text>
<next>9996</next>
<next>9995</next>
</phrase>
<phrase id="41">
<text>escape_trader_talk_info_41</text>
<next>9996</next>
<next>9995</next>
</phrase>

<phrase id="7770">
<text>escape_trader_talk_info_7770</text>
<next>7771</next>
</phrase>
<phrase id="7771">
<text>escape_trader_talk_info_7771</text>
<next>7772</next>
<next>7773</next>
</phrase>
<phrase id="7772">
<text>escape_trader_talk_info_7772</text>
<next>7777</next>
</phrase>
<phrase id="7773">
<text>escape_trader_talk_info_7773</text>
<next>7779</next>
</phrase>
<phrase id="7779">
<text>escape_trader_talk_info_7779</text>
<next>9996</next>
<next>9995</next>
</phrase>
<phrase id="7777">
<text>escape_trader_talk_info_7777</text>
<action>esc_zombie.zombie_story_1</action>
<next>9996</next>
<next>9995</next>
</phrase>

<phrase id="51">
<text>escape_trader_talk_info_51</text>
<next>9996</next>
<next>9995</next>
</phrase>
……
</dialog></pre>

И также связанный с ним файл stable_dialogs_escape.xml.
В самом начале файла пишем следующее:

<pre> <string id="escape_trader_talk_info_7770">
<text>Происшествий никаких не было?</text>
</string>
<string id="escape_trader_talk_info_7771">
<text>Да знаешь... Вроде как тихо все у нас. Хотя, вот, вспомнил! Говорили мне
на днях, что на фабрике, ну, там, где бандюки околачиваются постоянно, видели какиих-то то ли
людей, то ли призраков... Мало ли что спьяну почудится - я и сказал этим паникерам, мол,
закусывать надо! Хех, блин, алкаши...</text>
</string>
<string id="escape_trader_talk_info_7772">
<text>Дык мне по любому мимо фабрики топать - заодно и посмотрю на этих
"людей-призраков".</text>
</string>
<string id="escape_trader_talk_info_7773">
<text>Да я как-то не собирался в ту сторону...</text>
</string>
<string id="escape_trader_talk_info_7779">
<text>Ну, смотри сам, все равно будь осторожен.</text>
</string>
<string id="escape_trader_talk_info_7777">
<text>Ага. Сходи, проветрись. Потом зайдешь, расскажешь, что там и как.</text>
</string>
<string id="esc_bridge_soldiers_start_11">
<text>Здесь проход воспрещён, сталкер.</text>
</string></pre>

Все. Можно запускать игру, идти на Кордон, после разговороа с Сидоровичем, в зависимости
от выбранного Меченным решения, бежим на фабрику и … смотрим сами :)

[http://www.sendspace.com/file/2kx7uf Готовые файлы примера](перезалито)
[http://slil.ru/24600587 Spawn Lib]
Домашнее задание - вернуть в игру 6-ой тип гражданского зомби :)

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

==Практика (часть 2)==

'''4.''' Сегодня мы закончим с зомби в полном объеме – добавим их описания в энциклопедию, добавим иконки, и разберемся с «домашним заданием»:) Думаю, что внимательно изучив эту статью, вы ''сами'' сможете через скриптовые функции восстановить любого персонажа, не вошедшего в финальный релиз игры. Если у кого хватит времени и желания, те могут даже написать что-то типа «Ночи живых мертвецов» :) - серию квестов, связанную своим собственным сюжетом.
Итак, «домашнее задание» - добавляем в игру шестого зомби.

* Создаем в папке gamedata папку meshes, в ней папку monsters, а там – папку zombi. В папке meshes хранятся модели персонажей, объектов, окружения, присутствующих в игре. Как я уже говорил выше, в игре представлено 5 моделей гражданских зомби, а вот текстур – 6. Также немного смутила нумерация моделей – 1, 2, 4... А где третий? Наверное, сбежал :)

* Скопируем из папки с оригинальными файлами игры в созданную нами папку zombi файл zombi_2.ogf и переименуем его в zombi_3.ogf. Откроем файл нашей новой модели любым HexEditor’ом, я использую BiEd (Binary Editor 1.00). Так как данная статья рассчитана не только на «продвинутых юзеров», но и на «обычных чайников», которые, тем не менее, хотят «что-нить замутить» и при этом не сильно «парить моск», я не буду рассказывать здесь про адресацию, двухбайтовую запись и т.д., я просто наглядно покажу, где что поправить :)

[http://www.golushkov.pp.net.ua/photo/11-0-717-3 Файл модели '''до''' редактирования]

[http://www.golushkov.pp.net.ua/photo/11-0-718-3 Файл модели '''после''' редактирования]

На скринах видно, что мы просто изменили для этой модели путь к текстуре. Все. Без использования 3D-редакторов и затраты кучи времени на обработку модели в них, мы получили абсолютно новую (на внешний вид) модель. :)

'''5.''' Теперь пропишем нашего нового зомби во все файлы, которые мы создали ранее. В файл m_zombie.ltx в самый конец добавляем секцию:

<pre>[zombie_old]:zombie_normal
$spawn = "monsters\zombies\zombie_old"
visual = monsters\zombi\zombi_3</pre>

в файле esc_zombie.script изменяем массив в первой строке:

<pre>local zombie_types = {"zombie_weak", "zombie_normal", "zombie_strong", "zombie_immortal",
"zombie_old", "zombie_ghost"}</pre>

В функции spawn_zombies изменяем строку спавна:

<pre> alife():create(zombie_types[math.random(6)],new_pos,
db.actor:level_vertex_id(),db.actor:game_vertex_id())</pre>
в функции zombie_story_1 меняем число объектов на кратное 6-ти (необязательно):

<pre> spawn_zombies( spawn_point, 12 )</pre>

Всё. Сохраняем и закрываем.

'''6.''' Копируем в папку gamedata\config\gameplay\ файл encyclopedia_mutants.xml, добавляем описание зомби в энциклопедию:

<pre> 

<article id="mutant_zombieg_general" name="Zombieg" group="Mutants">
<texture>ui_npc_monster_zombieg</texture>
<text>enc_mutant_zombieg_general</text>
</article>
</pre>

И в связанный с ним файл string_table_enc_mutants.xml в папке gamedata\config\text\rus\ добавляем:

<pre> <string id="Zombie">
<text>Зомби, гражданский</text>
</string>
<string id="Zombieg">
<text>Зомби-призрак, гражданский</text>
</string>
<string id="enc_mutant_zombieg_general">
<text>Зомби-привидение отличается от обычного зомби лишь тем, что
воздействие Выжигателя мозгов полностью разрушило не только структуру личности, но и
тело, поэтому зомби-призрак несколько более живуч по сравнению с обычным зомби.</text>
</string>
<string id="enc_mutant_zombie_general">
<text>Воздействие Выжигателя мозгов полностью разрушает структуру личности,
оставляя только телесную оболочку.\n\n Побродив немного по Зоне, лишённые разума тела
начинают превращаться в настоящих зомби. Из рефлексов у них остаются лишь самые примитивные,
оружие и экипировка скоро приходят в негодность. В результате зомби становятся собой ни чем
иным, как медлительными полутрупами, которых наличествуют лишь два эффективных раздражителя:
еда и сон. Зомби совершенно неразборчивы в выборе пищи и питья, поэтому их тела буквально
пропитаны радиацией и токсинами. Как правило, эти существа бесцельно бродят по Зоне или,
словно трупы, валяются внутри заброшенных построек. Однако, лишь только зомби почует близкое
присутствие живого человека, он сразу же пытается атаковать. Умудрённые опытом сталкеры
стараются обходить эти неуклюжие опустошённые оболочки.</text>
</string>
</pre>

Копируем сюда же файл stable_statistic_caption.xml и изменяем в нем 3 строчки:

<pre> <string id="zombie_normal">
<text>зомбированный, гражданский</text>
</string>
<string id="zombie_strong">
<text>зомби-призрак, гражданский</text>
</string>
<string id="zombie_weak">
<text>зомби, гражданский</text>
</string>
</pre>

Сохраняем и закрываем.

'''7.''' И последнее – добавим иконки. Скажу сразу, воспользовался готовым файлом, уже содержащим иконки зомби и других «восстановленных монстров» (спасибо Fr3nzy). Поэтому просто скопируйте файл ui_npc_monster.dds из архива в папку gamedata\textures\ui\, а файл ui_npc_monster.xml – в папку gamedata\config\ui\. Если вы хотите сделать собственные - прочитайте урок по [[Изменение текстур (BAC9-FLCL)|изменению текстур]].

Вкратце, что описывает файл ui_npc_monster.xml: в нем задаются координаты иконок, расположенных в файле ui_npc_monster.dds, применительно к каждому типу монстров в игре.

Заключительный штрих. Откройте файл m_zombie.ltx и в первой секции замените строку
<pre>icon = ui_npc_monster_kontroler</pre>
На:
<pre>icon = ui_npc_monster_zombie</pre>
В секцию [zombie_ghost] добавьте строку:
<pre>icon = ui_npc_monster_zombieg</pre>

Сохраняйте изменения. Всё.

Вот [http://data.cod.ru/1290894794 готовые файлы примера].
Удачи и спасибо за внимание :)

==Спавн NPC==

Эта часть статьи написана [[Участник:Arhet|Arhet]] и создана на примере того, как в SRP Mod были созданы NPC группировки "Грех".

Задействуем файлы:

* gamedata\config\gameplay\character_desc_escape.xml
* gamedata\config\gameplay\npc_profile.ltx
* gamedata\config\creatures\spawn_sections.ltx

Начнем с ''character_desc_escape.xml''. Описание что значит каждая строка писать не буду, так как все до меня уже сделано.

Тут создадим нового персонажа:

<pre><specific_character id="esc_dark_stalker_1" team_default = "1">
<name>GENERATE_NAME_bandit</name>
<icon>ui_npc_dark_1</icon>
<map_icon x="0" y="0"></map_icon>
<bio>sim_stalker_novice_bio</bio>

<class>esc_dark_stalker_01</class> - вот тут наш новый класс кстати.
<community>dark_stalker</community> <terrain_sect>stalker_terrain</terrain_sect>
<money min="200" max="600" infinitive="0"></money>

<rank>198</rank>
<reputation>-24</reputation>

<visual>actors\dark_stalker\dark_stalker_1</visual>
<snd_config>characters_voice\human_01\monolith\</snd_config>
<crouch_type>-1</crouch_type>
<panic_treshold>0</panic_treshold>
<supplies>
[spawn] \n
wpn_dark_colt1911 \n
ammo_11.43x23_hydro \n
#include "gameplay\character_items.xml" \n
#include "gameplay\character_drugs.xml" \n
#include "gameplay\character_food.xml"
</supplies>

#include "gameplay\character_criticals_3.xml"

<start_dialog>dm_hello_dialog</start_dialog>
<actor_dialog>dm_cool_info_dialog</actor_dialog>
</specific_character></pre>

Впишем наш код после какого-нибудь </specific_character>

Теперь идем в ''npc_profile.xml'' и туда вгоняем:

<pre><character id="esc_dark_stalker_1">
<class>esc_dark_stalker_01</class>
<specific_character>esc_dark_stalker_1</specific_character>
</character></pre>

Теперь надо заняться ''spawn_sections.ltx''. Скрипт будет «брать NPC» как раз из этого файла. Пишем туда:

* [esc_dark_stalker_1]:stalker – имя секции для скрипта..
* $spawn = "respawn\esc_dark_stalker_1"
* character_profile = esc_dark_stalker_1 – ссылка на описание нашего NPC
* spec_rank = regular – спец ранг
* community = dark_stalker – группировка.

Теперь берем любой скрипт спавна NPC, вгоняем туда имя секции из spawn_sections.ltx и ву-а-ля.

Тока забыли что данному НПС будет присвоенная дефолтовая логика (т.е. тупо хожу куда сам не знаю) забыли упомянуть про (ххх - лока):
+
+ ххх gulag.script (действия НПС! Где можно: где можно присвоить статус кампера; волкера; и.д.т)
+
+ ххх gulag.ltx (дублер логики т.е. дублирует кратко действия НПС)

==Авторы==

Статья создана:

* [[Участник:XStream|xStream]]
* [[Участник:RekLatS|OffBar]]
* [[Участник:Fr3nzy|Fr3nzy]]
* [[Участник:Imp|Imp]]
* [[Участник:Arhet|Arhet]]

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

SoC. Редактирование NPC

2008-08-10T09:44:13Z

89.178.50.109:

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

В этой статье мы научимся редактировать NPC: изменять содержимое их инвентаря, реплики, поведение, имя, и другие параметры.

==Параметры==

За параметры NPC отвечают файлы:
<pre>\config\gameplay\character_desc_[название локации].xml</pre>

Каждый из них разбит на секции - по одной на NPC. Используются следующие параметры:

* ''<name>...</name>'' - Имя (ссылка на строку в текстовом массиве).
* ''<icon>ui_npc_...</icon>'' - Иконка для диалогов/торговли/PDA.
* ''<bio>..._bio</bio>'' - Биография (в игре не используется).
* ''<class>...</class>'' - Класс (лучше не трогать).[[Участник:Imp|Imp]] 12:46, 12 августа 2007 (EEST)Нужно для того что-бы автоматические респавнеры могли спавнить немного разных персонажей. То есть например в игре есть описание восьми (кажеться может и больше) разных новичков и что бы при автоматическом респавне не получалась куча братьев-близнецов, респавнер настраивается на класс персонажей и спавнит случайным образом разных персонажей одного класса.
* ''<community>...</community>'' - Группировка.
* ''<rank>...</rank>'' - Ранг.
* ''<reputation>...</reputation>'' - Репутация.
* ''<money min="..." max="..." infinitive="..."/>'' - Количество денег (infinitive="1" - бесконечные деньги).
* ''<snd_config>...</snd_config>'' - Набор звуков.
* ''<crouch_type>-1</crouch_type>'' - Тип приседания. Лучше не трогать.
* ''<visual>actors\...</visual>'' - Внешность. Влияет как на внешний вид костюма, так и на его свойства. Укажите здесь экзоскелет - и персонаж действительно в нем окажется: как по внешности, так и по свойствам.
* ''<supplies>...</supplies>'' - Предметы, находящиеся у него в инвентаре. Некоторые из них в игре не отображаются, поэтому не удивляйтесь присутствию здесь предметов вроде рации или фонарика.

В игре отображаються все предметы, просто при торговле есть ограничения на допустимые к торговле предметы, а при смерти персонажа, "запрещенные" предметы удаляються скриптом. [[Участник:Imp|Imp]] 12:46, 12 августа 2007 (EEST)

* ''<start_dialog>...<start_dialog>'' - Приветственный диалог. Их может быть несколько, с различными условиями появления.
* ''<actor_dialog>...</actor_dialog>'' - Диалоги с игроком.

==Практика==

Изменим, например, параметры NPC по имени Волк.

Откроем файл:
<pre>\config\gameplay\character_desc_escape.xml</pre>

И найдем в нем раздел, ему соответствующий:

<pre>

<specific_character id="esc_wolf" team_default = "1">
<name>esc_wolf_name</name>
<icon>ui_npc_u_stalker_neytral_balon_1</icon>
<bio>esc_wolf_bio</bio>

<class>esc_wolf</class>
<community>stalker</community> <terrain_sect>stalker_terrain</terrain_sect>

<rank>434</rank>
<reputation>5</reputation>
<money min="600" max="2000" infinitive="0"/>

<snd_config>characters_voice\human_01\stalker\</snd_config>
<crouch_type>-1</crouch_type>

<visual>actors\neytral\stalker_neytral_balon_1</visual>
<supplies>
[spawn] \n
wpn_pm \n
ammo_9x18_fmj = 1 \n
wpn_ak74u \n
ammo_5.45x39_fmj \n
device_torch \n
hand_radio \n
</supplies>

#include "gameplay\character_criticals_4.xml" //

<start_dialog>escape_lager_volk_talk</start_dialog>
<start_dialog>dm_hello_dialog</start_dialog>
<actor_dialog>dm_cool_info_dialog</actor_dialog>
<actor_dialog>dm_help_wounded_medkit_dialog</actor_dialog>
<actor_dialog>tm_wolf_dialog</actor_dialog>
<actor_dialog>tm_wolf_reward</actor_dialog>
</specific_character></pre>

Изменим некоторые параметры. Выдадим ему FN2000 и Desert Eagle, примем в "Долг" и сделаем неограниченное количество денег:

<pre>

<specific_character id="esc_wolf" team_default = "1">
<name>esc_wolf_name</name>
<icon>ui_npc_u_stalker_neytral_balon_1</icon>
<bio>esc_wolf_bio</bio>

<class>esc_wolf</class>
<community>dolg</community> <terrain_sect>stalker_terrain</terrain_sect>

<rank>434</rank>
<reputation>5</reputation>
<money min="600" max="2000" infinitive="1"/>

<snd_config>characters_voice\human_01\stalker\</snd_config>
<crouch_type>-1</crouch_type>

<visual>actors\neytral\stalker_neytral_balon_1</visual>
<supplies>
[spawn] \n
wpn_deagle \n
ammo_11.43x23_fmj = 1 \n
wpn_fn2000 \n
ammo_5.56x45_ap \n
ammo_5.45x39_fmj \n
device_torch \n
hand_radio \n
</supplies>

#include "gameplay\character_criticals_4.xml" //

<start_dialog>escape_lager_volk_talk</start_dialog>
<start_dialog>dm_hello_dialog</start_dialog>
<actor_dialog>dm_cool_info_dialog</actor_dialog>
<actor_dialog>dm_help_wounded_medkit_dialog</actor_dialog>
<actor_dialog>tm_wolf_dialog</actor_dialog>
<actor_dialog>tm_wolf_reward</actor_dialog>
</specific_character></pre>

Для ввода нового NPC в симуляцию достаточно создать новый профиль.

Статья создана:
[[Участник:BAC9-FLCL|BAC9-FLCL]]
[[Категория:Конфигурационные_файлы]]

SoC. Редактирование NPC

2008-08-10T09:43:47Z

89.178.50.109:

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

В этой статье мы научимся редактировать NPC: изменять содержимое их инвентаря, реплики, поведение, имя, и другие параметры.

==Параметры==

За параметры NPC отвечают файлы:
<pre>\config\gameplay\character_desc_[название локации].xml</pre>

Каждый из них разбит на секции - по одной на NPC. Используются следующие параметры:

* ''<name>...</name>'' - Имя (ссылка на строку в текстовом массиве).
* ''<icon>ui_npc_...</icon>'' - Иконка для диалогов/торговли/PDA.
* ''<bio>..._bio</bio>'' - Биография (в игре не используется).
* ''<class>...</class>'' - Класс (лучше не трогать).[[Участник:Imp|Imp]] 12:46, 12 августа 2007 (EEST)Нужно для того что-бы автоматические респавнеры могли спавнить немного разных персонажей. То есть например в игре есть описание восьми (кажеться может и больше) разных новичков и что бы при автоматическом респавне не получалась куча братьев-близнецов, респавнер настраивается на класс персонажей и спавнит случайным образом разных персонажей одного класса.
* ''<community>...</community>'' - Группировка.
* ''<rank>...</rank>'' - Ранг.
* ''<reputation>...</reputation>'' - Репутация.
* ''<money min="..." max="..." infinitive="..."/>'' - Количество денег (infinitive="1" - бесконечные деньги).
* ''<snd_config>...</snd_config>'' - Набор звуков.
* ''<crouch_type>-1</crouch_type>'' - Тип приседания. Лучше не трогать.
* ''<visual>actors\...</visual>'' - Внешность. Влияет как на внешний вид костюма, так и на его свойства. Укажите здесь экзоскелет - и персонаж действительно в нем окажется: как по внешности, так и по свойствам.
* ''<supplies>...</supplies>'' - Предметы, находящиеся у него в инвентаре. Некоторые из них в игре не отображаются, поэтому не удивляйтесь присутствию здесь предметов вроде рации или фонарика.

В игре отображаються все предметы, просто при торговле есть ограничения на допустимые к торговле предметы, а при смерти персонажа, "запрещенные" предметы удаляються скриптом. [[Участник:Imp|Imp]] 12:46, 12 августа 2007 (EEST)

* ''<start_dialog>...<start_dialog>'' - Приветственный диалог. Их может быть несколько, с различными условиями появления.
* ''<actor_dialog>...</actor_dialog>'' - Диалоги с игроком.

==Практика==

Изменим, например, параметры NPC по имени Волк.

Откроем файл:
<pre>\config\gameplay\character_desc_escape.xml</pre>

И найдем в нем раздел, ему соответствующий:

<pre>

<specific_character id="esc_wolf" team_default = "1">
<name>esc_wolf_name</name>
<icon>ui_npc_u_stalker_neytral_balon_1</icon>
<bio>esc_wolf_bio</bio>

<class>esc_wolf</class>
<community>stalker</community> <terrain_sect>stalker_terrain</terrain_sect>

<rank>434</rank>
<reputation>5</reputation>
<money min="600" max="2000" infinitive="0"/>

<snd_config>characters_voice\human_01\stalker\</snd_config>
<crouch_type>-1</crouch_type>

<visual>actors\neytral\stalker_neytral_balon_1</visual>
<supplies>
[spawn] \n
wpn_pm \n
ammo_9x18_fmj = 1 \n
wpn_ak74u \n
ammo_5.45x39_fmj \n
device_torch \n
hand_radio \n
</supplies>

#include "gameplay\character_criticals_4.xml" //

<start_dialog>escape_lager_volk_talk</start_dialog>
<start_dialog>dm_hello_dialog</start_dialog>
<actor_dialog>dm_cool_info_dialog</actor_dialog>
<actor_dialog>dm_help_wounded_medkit_dialog</actor_dialog>
<actor_dialog>tm_wolf_dialog</actor_dialog>
<actor_dialog>tm_wolf_reward</actor_dialog>
</specific_character></pre>

Изменим некоторые параметры. Выдадим ему FN2000 и Desert Eagle, примем в "Долг" и сделаем неограниченное количество денег:

<pre>

<specific_character id="esc_wolf" team_default = "1">
<name>esc_wolf_name</name>
<icon>ui_npc_u_stalker_neytral_balon_1</icon>
<bio>esc_wolf_bio</bio>

<class>esc_wolf</class>
<community>dolg</community> <terrain_sect>stalker_terrain</terrain_sect>

<rank>434</rank>
<reputation>5</reputation>
<money min="600" max="2000" infinitive="1"/>

<snd_config>characters_voice\human_01\stalker\</snd_config>
<crouch_type>-1</crouch_type>

<visual>actors\neytral\stalker_neytral_balon_1</visual>
<supplies>
[spawn] \n
wpn_deagle \n
ammo_11.43x23_fmj = 1 \n
wpn_fn2000 \n
ammo_5.56x45_ap \n
ammo_5.45x39_fmj \n
device_torch \n
hand_radio \n
</supplies>

#include "gameplay\character_criticals_4.xml" //

<start_dialog>escape_lager_volk_talk</start_dialog>
<start_dialog>dm_hello_dialog</start_dialog>
<actor_dialog>dm_cool_info_dialog</actor_dialog>
<actor_dialog>dm_help_wounded_medkit_dialog</actor_dialog>
<actor_dialog>tm_wolf_dialog</actor_dialog>
<actor_dialog>tm_wolf_reward</actor_dialog>
</specific_character></pre>

Для ввода нового NPC в симуляцию достаточно создать новый профиль.

Статья создана:

[[Участник:BAC9-FLCL|BAC9-FLCL]]
[[Категория:Конфигурационные_файлы]]

SoC. Редактирование NPC

2008-08-10T09:43:38Z

89.178.50.109:

SoC. Редактирование NPC

2008-08-10T09:43:26Z

89.178.50.109:

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

В этой статье мы научимся редактировать NPC: изменять содержимое их инвентаря, реплики, поведение, имя, и другие параметры.

==Параметры==

За параметры NPC отвечают файлы:
<pre>\config\gameplay\character_desc_[название локации].xml</pre>

Каждый из них разбит на секции - по одной на NPC. Используются следующие параметры:

* ''<name>...</name>'' - Имя (ссылка на строку в текстовом массиве).
* ''<icon>ui_npc_...</icon>'' - Иконка для диалогов/торговли/PDA.
* ''<bio>..._bio</bio>'' - Биография (в игре не используется).
* ''<class>...</class>'' - Класс (лучше не трогать).[[Участник:Imp|Imp]] 12:46, 12 августа 2007 (EEST)Нужно для того что-бы автоматические респавнеры могли спавнить немного разных персонажей. То есть например в игре есть описание восьми (кажеться может и больше) разных новичков и что бы при автоматическом респавне не получалась куча братьев-близнецов, респавнер настраивается на класс персонажей и спавнит случайным образом разных персонажей одного класса.
* ''<community>...</community>'' - Группировка.
* ''<rank>...</rank>'' - Ранг.
* ''<reputation>...</reputation>'' - Репутация.
* ''<money min="..." max="..." infinitive="..."/>'' - Количество денег (infinitive="1" - бесконечные деньги).
* ''<snd_config>...</snd_config>'' - Набор звуков.
* ''<crouch_type>-1</crouch_type>'' - Тип приседания. Лучше не трогать.
* ''<visual>actors\...</visual>'' - Внешность. Влияет как на внешний вид костюма, так и на его свойства. Укажите здесь экзоскелет - и персонаж действительно в нем окажется: как по внешности, так и по свойствам.
* ''<supplies>...</supplies>'' - Предметы, находящиеся у него в инвентаре. Некоторые из них в игре не отображаются, поэтому не удивляйтесь присутствию здесь предметов вроде рации или фонарика.

В игре отображаються все предметы, просто при торговле есть ограничения на допустимые к торговле предметы, а при смерти персонажа, "запрещенные" предметы удаляються скриптом. [[Участник:Imp|Imp]] 12:46, 12 августа 2007 (EEST)

* ''<start_dialog>...<start_dialog>'' - Приветственный диалог. Их может быть несколько, с различными условиями появления.
* ''<actor_dialog>...</actor_dialog>'' - Диалоги с игроком.

==Практика==

Изменим, например, параметры NPC по имени Волк.

Откроем файл:
<pre>\config\gameplay\character_desc_escape.xml</pre>

И найдем в нем раздел, ему соответствующий:

<pre>

<specific_character id="esc_wolf" team_default = "1">
<name>esc_wolf_name</name>
<icon>ui_npc_u_stalker_neytral_balon_1</icon>
<bio>esc_wolf_bio</bio>

<class>esc_wolf</class>
<community>stalker</community> <terrain_sect>stalker_terrain</terrain_sect>

<rank>434</rank>
<reputation>5</reputation>
<money min="600" max="2000" infinitive="0"/>

<snd_config>characters_voice\human_01\stalker\</snd_config>
<crouch_type>-1</crouch_type>

<visual>actors\neytral\stalker_neytral_balon_1</visual>
<supplies>
[spawn] \n
wpn_pm \n
ammo_9x18_fmj = 1 \n
wpn_ak74u \n
ammo_5.45x39_fmj \n
device_torch \n
hand_radio \n
</supplies>

#include "gameplay\character_criticals_4.xml" //

<start_dialog>escape_lager_volk_talk</start_dialog>
<start_dialog>dm_hello_dialog</start_dialog>
<actor_dialog>dm_cool_info_dialog</actor_dialog>
<actor_dialog>dm_help_wounded_medkit_dialog</actor_dialog>
<actor_dialog>tm_wolf_dialog</actor_dialog>
<actor_dialog>tm_wolf_reward</actor_dialog>
</specific_character></pre>

Изменим некоторые параметры. Выдадим ему FN2000 и Desert Eagle, примем в "Долг" и сделаем неограниченное количество денег:

<pre>

<specific_character id="esc_wolf" team_default = "1">
<name>esc_wolf_name</name>
<icon>ui_npc_u_stalker_neytral_balon_1</icon>
<bio>esc_wolf_bio</bio>

<class>esc_wolf</class>
<community>dolg</community> <terrain_sect>stalker_terrain</terrain_sect>

<rank>434</rank>
<reputation>5</reputation>
<money min="600" max="2000" infinitive="1"/>

<snd_config>characters_voice\human_01\stalker\</snd_config>
<crouch_type>-1</crouch_type>

<visual>actors\neytral\stalker_neytral_balon_1</visual>
<supplies>
[spawn] \n
wpn_deagle \n
ammo_11.43x23_fmj = 1 \n
wpn_fn2000 \n
ammo_5.56x45_ap \n
ammo_5.45x39_fmj \n
device_torch \n
hand_radio \n
</supplies>

#include "gameplay\character_criticals_4.xml" //

<start_dialog>escape_lager_volk_talk</start_dialog>
<start_dialog>dm_hello_dialog</start_dialog>
<actor_dialog>dm_cool_info_dialog</actor_dialog>
<actor_dialog>dm_help_wounded_medkit_dialog</actor_dialog>
<actor_dialog>tm_wolf_dialog</actor_dialog>
<actor_dialog>tm_wolf_reward</actor_dialog>
</specific_character></pre>

Для ввода нового NPC в симуляцию достаточно создать новый профиль.
Статья создана:
[[Участник:BAC9-FLCL|BAC9-FLCL]]
[[Категория:Конфигурационные_файлы]]

SoC. Создание новых веток диалогов

2008-08-10T09:35:46Z

89.178.50.109: /* Практический пример не работает со вторым патчем - решение проблемы */

==<center>Создание новых веток диалогов.</center>==
===Теория:===

(Если где то чего то напутал исправляйте, многое писал интуитивно)

'''1)''' Списки веток диалогов содержатся в файлах вида gamedata/config/gameplay/character_desc_*.xml

Это например:
character_desc_zombied.xml
character_desc_stalker.xml
character_desc_garbage.xml
итд.

Файлы character_desc_*.xml можно сравнить со стволом дерева диалогов.
В них перечисляется названия прикрепляемых веток диалогов

Например вот список веток диалога с Сидоровичем взятый из файла character_desc_escape.xml

<pre> <start_dialog>escape_trader_start_dialog</start_dialog>
<actor_dialog>escape_trader_talk_info</actor_dialog>
<actor_dialog>escape_trader_jobs</actor_dialog>
<actor_dialog>tm_trader_dialog</actor_dialog>
<actor_dialog>tm_trader_reward</actor_dialog>
<actor_dialog>escape_trader_done_blockpost_box</actor_dialog></pre>

В свою очередь каждая ветка диалога также может ветвится.

'''2)''' Ветвление веток прописывается уже в других файлах.
Например ветвление веток диалога с Сидоровичем содержится в файле gamedata/config/gameplay/dialogs_escape.xml
Возьмем оттуда к примеру ветвление ветки escape_trader_jobs

(ветвление веток обычно очень большое поэтому я приведу только часть):

<pre><dialog id="escape_trader_talk_info">
<precondition>escape_dialog.trader_has_talk_info_wr</precondition>
<has_info>tutorial_end</has_info>
<phrase_list>
<phrase id="1">
<text>escape_trader_talk_info_1</text>
<next>100</next>
<next>99</next>
<next>9995</next>
</phrase>

…
…
…
<phrase id="0">
<text>escape_trader_talk_info_0</text>
<next>1</next>
</phrase>
</phrase_list>
</dialog></pre>

Здесь <precondition>…</precondition> - это проверка выполнения условия. Ветка появится в диалоге, только если условие выполняется.
Конкретно <precondition>escape_dialog.trader_has_talk_info_wr</precondition> из ветки escape_trader_talk_info есть обращение к функции trader_has_talk_info_wr находящейся в файле скрипте gamedata/scripts/escape_dialog.script

Функция выглядит так:

<pre>function trader_has_talk_info_wr( trader, actor )
return true
end</pre>

<precondition>escape_dialog.trader_has_talk_info_wr</precondition> в принципе выполняется всегда, т.к. функция всегда возвращает иситну и <dialog id="escape_trader_talk_info"> пропускается в списк реплик.
Но для конкретной ветки может быть несколько precondition и других условий.

Далее <has_info>tutorial_end</has_info> (если я верно понимаю) это так же своего рода проверка условия. В данном случае проверка на то закончена стадия tutorialа или нет. Т.е ветка допустится в список реплик если стадия tutorialа закончена.
более детально об этом в конце данной статьи.

А далее идут конкретные фразы содержащие ссылки на вытекающие фразы

Фраза:
<pre><phrase id="0">
<text>escape_trader_talk_info_0</text>
<next>1</next>
</phrase></pre>

это основа ветки escape_trader_talk_info.
(Вообще как я понял в любой основной ветке любого диалога фраза <phrase id="0"> будет основой из которой далее будет все вытекать)

<next>1</next> - это ссылка на вытекающую фразу <phrase id="1">:

<pre> <phrase id="1">
<text>escape_trader_talk_info_1</text>
<next>100</next>
<next>99</next>
<next>9995</next>
</phrase></pre>

В свою очередь <next>100</next>, <next>99</next>, <next>9995</next> это ссылки на фразы веточки растущие из фразы <phrase id="1">.

'''3)''' Текст каждой фразы содержится уже в четвертом файле. Для диалога с Сидоровичем тексты лежат в файле gamedata/config/text/rus/stable_dialogs_escape.xml

<pre> <string id="escape_trader_talk_info_0">
<text>Есть несколько вопросов.</text>
</string>
<string id="escape_trader_talk_info_1">
<text>Спрашивай, только я ведь всего не знаю. Сам понимаешь, сижу тут целыми днями, а жизнь - она вся там, снаружи, в Зоне. Могу рассказать о Зоне вообще, а немного могу о ближайших окрестностях, где сам ходил.</text>
</string></pre>

Эти строки содержат тексты для фраз <phrase id="0"> и <phrase id="1">

Итого диалоги разложены по 4 а то и более файлам.

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

<pre><phrase id="0">
<text>…</text>
<next>1</next>
<next>2</next>
</phrase>
<phrase id="1">
<text>…</text>
<next>11</next>
<next>12</next>
</phrase>
<phrase id="11">
<text>…</text>
<next>1</next> - Это возврат к фразе 1. (зацикливание)
<next>111</next>
</phrase></pre>

===Практика:===
Добавим в диалог с Сидоровичем ветку своего собственного изготовления.Например такую:

<pre>
Меченый: Сидрыч а почему это у тебя зеленые человечки, что по столу бегают, такие худые?
Сидорович: Чего?!!
Меченый: Ты их совсем, совсем не кормишь?
Сидорович: В следующий раз, как пойдешь в зону, бери-ка вместо водяры побольше антирада. А то мало что таким перегаром дышишь, уже до зеленых человечков долечился… Шутник.</pre>

Для этого:

'''1)''' В файле gamedata/config/gameplay/character_desc_escape.xml в конце списка веток для trader_а суем свою ветку с произвольным названием. (например <actor_dialog>escape_trader_letat_gusi</actor_dialog>)

Т.е у нас получится так
<pre> …
<specific_character id="escape_trader" no_random = "1">
…
…
…
<start_dialog>escape_trader_start_dialog</start_dialog>
<actor_dialog>escape_trader_talk_info</actor_dialog>
<actor_dialog>escape_trader_jobs</actor_dialog>
<actor_dialog>tm_trader_dialog</actor_dialog>
<actor_dialog>tm_trader_reward</actor_dialog>
<actor_dialog>escape_trader_done_blockpost_box</actor_dialog>
<actor_dialog>escape_trader_letat_gusi</actor_dialog>
</specific_character>
…</pre>
Записываем изменения и с файлом character_desc_escape.xml все.

'''2)''' Теперь берем файл gamedata/config/gameplay/dialogs_escape.xml

Диалогу:

<pre>Меченый: Сидрыч а почему это у тебя зеленые человечки, что по столу бегают, такие худые?
Сидорович: Чего?!!
Меченый: Ты их совсем, совсем не кормишь?
Сидорович: В следующий раз, как пойдешь в зону, бери-ка вместо водяры побольше антирада. А то мало что таким перегаром дышишь, уже до зеленых человечков долечился… Шутник.</pre>

который мы хотим реализовать будет соответствовать такая структура:

<pre><phrase id="0">
<text>escape_trader_letat_gusi_0</text>
<next>1</next>
</phrase>
<phrase id="1">
<text>escape_trader_letat_gusi_1</text>
<next>2</next>
</phrase>
<phrase id="2">
<text> escape_trader_letat_gusi_2</text>
<next>3</next>
</phrase>
<phrase id="3">
<text> escape_trader_letat_gusi_3</text>
</phrase></pre>

условия наличия ветки в диалоге можно взять из ветки <dialog id="escape_trader_talk_info">
Т.е берем условия <precondition>escape_dialog.trader_has_talk_info_wr</precondition> и <has_info>tutorial_end</has_info>
(Можно было конечно прописать в скрипте еще одно условие для ветки, чтоб она появилась только один раз,
а потом больше не возникала. Но об этом как нибудь позже допишу.)

В итоге у нас получилась такая структура:

<pre><dialog id="escape_trader_letat_gusi">
<precondition>escape_dialog.trader_has_talk_info_wr</precondition>
<has_info>tutorial_end</has_info>
<phrase_list>
<phrase id="0">
<text>escape_trader_letat_gusi_0</text>
<next>1</next>
</phrase>
<phrase id="1">
<text>escape_trader_letat_gusi_1</text>
<next>2</next>
</phrase>
<phrase id="2">
<text> escape_trader_letat_gusi_2</text>
<next>3</next>
</phrase>
<phrase id="3">
<text> escape_trader_letat_gusi_3</text>
</phrase>
</phrase_list>
</dialog></pre>

Которую нужно вставить в любом месте между dialog id_шниками других веток в файле dialogs_escape.xml.

Главное не промахнутся и засунуть именно между, а не внутрь одного из dialog id

Все что находится между тегами <dialog id="***"> и </dialog> это внутенности конкретного dialog id

Т.е совать наш
<pre><dialog id="escape_trader_letat_gusi">
…
</dialog></pre>

надо

<pre><dialog id="*** ">
…
</dialog>
здесь
<dialog id="*** ">
…
</dialog></pre>

но

<pre><dialog id="*** ">
не здесь
</dialog></pre>

После сохранения внесенных изменений с файлом dialogs_escape.xml все.

'''3)''' Теперь вбиваем сами текстовички в файле gamedata/config/text/rus/stable_dialogs_escape.xml

Т.е нам надо в файле stable_dialogs_escape.xml вставить такую конструкцию:

<pre> <string id="escape_trader_letat_gusi_0">
<text>Сидрыч а почему это у тебя зеленые человечки, что по столу бегают, такие худые?</text>
</string>
<string id="escape_trader_letat_gusi_1">
<text>Чего?!!</text>
</string>
<string id="escape_trader_letat_gusi_2">
<text>Ты их совсем, совсем не кормишь?</text>
</string>
<string id="escape_trader_letat_gusi_3">
<text>В следующий раз, как пойдешь в зону, бери-ка вместо водяры побольше антирада. А то мало что таким перегаром дышишь, уже до зеленых человечков долечился… Шутник.</text>
</string></pre>

в любом месте между уже существующими string id
<pre>
<string id="*** ">
</string>
сюда
<string id="*** ">
</string></pre>

Но не внутрь одного из существующих string id
<pre>
<string id="*** ">
не сюда
</string>
</pre>
После сохранения изменений, у нас все готово. Можно грузить игру и смотреть что получилось.

===Практический пример не работает со вторым патчем - решение проблемы===

По крайней мере со вторым патчем несовместимо условие

<pre><precondition>escape_dialog.trader_has_talk_info_wr</precondition></pre>

использование этого условия приведет к вылету

так как со вторым патчем из файла escape_dialog.script была удалена функция:

<pre>function trader_has_talk_info_wr( trader, actor )
return true
end</pre>

можно либо воткнуть эту функцию обратно в escape_dialog.script

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

<pre><precondition>escape_dialog.trader_alredy_give_job</precondition></pre>

====Дополение от XiaNi====
По поводу <precondition> в данном примере.. он тут реально вообще не нужен тем более что возвращает всегда одно и то же... тут уж или реально надо использовать функцию которая хоть чтото проверяет нужное для диалога... а так... диалог и так будет активным если убрать <precondition> (в данном случае это 100%)

<has_info> и <dont_has_info> это условия на присутствие и соответственно отсутствие у игрока "информации" которая на самом деле всеголишь флажок что пользователь слышал о чемто или видел чтото который выдается:
1. условиями "логики" прописанной объектам или неписям.
2. скриптами
3. диалогами через например "<give_info>tutorial_end</give_info>"

В принципе <has_info> соответствует скриптовому аналогу функции has_alife_info
так например "<has_info>tutorial_end</has_info>" можно заменить на "<precondition>check_tutor_end</precondition>" и дописать в "escape_dialog.script" строчки :
<pre>
function check_tutor_end(actor, npc)
if has_alife_info("tutorial_end")
then
return true
else
return false
end
end
</pre>
в которой мы проверяем есть ли информация tutorial_end у игрока.

==Авторы==

Статья создана:

* [[Участник:BAC9-FLCL|BAC9-FLCL]]
* [[Участник:Keha|Keha]]
* [[Участник:XiaNi|XiaNi]]
[[Категория:Конфигурационные_файлы]]

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

2008-08-10T09:29:12Z

89.178.50.109:

Вступление

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

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

- всегда сохраняйте резервные копии модифицируемых файлов
- старайтесь почаще тестировать внесенные изменения - так проще понять, в чем вы ошиблись (если активно работать пару часов без остановки, не разу не протетировав внесенные изменения, то потом будет очень сложно понять - почему же, черт возьми, игра вылетает при попытке поговорить с Сидоровичем?)
- перед началом работы создайте новую папку gamedata, а свои моды спрячьте подальше: работать с "чистой" версией игры не в пример удобнее и проще; особенно противопоказан Repair Mod, который с новыми диалогами часто конфликтует*

* о том, как создать диалоги и квесты, исключающие возможность конфликта с другими подобными модами, см. часть 4.

Создание базового диалога

Начнем создание квеста с написания небольшого линейного диалога. Это будет выглядеть примерно так:

Меченый: Сидрыч, давай поговорим о... водке.
Сидорович: О водке? Да о какой водке сейчас можно говорить? Вокруг оглянись. Видишь хоть одну бутылку?! Вот. Именно. Кончилась она у меня, родимая, кончилась... помоги, принесешь, а? Вроде у Волка на чердаке была, что-то он однажды об этом упоминал...
Меченый: Да сбегаю я сейчас, сбегаю... алкоголик, блин.
Сидорович: Беги, беги... сил уж нет ждать, давай, родимый.

После третьей фразы у нас будет активироваться квест "Принеси водки Сидоровичу".

Открываем файл gamedata\config\gameplay\character_desc_escape.xml и проводим такие манипуляции:

- находим строку "<actor_dialog>escape_trader_done_blockpost_box</actor_dialog>"
- добавляем после нее новую - "<actor_dialog>escape_trader_oops</actor_dialog>"
- сохраняем изменения

Мы добавили к Диалогу с Сидоровичем новую ветку, вернее, только ссылку на неё. Сама внутренняя структура ветки хранится в файле gamedata\config\gameplay\dialogs_escape.xml, который мы открываем и производим:

- находим в любом месте файла промежуток между </dialog> и <dialog id="...">
- засовываем туда такую конструкцию:

<pre> <dialog id="escape_trader_oops">
<precondition>escape_dialog.trader_alredy_give_job</precondition>
<has_info>tutorial_end</has_info>
<phrase_list>
<phrase id="0">
<text>escape_trader_oops_0</text>
<next>1</next>
</phrase>
<phrase id="1">
<text>escape_trader_oops_1</text>
<next>2</next>
</phrase>
<phrase id="2">
<text>escape_trader_oops_2</text>
<next>1</next>
</phrase>
<phrase id="3">
<text>escape_trader_oops_3</text>
</phrase>
</phrase_list>
</dialog>
</pre>

- сохраняем изменения

Теперь у нас прописана структура новой ветки диалога. Осталось сделать еще одну вещь - прописать строки, которые будут отображаться вместо "escape_trader_oops_...".

Для этого откроем файл gamedata\config\text\rus\stable_dialogs_escape.xml и сделаем следующее:

- находим любой удобный промежуток между </string> и <string id="...">
- прописываем туда следующие строки:

<pre>
<string id="escape_trader_oops_0">
<text>Сидрыч, давай поговорим о... водке.</text>
</string>
<string id="escape_trader_oops_1">
<text>О водке? Да о какой водке сейчас можно говорить? Вокруг оглянись. Видишь хоть одну бутылку?!
Вот. Именно. Кончилась она у меня, родимая, кончилась... помоги, принесешь, а?
Вроде у Волка на чердаке была, что-то он однажды об этом упоминал...</text>

</string>
<string id="escape_trader_oops_2">
<text>Да сбегаю я сейчас, сбегаю... алкоголик, блин.</text>
</string>
<string id="escape_trader_oops_3">
<text>Беги, беги... сил уж нет ждать, давай, родимый.</text>
</string>
</pre>

- сохраняем изменения

Всё. Диалог готов. Можно грузить игру и смотреть, работает ли новая ветка.
А теперь будем прикреплять к этому безобразию квест ""Принеси водки Сидоровичу".

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

Активацию квеста в диалог прикрепить достаточно просто. Проводим с файлом gamedata\config\gameplay\ dialogs_escape.xml следующие манипуляции:

- добавляем содержимое фразы <phrase id="2"> следующим:

<pre>
<phrase id="2">
<text>escape_trader_oops_2</text>
<give_info>kvest_vodka_started</give_info>
<next>3</next>
</phrase>
</pre>

- сохраняем изменения

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

Исправим это недоразумение. Откройте файл gamedata\config\gameplay\tasks_escape.xml и в начале файла создайте такую конструкцию:

<pre>
<game_task id="esc_test_vodka_task">
<title>Принести водки</title> 
<objective>
<text>Принести водки Сидоровичу</text>
<icon>ui_iconsTotal_find_item</icon>
<infoportion_complete>test_quest_vodka_otdana</infoportion_complete> </objective>
<objective>
<text>Вернуться с водкой обратно</text>
<map_location_type hint="esc_dinamit_to_volk">green_location</map_location_type>
<object_story_id>Escape_novice_lager_volk</object_story_id>
<infoportion_complete>test_quest_vodka_otdana</infoportion_complete>
</objective>
<objective>
<text>Найти водку на чердаке</text>
<map_location_type hint="escape_trader">blue_location</map_location_type>
<object_story_id>Escape_Trader</object_story_id>
<infoportion_complete>test_quest_vodka_otdana</infoportion_complete>
</objective>
</game_task>
</pre>

Мы прописали данные о квесте: название, иконку, строки заданий, расположение маркеров и т.д.

К этому файлу мы еще вернемся, т.к. в этом варианте многое проставлялось не иначе как от балды. Я еще подумаю, как заставить задание "Вернуться с водкой обратно" появиться в PDA, а то оно что-то не желает явить себя народу... впрочем, ладно, главное, что все работает и не вылетает. А исправление столь мелких багов - дело десятое. Продолжим.

Откроем файл gamedata\config\gameplay\info_l01escape.xml и зарегистрируем до того отсутствовавшие в игре типы условий (они нам еще пригодятся для завершения работы над квестом):

- после строки <game_information_portions> прописываем:

<pre>
<info_portion id="test_quest_vodka_otdana"></info_portion>

<info_portion id="kvest_vodka_started">
<task>esc_test_vodka_task</task>
</info_portion>

<info_portion id="otkazalsya_prinesty_vodku"></info_portion>
</pre>

С прописыванием условий - всё.

Теперь займемся одной небольшой, но нужной вещью - прописыванием экранных подсказок, которые высвечиваются при получении/выполнении этапа/завершении задания.

Для этого откроем файл gamedata\config\text\rus\string_table_tasks_escape.xml и пропишем там:

<pre>
<string id="esc_test_prinesti_vodku">
<text>Принести бутылку водки</text>
</string>
<string id="esc_test_prinesti_vodku_1">
<text>Найти водку на чердаке у Волка</text>
</string>
<string id="esc_test_prinesti_vodku_2">
<text>Принести бутылку водки Сидоровичу</text>
</string>
</pre>

Теперь можно тестировать, что получилось. Сверяем результаты:

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

Можно приступать к третьей стадии. Что мы забыли? Правильно - возможность выполнить квест.

Реализация возможности выполнить квест

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

0. Сидрыч, давай поговорим о... водке. ( переход к 1)
1. О водке? Да о какой водке сейчас можно говорить? Вокруг оглянись. Видишь хоть одну бутылку?! Вот. Именно. Кончилась она у меня, родимая, кончилась... помоги, принесешь, а? Вроде у Волка на чердаке была, что-то он однажды об этом упоминал... ( выбор - переход к 2, 4, 5; изначально доступен только 2 вариант )
2. Да сбегаю я сейчас, сбегаю... алкоголик, блин. ( получение квеста, переход к 3, после этого перестает быть доступен )
3. Беги, беги... сил уж нет ждать, давай, родимый. ( конец, переход к списку веток Сидоровича )
4. Вот она, твоя бутылка водки. Ну, вернее, не твоя, а Волка... ( появляется только при наличии водки в инвентаре, при выборе водка передается Сидоровичу, квест выполняется, идет переход к 7 )
5. Извини, Сидрыч, я пока еще не раздобыл, терпи... ( появляется только если взять квест, переход к 6 )
6. А ну марш отсюда! Без бутылки пришел... ууу, вражина... ( переход к 8 )
7. Теперь моя будет, Меченый! Ты так Волку и передай. Спасибо, выручил... держи награду. Нееет, это не водка, обойдешься... денег дам. ( выдача награды, переход к 8 )
8. Ну тебя в пень... ( конец, переход к списку веток Сидоровича )

А вот так это будет выглядеть в файле gamedata\config\gameplay\dialogs_escape.xml:

<pre>
<dialog id="escape_trader_oops">
<precondition>escape_dialog.trader_alredy_give_job</precondition>
<has_info>tutorial_end</has_info>
<phrase_list>
<phrase id="0">
<text>escape_trader_oops_0</text>
<next>1</next>
</phrase>
<phrase id="1">
<text>escape_trader_oops_1</text>
<next>2</next>
<next>4</next>
<next>5</next>
</phrase>
<phrase id="2">
<dont_has_info>kvest_vodka_started</dont_has_info>
<text>escape_trader_oops_2</text>
<give_info>kvest_vodka_started</give_info>
<next>3</next>
</phrase>
<phrase id="3">
<text>escape_trader_oops_3</text>
<action>dialogs.break_dialog</action>
</phrase>
<phrase id="4">
<text>escape_trader_oops_4</text>
<precondition>escape_dialog.have_a_vodka</precondition>
<action>escape_dialog.otday_vodku</action>
<next>7</next>
</phrase>
<phrase id="5">
<has_info>kvest_vodka_started</has_info>
<text>escape_trader_oops_5</text>
<next>6</next>
</phrase>
<phrase id="6">
<text>escape_trader_oops_6</text>
<next>8</next>
</phrase>
<phrase id="7">
<text>escape_trader_oops_7</text>
<give_info>test_quest_vodka_otdana</give_info>
<action>escape_dialog.transfer_deneg</action>
<next>8</next>
</phrase>
<phrase id="8">
<text>escape_trader_oops_8</text>
</phrase>
</phrase_list>
</dialog>
</pre>

Теперь добавим в игру скрипты "передача денег" и "передача водки". Откройте файл gamedata\scripts\escape_dialog.script и перед разделителем "Trader" добавьте туда следующие строки:

<pre>
function transfer_deneg (npc, actor)
dialogs.relocate_money(stalker, 8000, "in")
end

function otday_vodku (npc, actor)
dialogs.relocate_item_section(npc, "vodka", "out")
end

function have_a_vodka (stalker, player)
return stalker:object ("vodka") ~= nil
end
</pre>

Готово. Запускайте игру и любуйтесь.

Есть несколько багов, кто исправит, тому пирожок =)
Итак:

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

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

Реализация совместимости

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

Вместо dialogs_escape.xml мы будем испольховать новый - dialogs_new.xml
Вместо stable_dialogs_escape.xml мы будем использовать файл stable_dialogs_new.xml (важно! не знаю почему, но он должен лежать в text\..., а не в text\rus\...)

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

Единственное, что останется сделать после установки того же Repair Mod'а - заново добавить ветку диалога Сидоровичу в файле character_desc_escape.xml. Остальное в новом варианте нашего мода переписывать не придется - для диалогов отведено три файла.

Остальные файлы относятся уже к квестовой части и ни с чем пересекаться не могут - где вы видели другие моды с новыми квестами? Я - нет.

Откройте файл gamedata\config\localization.ltx и зарегистрируйте там stable_dialogs_escape.ltx.
Потом откройте файл gamedata\config\system.ltx и в разделе "Dialogs" в конце строки (после dialogs_aes) пропишите dialogs_new (без ".ltx"!).

Все. Теперь ваши диалоги будут подгружаться из сторонних файлов.

Отдельное спасибо:

XiaNi - за страшный и непричесанный, но работающий пример квеста, на основе которого я и освоил принципы квестостроения =)
Keha – за урок по созданию новых диалогов
Dйja Vu – за создание wiki-ресурса

Дополнения

1. Если изменить шапку нашего диалога в файле dialogs_escape.xml со старого варианта на такой, то ветка исчезнет после выполнения задания:

<pre>
<dialog id="escape_trader_oops">
<precondition>escape_dialog.trader_alredy_give_job</precondition>
<has_info>tutorial_end</has_info>
<dont_has_info>test_quest_vodka_otdana</dont_has_info>
<phrase_list>
</pre>

...

Не тестировал. Дело за вами =)

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

Кто сможет разузнать, откуда берутся тексты для этих реплик, тому буду очень благодарен...

3. Неплохо бы добавить реплики гопникам, но это уже на стадии предположений. На данный момент реплик у них нет, так что если вы, например, играете с модом "Улучшенные взаимоотношения" (или как там его) или какими-либо иными способами добились нейтрального/дружеского отношения с их стороны, то при потытке заговорить игра вылетит.

В принципе, можно зарегистрировать новые базы диалогов для бандитов (как было описано выше), созданные по образцу таковых у сталкеров. Но как эти наборы диалогов связать с гуляющими по карте гопниками - вопрос.

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

Фух, вроде всё...

Всем спасибо, занавес =)

==Авторы==

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

[[Категория:Статьи участников]]
[[Категория:Скрипты]]

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

2008-08-10T09:27:30Z

89.178.50.109:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

<code>
</info_portion>
</code>

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

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

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

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

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

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

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

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

По кусочкам:

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

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

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

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

<code>
<function_complete>escape_tasks.task_fox_complete</function_complete>
</code>

Вызывает функцию из файла escape_tasks.script под именем task_fox_complete. При выполнении данной функции дается info_portion, который завершает данную подзадачу, в случае, если все условия функции соблюдаются.

<code>
<infoportion_complete>escape_fox_heal</infoportion_complete>
</code>

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

<code>
<infoportion_fail>esc_dogs_return</infoportion_fail>
</code>

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

<code>
<map_location_type hint="esc_fox">green_location</map_location_type>
</code>

Создает указатель на карте с подсказкой esc_fox и типом green_location.

<code>
<object_story_id>Escape_stalker_from_raid</object_story_id>
</code>

Указывает на sid из файла gamedata\config\game_story_ids.ltx

<code>
<infoportion_set_complete>garbage_meetstalker_start</infoportion_set_complete>
</code>

Автоматически устанавливает данную подзадачу в положение «Выполнено», если у игрока есть данный info_portion. //!!!!!!Не уверен – не пользовался не разу.

<code>
<text>esc_help_wounded_from_raid_0</text>
</code>

Содержит описание подзадачи. Может содержать внутри как текст, так и ссылку на текст.

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

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

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

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

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

</phrase_list>
</dialog>

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

</phrase_list>
</dialog>

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

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

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

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

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

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

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

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

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

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

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

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

==Авторы==

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

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

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