Создание мода от А до Я

[ScR1pt 837]

В этой теме я постараюсь расписать процесс создания мода от А до Я (Работа с игровыми файлами, СДК и прочее). Тут будет наиболее полная база по всему, что может пригодиться в разработке.

В свободное время, эта тема будет мной дополняться.

Спойлер

Первое, что нам нужно - распаковать игровые файлы. Делать это будем с помощью Stalker Universal Extractor.

Запускаем программу, жмём на кнопку "Найти архивы" и выбираем путь до папки с игрой.
Если вы сделали всё правильно, то у вас должен появиться список найденных архивов.

Далее, правее кнопки "Найти архивы" есть список версий (изначально -2947ru).

Если вы распаковываете Зов Припяти или Чистое Небо, то нужно поменять его на -xdb.
Если же вам нужен Тень Чернобыля, то оставляете -2947ru (-2947ww, если у вас английская локализация).

После того, как вы всё выбрали, нажимаете "Начать распаковку".
Если вы сделали всё верно, то в папке с игрой должна появиться папка gamedata с распакованными файлами. Рекомендую переименовать её в gamedataFull, после чего создать пустую gamedata для вашего мода.
Затем вы будете брать из gamedataFull только те файлы, которые вы будете редактировать, и переносить в обычную gamedata.

Спойлер

Переходим по пути gamedata\configs\text\rus и открываем какой-нибудь файл через Блокнот, Notepad++, Visual Studio Code или любой другой текстовый редактор. Для примера возьмём файл st_characters.xml из Зова Припяти. Он содержит имена всех персонажей в игре. Через поиск (обычно Ctrl + F) ищем имя главного героя (Дегтярёв). Меняем текст имени на свой и жмём сохранить файл. После чего заходим в игру и проверяем изменения.

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

Тут мы можем ознакомиться со структурой всех текстовых файлов во всей игре.

Спойлер

<string id="st_actor_name">
<text>Дегтярёв</text>
</string>

• st_actor_name - Текстовый идентификатор, который мы указываем в других файлах (имя в профиле НПС, диалоги, квесты и т.д.)
• Дегтярёв - Собственно говоря, сам текст, который мы и будем видеть в игре.

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

Спойлер

Идём по пути gamedata\configs\gameplay и открываем файл character_desc_general.xml.

Самый первый профиль actor - это и есть наш главный герой. Подробно все параметры мы разберём, когда будем создавать своего НПС. А пока, нас интересует сегмент <supplies>.

Спойлер

<supplies>
[spawn] \n
device_torch \n
wpn_binoc \n
wpn_knife \n
detector_simple \n
helm_respirator \n
stalker_outfit \n
grenade_rgd5 = 2 \n
wpn_pm_actor  \n
ammo_9x18_fmj = 3 \n
wpn_ak74u \n
ammo_5.45x39_fmj = 3 \n
bandage = 2 \n
antirad = 1 \n
medkit = 4 \n
bread = 1 \n
kolbasa = 1 \n
conserva = 2 \n
</supplies>

Для удобства, что выделено зелёным цветом - секции предметов. Если нам нужно выдать персонажу (в нашем случае - главному герою) несколько одинаковых предметов (например, аптечек или патронов) мы, после названия секции, дописываем = 2.
То есть, если у нас строка выглядит так:
medkit = 2 \n
Персонаж получит две аптечки.
Если нам нужна одна аптечка, то пишем без знака =.
medkit \n

Для теста, можем заменить стартовый броник. Вместо stalker_outfit пишем exo_outfit.
Заходим в игру, у нас должен быть экзоскелет.

Ниже </supplies> у нас есть ещё такая строка:
<money min="2500"  max="2500"  infinitive="0"/>
min - Минимальное кол-во денег при старте игры.
max - Максимальное кол-во денег при старте игры. 
Если эти значения разные, то будет выбираться случайное число в их диапазоне.

Спойлер

Переходим в папку gamedata\textures\ui и ищем файлы:

• ui_iconstotal.dds - Для ТЧ
• ui_actor_portrets.dds - Для ЗП

