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

[ScR1pt 848]

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

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

Спойлер

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

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

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

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

Имейте ввиду, что в случае с распаковкой Зова Припяти, мы должны так же переместить в списке архивы из папок localization и patches в самый низ при помощи стрелочек слева.

После того, как вы всё выбрали, нажимаете "Начать распаковку".
Если вы сделали всё верно, то в папке с игрой должна появиться папка 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

 

Спойлер

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

Рекомендую скачать СДК отсюда:

Спойлер

  

Нас интересует Full версия архива. Скачиваем его и открываем. Из содержимого, нам нужна только папка editors. Распаковываем её в удобное для нас место, но есть один ОЧЕНЬ ВАЖНЫЙ МОМЕНТ: 
По пути к СДК НЕ ДОЛЖНО БЫТЬ РУССКИХ БУКВ И ПРОБЕЛОВ, иначе могут возникнуть проблемы.

Я, для удобства, распакую папку прямо в диск С. Папку editors можно переименовать в XRay_SDK для удобства. То есть, в моём случае, путь к СДК выглядит так: C:\XRay_SDK

Теперь нужно избавиться от .cmd файлов от старых и медленных компиляторов. Позже мы заменим их на более быстрые. Заходим в папку с СДК и удаляем все .cmd файлы, КРОМЕ первых, названиях которых начинаются на !.

Далее нужно настроить пути внутри самого СДК. Ищем файл converter.ini и открываем его через текстовый редактор.
Нам нужно найти такие строчки:
; 3870+ (Call of Pripyat включая обновления)
[3870_config]:3456_config
$game_data$            = X:\gamedata\
$game_levels$            = X:\gamedata\levels\

Нам нужно заменить $game_data$ и $game_levels$ на свои пути. В моём случае это будет выглядеть так:
; 3870+ (Call of Pripyat включая обновления)
[3870_config]:3456_config
$game_data$            = C:\XRay_SDK\gamedata\
$game_levels$            = C:\XRay_SDK\gamedata\levels\

Далее переходим в папку converter. Там открываем файл fsconverter.ltx.
В нём нам нужна строка:
$sdk_root$                  = false| false| x:\

Заменяем её на наш путь:
$sdk_root$                  = false| false| C:\XRay_SDK\

Осталось заменить компиляторы на более быстрые. Скачиваем их отсюда:

Спойлер

 

Просто распаковываем архив в нашу папку с СДК.

Всё! Настройка СДК закончена. Теперь с ним можно полноценно работать.

Спойлер

Разберём подключение новой локации в игру. Возьмём для примера самую популярную: Кордон.
К нашей радости, локации из ЧН спокойно можно дёргать на ЗП без необходимости в перекомпиляции.

Для начала нам нужно перенести некоторые файлы из gamedata Чистого Неба И в gamedata нашего мода И в gamedata СДК.

По пути gamedata(ЧН)\levels берём папку escape
Это и есть сама локация

Далее нам нужна текстура для карты.
Начнём с глобальной карты. По пути gamedata(ЧН)\textures\ui берём файл ui_global_map.dds
Для карты локации открываем gamedata(ЧН)\textures\map и переносим по такому же пути в нашу gamedata файл map_escape.dds

Затем из gamedata(ЧН)\textures\terrain берём файлы:

• terrain_escape.thm
• terrain_escape_det.thm
• terrain_escape_mask.dds
• terrain_escape_mask.thm

Теперь нужно прописать нашу локацию в конфигах. Нам нужны два файла по пути gamedata\configs:

• game_levels.ltx
• game_maps_single.ltx

Берём эти файлы из gamedata Зова Припяти. Нам необходимо их немного поправить, взяв некоторые элементы из этих же файлов из gamedata Чистого Неба и убрав оригинальные локации.

Спойлер

[levels]
level01

[level01]
name   = escape
caption = "escape"
offset  = 2130.0,     1000.0,    3970.0
weathers = [default]
id  = 01

Спойлер

Для начала увеличим оригинальную глобальную карту до размеров ЧН, чтобы наши карты локаций совпадали по положению.
Нас интересует секция [global_map]
В ней мы меняем:
bound_rect = 0.0, 0.0, 1024, 1024.0
на
bound_rect = 0.0, 0.0, 1024, 2634.0

Далее мы удаляем всё, что находится ниже [level_maps_single]. Затем добавляем ПОД этой секцией:

escape =

[escape]
global_rect = 358.0, 2022.0, 564.0, 2434.000000
music_tracks = zaton_musics
weathers = dynamic_default