Файлы открываем при помощи любой программы, поддерживающей формат .dds (Рекомендую Paint.net)
В этих файлах содержится портрет для нашего главного героя. В случае с Зовом Припяти, в этом файле содержатся так же и портреты для всех остальных НПС.

Заменяем портрет нашего главного героя в программе, а затем заходим в игру и проверяем.

Спойлер

Ищем по пути gamedata\configs\gameplay файл с профилями НПС. Заменять модель будем Бороде, а значит нам нужен файл character_desc_zaton.xml. 

Чтобы мы могли быстро и удобно найти его, можем открыть файл с именами НПС: gamedata\configs\text\rus\st_characters.xml.
В нём, через поиск, находим, где написано "Борода". Выше смотрим его текстовый идентификатор, в нашем случае это zat_a2_stalker_barmen_name.

Возвращаемся в файл character_desc_zaton.xml и ищем, где прописан этот идентификатор. Это профиль zat_a2_stalker_barmen. 

Нам нужна строка <visual> 

Спойлер

<visual>actors\stalker_neutral\stalker_neutral_3_face_1</visual>

• stalker_neutral_3_face_1 - сам файл с моделькой НПС.
• actors\stalker_neutral - путь до модельки от папки meshes.

Заменим модель Бороде на сталкера в экзоскелете. Мы переписываем stalker_neutral_3_face_1 на stalker_neutral_4.

Заходим в игру и проверяем изменения.

Спойлер

Переходим по пути gamedata\configs\gameplay и открываем файл dialogs_zaton.xml

Листаем в самый низ и ПЕРЕД </game_dialogs> вставляем следующее:

Спойлер

<dialog id="zat_boroda_test_dialog">
<dont_has_info>zat_boroda_test_dialog</dont_has_info>
<phrase_list>
<phrase id="0">
<text>zat_boroda_test_dialog_0</text>
<next>1</next>
</phrase>
<phrase id="1">
<text>zat_boroda_test_dialog_1</text>
<next>2</next>
</phrase>
<phrase id="2">
<text>zat_boroda_test_dialog_2</text>
<next>3</next>
</phrase>
<phrase id="3">
<text>zat_boroda_test_dialog_3</text>
<next>4</next>
</phrase>
<phrase id="4">
<text>zat_boroda_test_dialog_4</text>
<give_info>zat_boroda_test_dialog</give_info>
</phrase>
</phrase_list>
</dialog>

• <dialog id="zat_boroda_test_dialog"> - Создаём сам диалог и выдаём ему идентификатор zat_boroda_test_dialog, который будем прописывать в профиле конкретного НПС (в нашем случае пропишем Бороде).
• <dont_has_info>zat_boroda_test_dialog</dont_has_info> - Проверяем, если у нас НЕТ инфопоршня zat_boroda_test_dialog, то диалог нам доступен. Если вместо dont_has_info прописать has_info, то всё будет наоборот: диалог будет доступен, если у нас ЕСТЬ инфопоршень zat_boroda_test_dialog.
• <give_info>zat_boroda_test_dialog</give_info> - Выдаём в КОНЦЕ диалога инфопоршень zat_boroda_test_dialog, чтобы наш диалог не был зацикленным, поскольку у нас есть условие dont_has_info, проверяющее отсутствие инфопоршня.
• <phrase id="0"> - Создание одной фразы, в данном случае нулевой, с которой должен начинаться ЛЮБОЙ диалог. Это будет первая фраза в нашем диалоге. В следующий фразах мы присваиваем другие айди, которые будут указываться в <next>.
• <next>1</next> - Переход на следующую фразу в диалоге, в данном случае на фразу с айди 1.
• zat_boroda_test_dialog_0 - Техническое обозначение для текста, который мы будем прописывать в файлах по пути gamedata\configs\text\rus. 

Пропишем диалог в профиль у нашего НПС. Открываем character_desc_zaton.xml по пути gamedata\configs\gameplay.
Ищем <specific_character id="zat_a2_stalker_barmen",  ранее мы уже выяснили, что это профиль Бороды. Листаем профиль чуть ниже, до места, где прописаны <actor_dialog>. В конце, перед <actor_dialog>actor_break_dialog</actor_dialog> (это диалог о выходе из диалога. Т.е. фраза "Пока/Бывай/До встречи".) вставляем это:
<actor_dialog>zat_boroda_test_dialog</actor_dialog>
zat_boroda_test_dialog - тот самый идентификатор, который мы писали в dialog id= в начале нашего диалога.

Помимо <actor_dialog> есть ещё и <start_dialog>.
Их разница в том, что <actor_dialog> начинает диалог (нулевую фразу) со стороны нашего главного героя, а <start_dialog> начинает диалог со стороны НПС.

Пропишем сам текст. Открываем файл st_dialogs_zaton.xml по пути gamedata\configs\text\rus.
ПЕРЕД </string_table> вставляем следующее:

Спойлер

<string id="zat_boroda_test_dialog_0">
<text>Здоров, Борода.</text>
</string>
<string id="zat_boroda_test_dialog_1">
<text>Привет, хочешь выпить?</text>
</string>
<string id="zat_boroda_test_dialog_2">
<text>Нет, спасибо. Может, расскажешь что интересного?</text>
</string>
<string id="zat_boroda_test_dialog_3">
<text>Да вроде нечего рассказать... Всё как обычно.</text>
</string>
<string id="zat_boroda_test_dialog_4">
<text>Ну хорошо. Если что нового будет - сообщи.</text>
</string>

• zat_boroda_test_dialog_0 - Мы ранее прописывали каждой фразе в файле dialogs_zaton.xml.
• Здоров, Борода. - Текст, который мы будем видеть в игре в диалоге.

Это максимально примитивный диалог. Без разветвлений, разных условий, активаций скриптов и т.д.
Но для теста и примерного понимания, как работают диалоги, он подойдёт.

Спойлер

Разберём добавление в диалог каких-нибудь функций и проверок.
Начнём с простого: проверки наличия предмета у главного героя. Пусть диалог будет доступен, если у нас есть водка.
Между <dialog id= и <phrase_list> добавим следующее:

<precondition>mod_functions.zat_vodka_dialog_check</precondition>

• precondition - Создание условия для доступности диалога.
• mod_functions - Имя файла, в котором мы пропишем функцию для проверки чего-либо. В нашем случае наличия водки.
• zat_vodka_dialog_check - Название для функции, которая будет выполнять функцию проверки и возвращать значение true.

Создаём по пути gamedata\scripts файл mod_functions.script
Создадим в нём нашу функцию zat_vodka_dialog_check:

Спойлер

function zat_vodka_dialog_check(first_speaker, second_speaker)
return db.actor:object("vodka") ~= nil
end

• function - Объявление/создание функции, в нашем случае zat_vodka_dialog_check.
• vodka - Секция предмета, который мы проверяем. В нашем случае это секция Водки.
• end - Конец функции.

Теперь диалог будет доступен только если у нас есть водка.

Добавим функцию забирания водки в конце диалога и выдачу награды, скажем, в 500 рублей.
В том же файле mod_functions.script по пути gamedata\scripts пишем:

Спойлер

function zat_vodka_dialog_out(first_speaker, second_speaker)
dialogs.relocate_item_section_from_actor(first_speaker, second_speaker, "vodka") -- Забираем у ГГ водку
dialogs.relocate_money_to_actor(first_speaker, second_speaker, 500) -- Выдаём ГГ 500 рублей
end

Пропишем нашу функцию в диалоге. Пишем ПЕРЕД ПОСЛЕДНЕЙ </phrase> в нашем диалоге:

<action>mod_functions.zat_vodka_dialog_out</action>

• action - Выполнение в диалоге какой-то функции в скриптовом файле.

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

<action>dialogs.break_dialog</action>

Спойлер

Пропишем свой собственный файл с квестами, чтобы не трогать оригинальные. По пути gamedata\configs\misc берём файл task_manager.ltx.
Открываем его и под #include "tm_pripyat.ltx" пишем:
#include "tm_mod.ltx"