Так же нам надо прописать имя нашей локации, чтобы на карте в КПК и на экране загрузки сохранения у нас было написано "Кордон", а не "escape". Делаем это в файлах по пути gamedata\configs\text\rus

Спойлер

<string id="escape">
<text>Кордон</text>
</string>

Ищем исходники нужной нам локации в интернете. Содержимое мы должны перенести в папку rawdata в SDK. Исходники всегда приоритетнее, поскольку декомпиляция уровня работает далеко не идеально. 

Если исходников у нас на руках нет, то нужно декомпилировать локацию в СДК, чтобы мы могли работать с ней.
Переходим в нашу папку с СДК. Нам нужна папка converter.

Если у вас видеокарта AMD, то берём файл !Декомпиляция уровня x64.cmd
Если у вас видеокарта Nvidia, то берём !Декомпиляция уровня x64-CUDA.cmd

Жмём Правую кнопку мыши по файлу и "Изменить".
Тут нам нужно заменить прописанный два раза zaton на escape. 
Сохраняем файл и запускаем его. 

Дожидаемся окончания декомпиляции уровня. После чего запускаем !LevelEditor.cmd из папки с СДК.
Справа сверху жмём File-Open и открываем escape.level

Для перемещения камеры используем комбинацию Shift + ПКМ/ЛКМ. Попробуйте привыкнуть.

Если вас смущает белая текстура земли (террейна), то из gamedata\levels\escape\terrain возьмите terrain_escape.dds и перенестие его в gamedata\textures\terrain в СДК.

Нам нужно заспавнить нашего главного героя. Справа нажимаем на Spawn Element, снизу выбираем actor.
Чтобы заспавнить нашего выбранного actor, жмём на иконку чайника слева сверху, а затем жмём ЛКМ в том месте, где хотим его заспавнить.

После того, как он появился, жмём ПКМ и выбираем Properties
Находим внизу npc profile и меняем его с default на actor.

Далее нам необходимо в той же вкладке Spawn Element найти сверху коллекцию ai. Выбираем в ней graph point и так же ставим где-то на локации. Можно рядом с нашим ГГ. Главное, чтобы он находился на АИ-Сетке (Квадратики со стрелочками на земле в СДК). Её мы разберём в дальнейшем.

После того, как мы всё сделали, нажимаем справа сверху File-Save. Затем Compile-Make Game.

Дожидаемся конца сборки и можем закрывать СДК.

Открываем папку с нашим СДК и ищем Compiler_Make_spawn.cmd
Открываем его с помощью текстового редактора и заменяем zaton на escape.
После замены, можем запускать файл.

После завершения сборки, переходим в СДК по пути gamedata\spawns и берём файл all.spawn.
Переносим его в gamedata игры и можем её запускать и тестировать новую локацию.

Можете обратить внимание, что у нас нет предпоказа локации на загрузочном экране. Они должны находиться по пути gamedata\textures\intro, но просто выдергивать intro_escape_1.dds из Чистого Неба в Зов Припяти их не стоит, поскольку экраны в ЗП и ЧН отличаются. Лучше возьмите эти экранчики из какого-нибудь мода на ЗП, где уже есть Кордон.

Так же вы наверняка заметите, что каких-то текстур нет, а на каких-то есть жёлтые надписи.
Исправить это можно, если скачать текстуры из ЧН отсюда - https://disk.yandex.ru/d/9i_Qr3naqfROcQ

 

 

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

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

[Josra102 14]

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

[Hunter 2 867]

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

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

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

[Faktor Never 31]

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

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

 

[Joziesi 57]

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

[ziken 32]

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

[ScR1pt 848]

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

[Stratigos 0]

Попробуем

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

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

[Hunter 2 867]

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

[stasik96 42]

Уважаемый @ScR1pt, спасибо за данную тему!

[Skala 364]

ScR1pt А не лучше ли диалоги через сдк писать? Имхо так удобнее и быстрее

[aka_sektor 353]

В 23.08.2026 в 18:54, ScR1pt сказал:

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

Вот из-за таких гайдов, потом куралесят моды. ВАЖНО! Список найденных архивов формируется в алфавитном порядке.
Если с ТЧ такой порядок роли не играет, то с ЧН/ЗП ОБЯЗАТЕЛЬНО необходимо вручную передвигать архивы локализации и патчей в самый конец списка.

---

Дополнено 5 минуты спустя

В 23.08.2026 в 18:54, ScR1pt сказал:

converter.ini

ВАЖНО! С дуру многие молодые модмейкеры декомпилируют уровни, а потом у них СДК валится. Потому что не врубаются, что конвертер создает кучу объектов на которые разбивается уровень.

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

[Week of the agents 237]

Подписался, позырим