Создаём по этому же пути (gamedata\configs\misc) наш новый прописанный файл tm_mod.ltx
Открываем его и пропишем в нём квест:

Спойлер

[zat_find_vodka_quest]
icon = ui_inGame2_Put_na_plato
prior = 10
storyline = false
title = {=actor_has_item(vodka)} zat_bring_vodka_name, zat_find_vodka_name
descr = {=actor_has_item(vodka)} zat_bring_vodka_desc, zat_find_vodka_desc
target = nil
reward_money = 10000
condlist_0 = {+zat_vodka_quest_done} complete

• zat_find_vodka_quest - Идентификатор для квеста. Он нам нужен для его выдачи.
• icon - Иконка для квеста. В нашем случае это ui_inGame2_Put_na_plato
• prior - Приоритет квеста в КПК. Чем больше - тем выше квест в списке.
• storyline - Является квест сюжетным или нет. По сути влияет только на то, какой цвет будет у нашего квеста в КПК (Жёлтый - для основной сюжетки. Белый - для побочек). Принимает значения true или false.
• title - Название квеста. Прописываем текст для zat_find_vodka_name и zat_bring_vodka_name по пути gamedata\configs\text\rus в файле st_quests_zaton.xml.
• descr - Описание квеста. Так же прописываем текст для zat_find_vodka_desc и zat_bring_vodka_desc по пути gamedata\configs\text\rus в файле st_quests_zaton.xml
• =actor_has_item(vodka) - Функция для проверки наличия водки. Служит для обновления квеста и смены его названия, описания и метки. Если заменить = на !, то функция начнёт работать наоборот. То есть квест будет обновлён, если у нас водки нет. В {этих скобках} так же можно добавлять и другие условия, например наличие {+zat_vodka_quest} или отсутствие {-zat_vodka_quest} инфопоршня.
• target - Метка на карте. Здесь нужно прописывать Стори Айди, который указывается в секциях для НПС, в логике рестриктора или где-либо ещё, на что можно добавить метку. В нашем случае прописана nil - это отсутствие метки вообще.
• reward_money - Награда за квест в деньгах.
• condlist_0 - Условия для завершения квеста. {+zat_vodka_quest_done} - Если у нас есть инфопоршень zat_vodka_quest_done, то квест переходит в complete, то есть выполняется. Вместо complete мы можем так же вписать reversed (Отмена квеста) или fail (Провал квеста).
  Стоит так же отметить, что если прописать так: 
  condlist_0 = {+zat_vodka_quest_done} complete %=kill_actor%
  То при переходе квеста в состояние complete у нас выполнится функция, прописанная между %%. В нашем случае это kill_actor, которая убивает главного героя. Вместо неё можно прописать любую другую функцию из файла xr_effects.script, в том числе и свою.

Выдадим квест в диалоге. Прописывание функции в диалог мы разбирали в прошлом уроке. Пишем в нашем скриптовом файле функцию для выдачи:

Спойлер

function zat_vodka_quest_start()
task_manager.get_task_manager():give_task("zat_find_vodka_quest")
end

 

 

Изменено 1 час назад пользователем ScR1pt

[Злобная реклама]

[Josra102 14]

Что мои молитвы были услышаны?

[Hunter 2 866]

55 минут назад, ScR1pt сказал:

Если вы распаковываете Зов Припяти, то нужно поменять его на -xdb

Чн тоже xdb, добавь.

[Faktor Never 30]

Услышал господь нас

Спасибо, легенда

 

[Joziesi 56]

ура спасибо теперь я сделаю свою васянку за 20 минут!

[ziken 29]

Интересно бы увидеть урок по созданию иконок для инвентаря. 

[ScR1pt 837]

ziken со временем всё будет

[Stratigos 0]

Попробуем

[Пол Дэвидсон 9]

Это очень хорошо. А случайно в формате видеоуроков не проще будут? 

[Hunter 2 866]

ScR1pt спасибо за добавление