Моддинг трилогии S.T.A.L.K.E.R. - modFAQ.RU | +TES/Fallout - Вклад [ru]

Universal ACDC

2024-06-06T17:37:36Z

WolfHeart: /* Возможные ошибки и их исправление */

__NOTOC__
{| class="wikitable" style="float:right; margin-left:0.8em; clear:right; text-align: center; font-size:12px; width: 300px;"
|-
| colspan=2 style="font-size:20px;"|
'''Universal ACDC'''
|-
| '''Разработчик'''
| bardak
|-
| '''Модифицировали'''
| [[Kolmogor]], [[K.D.]]
|-
| '''Версия'''
| 1.38 от 21 мая 2014 года
|-
| '''Тип'''
| распаковщик/запаковщик
|-
| '''Платформа'''
| [[ActivePerl]]
|-
| '''Форматы файлов'''
| [[*.spawn]]
|-
| colspan=2| [[Версии Universal ACDC|История версий]]
|}

'''Universal ACDC'''<ref>[http://www.amk-team.ru/forum/topic/11568-universal-acdc-i-drugie-perl-skripty/page-1 Тема "Universal ACDC" на AMK форуме]</ref><ref>Информация из файла ReadMe.txt</ref> — это набор скриптов для работы со спавном [[S.T.A.L.K.E.R. - Тень Чернобыля]], [[S.T.A.L.K.E.R. - Чистое Небо|Чистое Небо]], [[S.T.A.L.K.E.R. - Зов Припяти|Зов Припяти]] и их билдов.

{| class="mw-collapsible mw-collapsed wikitable"
! colspan=4| Ссылки на скачивание
|-
| Universal ACDC
| https://yadi.sk/d/i4IVmWdb3PSxsg 
https://cloud.mail.ru/public/5DPy/5fLhTWXEF
|-
| Stkutils
| https://yadi.sk/d/msJH_Nb_3PSxsV 
https://cloud.mail.ru/public/3rYs/2gEPr2WvU
|}

== Возможности ==
* Распаковка оригинальных спавнов '''ТЧ''', '''ЧН''', '''ЗП''' и '''билдов ТЧ''', начиная с build 1265
* Распаковка спавнов от модов (требуется папка конфигов от мода)
* Конвертация спавна в любую другую версию
* Массовая замена гейм-вертексов в распакованном спавне
* Разбивка '''all.spawn''' на '''level.spawn''''ы и '''level.game''''ы
* Сравнение распакованных спавнов
* Обновление вертексов согласно координат объектов

== Установка ==
Распакуйте архив '''ACDC''' в удобную для вас директорию.

Переместите папку '''stkutils''' из архива в корневую директорию '''ACDC'''.

== Использование ==
{| class="mw-collapsible mw-collapsed wikitable"
! Распаковка спавна
|-
|
Режим предназначен для распаковки файлов '''all.spawn''' и '''level.spawn'''
<pre>
universal_acdc.pl -d <spawn_file> [common_options]
</pre>
<code>-d <spawn_file></code> - путь до спавна.

<code>common_options</code> - общие опции. Читайте про них ниже.

При распаковке спавнов от модов может возникнуть ошибка <code>'unknown section'</code>

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

Для распаковки такого спавна необходимо использовать ключ <code>-scan</code>, указав ему в качестве параметра путь до папки ''config(-s)''.

Пример смотрите в батнике '''acdc_decompile_scan'''.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Запаковка спавна
|-
|
Режим предназначен для запаковки распакованных текстовых файлов спавна в '''all.spawn''' или '''level.spawn'''
<pre>
universal_acdc.pl -compile <dir> [-idx <index_file>] [-f <flag1,flag2,...>] [common_options]
</pre>
<code>-compile <dir></code> - папка, в которой лежит распакованный спавн. Если работаете в текущей папке, <code><dir></code> не нужно.

<code>common_options</code> - общие опции. Читайте про них ниже.

<code>-idx <index_file></code> - с этим ключом скрипт сформирует [[*.ltx]]-конфиг с секциями вида:
<pre>
[13_box_wood_01_0021] ;формат - "индекс_локации"_"имя_объекта"
id = 2907 ;id объекта
story_id = -1 ;story_id объекта
</pre>
Такие записи создадутся для ВСЕХ объектов из спавна.

Если указать ключ <code>-idx</code> без пути до конфига, он появится в папке с '''universal_acdc''' (''spawn_ids''). Зачем это нужно? В игре вы сможете открыть этот файл из скриптов и найти нужный вам объект.

Если раньше для нахождения нужного '''id''' объекта по имени требовалось перебрать все объеты в игре, теперь это можно сделать, просто считав '''id''' из нужной секции конфига.

Также есть кое-какие дополнительные фичи:
* при компиляции для правильной работы необязательно проставлять всем секциям в спавне параметры <code>version</code> и <code>script_version</code>. Достаточно поставить их в секции актора, ацдц далее будет использовать их. Полезно, когда спавн "сборный".
* при компиляции контролируется уникальность параметров <code>story_id</code>, чтобы не мучатся потом с вылетами игры.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Конвертирование спавна
|-
|
Режим позволяет конвертировать спавны '''ТЧ''', '''ЧН''', '''ЗП''' между собой.
<pre>
universal_acdc.pl -convert <file> -version <new_version> [-ini <file>] [common_options]
</pre>
<code>-convert <file></code> - файл, который нужно сконвертировать. Можно указывать как запакованный ([[*.spawn]]) спавн,
так и распакованный ('''alife_***.ltx''').

'''Внимание!''' Так как граф и кросс-таблицы в '''ЧН''' и '''ЗП''' вшиты в спавн, для конвертирования ЗАПАКОВАННЫХ спавнов '''ТЧ''' в эти форматы вам потребуется положить в папку с '''universal_acdc''' папку '''levels''' из игры.

Необязательно копировать все файлы, достаточно оставить в папке с каждой локацией файл '''level.gct'''

<code>-version <new_version></code> - новая версия спавна. Подобрать версию вы сможете, посмотрев файл '''spawn_versions.txt'''

<code>-ini</code> - файл тонкой настройки конвертации (''convert.ini''). Если не указан, используется '''convert.ini''', лежащий в текущей папке.

<code>common_options</code> - общие опции. Читайте про них ниже.

Также поддерживается тонкая настройка конвертации через файл '''convert.ini'''

В файле есть две секции: <code>[exclude]</code> и <code>[change]</code>. В секции '''exclude''' можно прописать те секции, которые надо удалить из спава при конвертации.

Пример:
<pre>
[exclude]
sections = m_trader, m_car, flesh_weak
</pre>

Также поддерживается маскирование. Вместо кучи однотипных секций (''stalker_zombied, stalker_sakharov и т.д.'') можно задать маску, используя символ <code>*</code>.

Пример:

<code>stalker*</code>. Такая запись приведет к исключению всех секций, в названии которых есть слово ''stalker''.

В секции '''change''' прописываются имена тех секций, в которых нужно что-то поменять или дополнить.

Пример:
<pre>
[change]
sections = inventory_box
</pre>
Далее заполняете файл записями для тех секций, которые вы прописали в '''change'''. Пример:
<pre>
[inventory_box] //section_name нужной секции
add:custom_data = PREVED //префикс add используется для тех параметров, в которые нужно добавить
add:game_vertex_id = 10000 //необходимое значение (если число - складывается, если строка - добавляется в конец)
rep:level_vertex_id = 0 //префикс rep используется для параметров, которые необходимо заменить на что-то
</pre>
Общий пример. Следующий конфиг приведет к тому, что у всех сталкеров прибавится 500 к гейм-вертексу и
визуал сменится на визуал вояки в противогазе:
<pre>
[exclude]

[change]
sections = stalker

[stalker]
add:game_vertex_id = 500
rep:visual_name = actors/soldier/soldier_antigas.ogf
</pre>
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Массовая замена вертексов
|-
|
При подключении новых локаций без перекомпиляции графа возникает необходимость одновременного
сдвига всех гейм-вертексов спавна новых локаций на какое-то определенное значение.
Это можно сделать в этом режиме.
<pre>
universal_acdc -parse <file> -old <old_gvid0> -new <new_gvid0> [-way] [common_options]
</pre>
<code>-parse <file></code> - имя [[*.ltx]], в котором находится спавн.

<code>-old <old_gvid0></code> - старый начальный '''game_vertex_id''' локации.

<code>-new <new_gvid0></code> - новый начальный '''game_vertex_id''' локации.

<code>-way</code> - обрабатывает также файл '''way_***.ltx''' для этой же локации.

Пример:

<code>universal_acdc -parse alife_l01_escape.ltx -old 0 -new 934</code>
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Разбивка all.spawn на level.spawn
|-
|
Разбивка '''all.spawn''' на '''level.spawn''' может быть полезна при одновременой правке спавна в '''X-Ray SDK''' и с помощью '''ACDC'''.
<pre>
universal_acdc -split <file> [-use_graph] [-way] [common_options]
</pre>
<code>-split <file></code> - разбиваемый спавн. Для восстановления граф-поинтов необходимы '''level.spawn''' для всех локаций, находящихся в графе. Их следует поместить в папку '''levels''' согласно их положению в геймдате сталкера - по папкам, соответствующим локациям. Папка '''levels''' должна быть в папке с '''universal_acdc''' (или путь до нее можно задать ключом - читайте далее).

<code>-use_graph</code> - использование '''game.graph''' для восстановления граф-поинтов. 
''Плюс'': не нужны '''level.spawn''' 
''Минус'': не восстанавливаются имена граф-поинтов (за исключением граф-поинтов переходов).

<code>-way</code> - также из спавна генерируются '''level.game'''
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Сравнение файлов распакованного спавна
|-
|
В этом режиме сравниваются два текстовых файла спавна. Итоговый файл формируется на основе первого файла. Все секции, которых нет во втором файле, но есть в первом, удаляются, а те секции, которые есть во втором,
но нет в первом, переносятся в итоговый файл. Параметры секций не меняются. Режим позволяет сэкономить время в случае, если надо совместить два файла, причем секции там идут вразнобой.
<pre>
universal_acdc -compare <file1,file2> [common_options]
</pre>
<code>-compare <file1,file2></code> - файлы для сравнения
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Обновление вертексов по координатам
|-
|
Зачем нужно: при изменении AI-сетки у объектов изменяются '''game_vertex_id''' и '''level_vertex_id'''

Это влечет за собой необходимость повторного снятия данных параметров в игре. Данный режим позволяет автоматически обновить вертексы у всех секций спавна.
<pre>
universal_acdc -update <spawn_name> [common_options]
</pre>
<code>-update <spawn_name></code> - '''all.spawn''', для которого надо обновить вертексы.

Режим '''update''' требует дополнительной настройки. В папке с '''acdc''' есть файл '''fs_vertex.ltx'''

В этот файл необходимо вписать путь до локаций с ОБНОВЛЕННОЙ AI-сеткой. Обязательно должны присутствовать файлы '''level.ai''', '''level.gct''' для всех локаций из спавна.

'''ВНИМАНИЕ!''' Для нормальной отработки режима геймграф должен быть СТАРЫЙ, использовавшийся до перекомпиляции. После нормальной отработки режима спавн можно распаковывать уже с НОВЫМ
геймграфом.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Общие опции
|-
|
<code>-out <file></code> - путь до файла/папки с результатом. Имеет разный смысл для разных опций:
* для '''decompile''', '''parse''' - папка с результатом
* для '''compile''', '''convert''' - результирующий файл
* для '''split''' - папка '''levels''', куда сохранять '''level.spawn'''

<code>-scan <scan_dir></code> - путь до папки с конфигами. Используется в случае спавнов от модов.

<code>-g <graph_dir></code> - путь до папки с '''game.graph'''. Бесполезен для '''compile''' и '''parse''', а также если работаете со спавном '''ЧН''', '''ЗП''', build 3120

<code>-level</code> - обрабатывать спавн как '''level.spawn'''

<code>-af</code> - также распаковываются\запаковываются места спавна артефактов в аномалиях (''section2.bin'')

<code>-nofatal</code> - отключает вылет при фатальной ошибке, заменяя ее предупреждением

<code>-sort <type></code> - включает сортировку ''alife''-объектов. Имеет два состояния:
* <code>simple</code> - сортировка по '''name''' по алфавиту
* <code>complex</code> - сортировка сначала по '''section_name''', потом по '''name''' по алфавиту.
|}

== Примечание ==
* Если '''universal_acdc''' генерирует ошибку <code>'unknown clsid ... for section...'</code>, это означает, что в данном моде добавлены новые пары клиентский/серверный класс в '''class_registrator.script''' Дабы не усложнять работу с '''universal_acdc''', такие пары не определяются автоматически. Лучше всего сообщить об этом в [http://www.amk-team.ru/forum/topic/11568-universal-acdc-i-drugie-perl-skripty/page-1 официальную тему на форуме]. Однако, если вы понимаете, что находится внутри '''class_registrator.script''', можете добавить новые сеты в '''clsids.ini''' сами. Сеты добавляются в таком формате: <code>clsid = соответствующий_серверный_класс</code> Пример: <code> ZS_ELECT = se_zone_anom</code>
* Любые имена опций можно сокращать. К примеру, необязательно использовать именно <code>-use_graph</code>, скрипт поймет также и <code>-use</code>, и <code>-u</code>. Однако ряд опций при сокращении их имени могут конфликтовать друг с другом. <code>-compile</code> нельзя сократить до <code>-c</code>, поскольку в таком случае скрипту неясно, что имеется ввиду: <code>-compile</code> или <code>-convert</code>. В таком случае наиболее короткое имя для '''compile''' будет таким: <code>-com</code>
* '''ВАЖНО!''' При работе со спавнами билдов '''25xx''' перед каждой новой распаковкой ОБЯЗАТЕЛЬНО следует удалять '''sections.ini''' и сканировать конфиги заново.

== Возможные ошибки и их исправление ==
{| class="mw-collapsible mw-collapsed wikitable"
! cannot change dir to
|-
|
<pre>
Function:main::compile
Line:1516
Description: cannot change dir to all
</pre>
==== Ошибка<ref>[http://www.amk-team.ru/forum/topic/11568-universal-acdc-i-drugie-perl-skripty/?do=findComment&comment=759956 Пост пользователя "DoK74rus" на AMK форуме]</ref><ref>[http://ap-pro.ru/forum/21-11239-1070851-16-1502190253 Пост пользователя "VENEGAS" на форуме AP Production]</ref> ====
Может возникнуть при использовании ключа <code>-compile</code>.

Например:
<syntaxhighlight lang="bat">
universal_acdc.pl -compile all -out new.spawn
pause
</syntaxhighlight>

Отсутствует указанная для компиляции папка с распакованным спавном (в данном случае: <code>all</code>).

==== Решение<ref>[http://www.amk-team.ru/forum/topic/11568-universal-acdc-i-drugie-perl-skripty/?do=findComment&comment=760254 Пост пользователя "KD87" на AMK форуме]</ref> ====
Проверьте наличие указанной папки в корневой директории '''ACDC'''.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! update data left
|-
|
==== Ошибка<ref>[https://www.amk-team.ru/forum/topic/11568-universal-acdc-i-drugie-perl-skripty/?do=findComment&comment=763476 Пост пользователя "KD87" на AMK форуме]</ref> ====
При возникновении фатальных ошибок типа "update data left" запускать батник с ключом <code>-nofatal</code> (заменяет вылет на предупреждение).

Пример фатальной ошибки:
<pre>
FATAL ERROR!
Function: stkutils::file::entity::error
Line: 247
Description: stkutils::file::entity::read_m_update 129 $packet->resid() == 0 update data left [77] in entity esc_box_wood_01_0003
</pre>

Пример предупреждения при запуске с ключем <code>-nofatal</code>:
<pre>
WARNING!
Function: main::__ANON__
Line: 1380
Description:
WARNING!
Function: stkutils::file::entity::error
Line: 249
Description: stkutils::file::entity::read_m_update 129 $packet->resid() == 0 update data left [77] in entity esc_box_wood_01_0003
</pre>
|}

== Источники ==
{{reflist|3}}

[[Категория:Утилиты для моддинга]]

Universal ACDC

2024-06-06T17:30:40Z

WolfHeart: /* Возможные ошибки и их исправление */

__NOTOC__
{| class="wikitable" style="float:right; margin-left:0.8em; clear:right; text-align: center; font-size:12px; width: 300px;"
|-
| colspan=2 style="font-size:20px;"|
'''Universal ACDC'''
|-
| '''Разработчик'''
| bardak
|-
| '''Модифицировали'''
| [[Kolmogor]], [[K.D.]]
|-
| '''Версия'''
| 1.38 от 21 мая 2014 года
|-
| '''Тип'''
| распаковщик/запаковщик
|-
| '''Платформа'''
| [[ActivePerl]]
|-
| '''Форматы файлов'''
| [[*.spawn]]
|-
| colspan=2| [[Версии Universal ACDC|История версий]]
|}

'''Universal ACDC'''<ref>[http://www.amk-team.ru/forum/topic/11568-universal-acdc-i-drugie-perl-skripty/page-1 Тема "Universal ACDC" на AMK форуме]</ref><ref>Информация из файла ReadMe.txt</ref> — это набор скриптов для работы со спавном [[S.T.A.L.K.E.R. - Тень Чернобыля]], [[S.T.A.L.K.E.R. - Чистое Небо|Чистое Небо]], [[S.T.A.L.K.E.R. - Зов Припяти|Зов Припяти]] и их билдов.

{| class="mw-collapsible mw-collapsed wikitable"
! colspan=4| Ссылки на скачивание
|-
| Universal ACDC
| https://yadi.sk/d/i4IVmWdb3PSxsg 
https://cloud.mail.ru/public/5DPy/5fLhTWXEF
|-
| Stkutils
| https://yadi.sk/d/msJH_Nb_3PSxsV 
https://cloud.mail.ru/public/3rYs/2gEPr2WvU
|}

== Возможности ==
* Распаковка оригинальных спавнов '''ТЧ''', '''ЧН''', '''ЗП''' и '''билдов ТЧ''', начиная с build 1265
* Распаковка спавнов от модов (требуется папка конфигов от мода)
* Конвертация спавна в любую другую версию
* Массовая замена гейм-вертексов в распакованном спавне
* Разбивка '''all.spawn''' на '''level.spawn''''ы и '''level.game''''ы
* Сравнение распакованных спавнов
* Обновление вертексов согласно координат объектов

== Установка ==
Распакуйте архив '''ACDC''' в удобную для вас директорию.

Переместите папку '''stkutils''' из архива в корневую директорию '''ACDC'''.

== Использование ==
{| class="mw-collapsible mw-collapsed wikitable"
! Распаковка спавна
|-
|
Режим предназначен для распаковки файлов '''all.spawn''' и '''level.spawn'''
<pre>
universal_acdc.pl -d <spawn_file> [common_options]
</pre>
<code>-d <spawn_file></code> - путь до спавна.

<code>common_options</code> - общие опции. Читайте про них ниже.

При распаковке спавнов от модов может возникнуть ошибка <code>'unknown section'</code>

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

Для распаковки такого спавна необходимо использовать ключ <code>-scan</code>, указав ему в качестве параметра путь до папки ''config(-s)''.

Пример смотрите в батнике '''acdc_decompile_scan'''.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Запаковка спавна
|-
|
Режим предназначен для запаковки распакованных текстовых файлов спавна в '''all.spawn''' или '''level.spawn'''
<pre>
universal_acdc.pl -compile <dir> [-idx <index_file>] [-f <flag1,flag2,...>] [common_options]
</pre>
<code>-compile <dir></code> - папка, в которой лежит распакованный спавн. Если работаете в текущей папке, <code><dir></code> не нужно.

<code>common_options</code> - общие опции. Читайте про них ниже.

<code>-idx <index_file></code> - с этим ключом скрипт сформирует [[*.ltx]]-конфиг с секциями вида:
<pre>
[13_box_wood_01_0021] ;формат - "индекс_локации"_"имя_объекта"
id = 2907 ;id объекта
story_id = -1 ;story_id объекта
</pre>
Такие записи создадутся для ВСЕХ объектов из спавна.

Если указать ключ <code>-idx</code> без пути до конфига, он появится в папке с '''universal_acdc''' (''spawn_ids''). Зачем это нужно? В игре вы сможете открыть этот файл из скриптов и найти нужный вам объект.

Если раньше для нахождения нужного '''id''' объекта по имени требовалось перебрать все объеты в игре, теперь это можно сделать, просто считав '''id''' из нужной секции конфига.

Также есть кое-какие дополнительные фичи:
* при компиляции для правильной работы необязательно проставлять всем секциям в спавне параметры <code>version</code> и <code>script_version</code>. Достаточно поставить их в секции актора, ацдц далее будет использовать их. Полезно, когда спавн "сборный".
* при компиляции контролируется уникальность параметров <code>story_id</code>, чтобы не мучатся потом с вылетами игры.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Конвертирование спавна
|-
|
Режим позволяет конвертировать спавны '''ТЧ''', '''ЧН''', '''ЗП''' между собой.
<pre>
universal_acdc.pl -convert <file> -version <new_version> [-ini <file>] [common_options]
</pre>
<code>-convert <file></code> - файл, который нужно сконвертировать. Можно указывать как запакованный ([[*.spawn]]) спавн,
так и распакованный ('''alife_***.ltx''').

'''Внимание!''' Так как граф и кросс-таблицы в '''ЧН''' и '''ЗП''' вшиты в спавн, для конвертирования ЗАПАКОВАННЫХ спавнов '''ТЧ''' в эти форматы вам потребуется положить в папку с '''universal_acdc''' папку '''levels''' из игры.

Необязательно копировать все файлы, достаточно оставить в папке с каждой локацией файл '''level.gct'''

<code>-version <new_version></code> - новая версия спавна. Подобрать версию вы сможете, посмотрев файл '''spawn_versions.txt'''

<code>-ini</code> - файл тонкой настройки конвертации (''convert.ini''). Если не указан, используется '''convert.ini''', лежащий в текущей папке.

<code>common_options</code> - общие опции. Читайте про них ниже.

Также поддерживается тонкая настройка конвертации через файл '''convert.ini'''

В файле есть две секции: <code>[exclude]</code> и <code>[change]</code>. В секции '''exclude''' можно прописать те секции, которые надо удалить из спава при конвертации.

Пример:
<pre>
[exclude]
sections = m_trader, m_car, flesh_weak
</pre>

Также поддерживается маскирование. Вместо кучи однотипных секций (''stalker_zombied, stalker_sakharov и т.д.'') можно задать маску, используя символ <code>*</code>.

Пример:

<code>stalker*</code>. Такая запись приведет к исключению всех секций, в названии которых есть слово ''stalker''.

В секции '''change''' прописываются имена тех секций, в которых нужно что-то поменять или дополнить.

Пример:
<pre>
[change]
sections = inventory_box
</pre>
Далее заполняете файл записями для тех секций, которые вы прописали в '''change'''. Пример:
<pre>
[inventory_box] //section_name нужной секции
add:custom_data = PREVED //префикс add используется для тех параметров, в которые нужно добавить
add:game_vertex_id = 10000 //необходимое значение (если число - складывается, если строка - добавляется в конец)
rep:level_vertex_id = 0 //префикс rep используется для параметров, которые необходимо заменить на что-то
</pre>
Общий пример. Следующий конфиг приведет к тому, что у всех сталкеров прибавится 500 к гейм-вертексу и
визуал сменится на визуал вояки в противогазе:
<pre>
[exclude]

[change]
sections = stalker

[stalker]
add:game_vertex_id = 500
rep:visual_name = actors/soldier/soldier_antigas.ogf
</pre>
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Массовая замена вертексов
|-
|
При подключении новых локаций без перекомпиляции графа возникает необходимость одновременного
сдвига всех гейм-вертексов спавна новых локаций на какое-то определенное значение.
Это можно сделать в этом режиме.
<pre>
universal_acdc -parse <file> -old <old_gvid0> -new <new_gvid0> [-way] [common_options]
</pre>
<code>-parse <file></code> - имя [[*.ltx]], в котором находится спавн.

<code>-old <old_gvid0></code> - старый начальный '''game_vertex_id''' локации.

<code>-new <new_gvid0></code> - новый начальный '''game_vertex_id''' локации.

<code>-way</code> - обрабатывает также файл '''way_***.ltx''' для этой же локации.

Пример:

<code>universal_acdc -parse alife_l01_escape.ltx -old 0 -new 934</code>
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Разбивка all.spawn на level.spawn
|-
|
Разбивка '''all.spawn''' на '''level.spawn''' может быть полезна при одновременой правке спавна в '''X-Ray SDK''' и с помощью '''ACDC'''.
<pre>
universal_acdc -split <file> [-use_graph] [-way] [common_options]
</pre>
<code>-split <file></code> - разбиваемый спавн. Для восстановления граф-поинтов необходимы '''level.spawn''' для всех локаций, находящихся в графе. Их следует поместить в папку '''levels''' согласно их положению в геймдате сталкера - по папкам, соответствующим локациям. Папка '''levels''' должна быть в папке с '''universal_acdc''' (или путь до нее можно задать ключом - читайте далее).

<code>-use_graph</code> - использование '''game.graph''' для восстановления граф-поинтов. 
''Плюс'': не нужны '''level.spawn''' 
''Минус'': не восстанавливаются имена граф-поинтов (за исключением граф-поинтов переходов).

<code>-way</code> - также из спавна генерируются '''level.game'''
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Сравнение файлов распакованного спавна
|-
|
В этом режиме сравниваются два текстовых файла спавна. Итоговый файл формируется на основе первого файла. Все секции, которых нет во втором файле, но есть в первом, удаляются, а те секции, которые есть во втором,
но нет в первом, переносятся в итоговый файл. Параметры секций не меняются. Режим позволяет сэкономить время в случае, если надо совместить два файла, причем секции там идут вразнобой.
<pre>
universal_acdc -compare <file1,file2> [common_options]
</pre>
<code>-compare <file1,file2></code> - файлы для сравнения
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Обновление вертексов по координатам
|-
|
Зачем нужно: при изменении AI-сетки у объектов изменяются '''game_vertex_id''' и '''level_vertex_id'''

Это влечет за собой необходимость повторного снятия данных параметров в игре. Данный режим позволяет автоматически обновить вертексы у всех секций спавна.
<pre>
universal_acdc -update <spawn_name> [common_options]
</pre>
<code>-update <spawn_name></code> - '''all.spawn''', для которого надо обновить вертексы.

Режим '''update''' требует дополнительной настройки. В папке с '''acdc''' есть файл '''fs_vertex.ltx'''

В этот файл необходимо вписать путь до локаций с ОБНОВЛЕННОЙ AI-сеткой. Обязательно должны присутствовать файлы '''level.ai''', '''level.gct''' для всех локаций из спавна.

'''ВНИМАНИЕ!''' Для нормальной отработки режима геймграф должен быть СТАРЫЙ, использовавшийся до перекомпиляции. После нормальной отработки режима спавн можно распаковывать уже с НОВЫМ
геймграфом.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Общие опции
|-
|
<code>-out <file></code> - путь до файла/папки с результатом. Имеет разный смысл для разных опций:
* для '''decompile''', '''parse''' - папка с результатом
* для '''compile''', '''convert''' - результирующий файл
* для '''split''' - папка '''levels''', куда сохранять '''level.spawn'''

<code>-scan <scan_dir></code> - путь до папки с конфигами. Используется в случае спавнов от модов.

<code>-g <graph_dir></code> - путь до папки с '''game.graph'''. Бесполезен для '''compile''' и '''parse''', а также если работаете со спавном '''ЧН''', '''ЗП''', build 3120

<code>-level</code> - обрабатывать спавн как '''level.spawn'''

<code>-af</code> - также распаковываются\запаковываются места спавна артефактов в аномалиях (''section2.bin'')

<code>-nofatal</code> - отключает вылет при фатальной ошибке, заменяя ее предупреждением

<code>-sort <type></code> - включает сортировку ''alife''-объектов. Имеет два состояния:
* <code>simple</code> - сортировка по '''name''' по алфавиту
* <code>complex</code> - сортировка сначала по '''section_name''', потом по '''name''' по алфавиту.
|}

== Примечание ==
* Если '''universal_acdc''' генерирует ошибку <code>'unknown clsid ... for section...'</code>, это означает, что в данном моде добавлены новые пары клиентский/серверный класс в '''class_registrator.script''' Дабы не усложнять работу с '''universal_acdc''', такие пары не определяются автоматически. Лучше всего сообщить об этом в [http://www.amk-team.ru/forum/topic/11568-universal-acdc-i-drugie-perl-skripty/page-1 официальную тему на форуме]. Однако, если вы понимаете, что находится внутри '''class_registrator.script''', можете добавить новые сеты в '''clsids.ini''' сами. Сеты добавляются в таком формате: <code>clsid = соответствующий_серверный_класс</code> Пример: <code> ZS_ELECT = se_zone_anom</code>
* Любые имена опций можно сокращать. К примеру, необязательно использовать именно <code>-use_graph</code>, скрипт поймет также и <code>-use</code>, и <code>-u</code>. Однако ряд опций при сокращении их имени могут конфликтовать друг с другом. <code>-compile</code> нельзя сократить до <code>-c</code>, поскольку в таком случае скрипту неясно, что имеется ввиду: <code>-compile</code> или <code>-convert</code>. В таком случае наиболее короткое имя для '''compile''' будет таким: <code>-com</code>
* '''ВАЖНО!''' При работе со спавнами билдов '''25xx''' перед каждой новой распаковкой ОБЯЗАТЕЛЬНО следует удалять '''sections.ini''' и сканировать конфиги заново.

== Возможные ошибки и их исправление ==
{| class="mw-collapsible mw-collapsed wikitable"
! cannot change dir to
|-
|
<pre>
Function:main::compile
Line:1516
Description: cannot change dir to all
</pre>
==== Ошибка<ref>[http://www.amk-team.ru/forum/topic/11568-universal-acdc-i-drugie-perl-skripty/?do=findComment&comment=759956 Пост пользователя "DoK74rus" на AMK форуме]</ref><ref>[http://ap-pro.ru/forum/21-11239-1070851-16-1502190253 Пост пользователя "VENEGAS" на форуме AP Production]</ref> ====
Может возникнуть при использовании ключа <code>-compile</code>.

Например:
<syntaxhighlight lang="bat">
universal_acdc.pl -compile all -out new.spawn
pause
</syntaxhighlight>

Отсутствует указанная для компиляции папка с распакованным спавном (в данном случае: <code>all</code>).

==== Решение<ref>[http://www.amk-team.ru/forum/topic/11568-universal-acdc-i-drugie-perl-skripty/?do=findComment&comment=760254 Пост пользователя "KD87" на AMK форуме]</ref> ====
Проверьте наличие указанной папки в корневой директории '''ACDC'''.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! update data left
|-
|
<pre>
FATAL ERROR!
Function: stkutils::file::entity::error
Line: 247
Description: stkutils::file::entity::read_m_update 129 $packet->resid() == 0 update data left [77] in entity esc_box_wood_01_0003
</pre>
==== Ошибка<ref>[https://www.amk-team.ru/forum/topic/11568-universal-acdc-i-drugie-perl-skripty/?do=findComment&comment=763476 Пост пользователя "KD87" на AMK форуме]</ref> ====
При возникновении фатальных ошибок типа "update data left" запускать батник с ключом <code>-nofatal</code> (заменяет вылет на предупреждение).

Например:
<pre>
WARNING!
Function: main::__ANON__
Line: 1380
Description:
WARNING!
Function: stkutils::file::entity::error
Line: 249
Description: stkutils::file::entity::read_m_update 129 $packet->resid() == 0 update data left [77] in entity esc_box_wood_01_0003
</pre>
|}

== Источники ==
{{reflist|3}}

[[Категория:Утилиты для моддинга]]

X-Ray Converter

2022-08-24T21:23:20Z

WolfHeart: дополнение

__NOTOC__
{| class="wikitable" style="float:right; margin-left:0.8em; clear:right; text-align: center; font-size:12px; width: 300px;"
|-
| colspan=2 style="font-size:20px;"|
'''X-Ray Converter'''
|-
| '''Разработчик'''
| bardak
|-
| '''Модифицировали'''
| Loxotron, [[Kolmogor]], NeoH, mnn, XiaNi, gr1ph00n, RedPython, abramcumner, Freack, xrNatteFrost, [[K.D.]], Charsi
|-
| '''Версия'''
| от 18 октября 2017 года
|-
| '''Тип'''
| Конвертер
|-
| '''Платформа'''
| Windows: Vista/ 7/ 8/ 8.1/ 10
|-
| '''Форматы файлов'''
| [[*.ogf]], [[*.object]], [[*.bones]], [[*.omf]], [[*.skls]], [[*.skl]], [[*.dm]], [[*.dds]], [[*.tga]], [[*.ogg]], [[*.wav]], [[*.thm]]
|-
| colspan=2| [[Версии X-Ray Converter|История версий]]
|}

'''X-Ray Converter'''<ref>[http://www.amk-team.ru/forum/user/16052-charsi/ "Converter 2016" в профиле пользователя "Charsi" на AMK форуме]</ref><ref>[https://bitbucket.org/stalker/xray_re-tools/downloads?tab=branches Документация конвертера в репозитории на bitbucket.org]</ref> — это многофункциональная утилита для работы с форматами файлов игры и '''X-Ray SDK'''.

{| class="mw-collapsible mw-collapsed wikitable"
! colspan=4| Ссылки на скачивание
|-
| X-Ray Converter
| https://yadi.sk/d/nivUmGybuCXSC 
https://cloud.mail.ru/public/3Zab/b8VBczdZp 
|-
| X-Ray Converter Extra
| https://yadi.sk/d/7137tI653PRnrU 
https://cloud.mail.ru/public/3REa/3SEVyeS6X
|-
| Visual C++ 2015 Redistributable
|
'''x86''' 
https://download.microsoft.com/download/6/A/A/6AA4EDFF-645B-48C5-81CC-ED5963AEAD48/vc_redist.x86.exe

'''x64''' 
https://download.microsoft.com/download/6/A/A/6AA4EDFF-645B-48C5-81CC-ED5963AEAD48/vc_redist.x64.exe
|}

Для использования конвертера, создайте в его корневой директории [[*.bat]] или [[*.cmd]] файл.

{| class="mw-collapsible mw-collapsed wikitable"
! Дополнительная настройка
|-
|
Для работы ключей <code>-level</code>, <code>-dds2tga</code> и <code>-ogg2wav</code>, необходимо задать путь к директории с '''X-Ray SDK'''.
# Откройте любым [[:Категория:Текстовые_редакторы|текстовым редактором]] файл '''fsconverter.ltx'''
# Найдите строку:<syntaxhighlight lang=ini>
$sdk_root$ = false| false| X:\
</syntaxhighlight>
# Исправьте путь в ней на свой. Например:<syntaxhighlight lang=ini>
$sdk_root$ = false| false| D:\X-Ray_SDK_0.7\editors\
</syntaxhighlight>

== Примечание ==
* Для [[X-Ray SDK 0.5|SDK 0.5]] / [[X-Ray SDK 0.7|0.7]] используйте файл '''fsconverter_cs-cop.ltx''', переименовав его в '''fsconverter.ltx'''. В нём исправлена ошибка <code>path $game_config$ does not exist</code>

Для правильной работы ключа <code>-level</code>, ещё также необходимо задать путь к директории с [[Распаковка_игровых_архивов|распакованными игровыми архивами]] для выбранной версии игры (билда).
# Откройте файл любым текстовым редактором '''converter.ini'''
# Найдите в нём секцию соответствующую необходимой версии игры. Например, для [[S.T.A.L.K.E.R. - Зов Припяти|Зова Припяти]] это секция:<syntaxhighlight lang=ini>
[3870_config]:3456_config
$game_data$ = X:\_builds_\CoP\gamedata\
$game_levels$ = X:\_builds_\CoP\gamedata\levels\
</syntaxhighlight>Исправьте пути в ней на свои. Например: <syntaxhighlight lang=ini>
$game_data$ = D:\S.T.A.L.K.E.R. Call of Pripyat\gamedata\
$game_levels$ = D:\S.T.A.L.K.E.R. Call of Pripyat\gamedata\levels\
</syntaxhighlight>
# Для последующей совместимости полученного уровня с используемой версией '''SDK''', обязательно допишите в секцию параметр <code>spawn_version</code>. <code>spawn_version = cs</code> — для '''SDK 0.6''' <code>spawn_version = cop</code> — для '''SDK 0.7'''

=== Примечание ===
* По умолчанию, если строка не указана, читается, как для [[X-Ray SDK 0.4|SDK 0.4]].
|}

== Возможности ==
{| class="mw-collapsible mw-collapsed wikitable"
! Преобразование ogf в object
|-
|
<pre>
converter [-ogf] [-object] <оригинал> [-out <результат>]
</pre>
Пример:
<pre>
converter -ogf balon_01.ogf -object
</pre>
Если ключ <code>-out <результат></code> не задан, имя результирующего файла генерируется из исходного путём замены расширения на [[*.object]]

Замечания/проблемы:
* для OGF v3 (сборки 1098, 1114, 1154) не восстанавливается bind pose скелета (просто потому что не предусмотрена форматом), но часто её можно (и нужно) реконструировать вручную из idle-анимации.
* для OGF v4+ ([[S.T.A.L.K.E.R. - Чистое Небо|ЧН]], в том числе сборка 3120) не восстанавливаются метки в анимациях (неизвестно, как они хранятся в обновлённом [[*.object]] и на данный момент нет в публичном доступе соответствующего '''X-Ray SDK'''). Кроме того, текущий '''X-Ray SDK''' игнорирует информацию о третьей и четвёртой влияющих на вершину костях.
* нет гарантии, что у двухсторонних поверхностей правильно определится "главная" сторона, однако на практике обычно всё хорошо.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Преобразование скелета из ogf в bones
|-
|
<pre>
converter [-ogf] -bones <оригинал> [-out <результат>]
</pre>
Если ключ <code>-out <результат></code> не задан, имя результирующего файла генерируется из исходного путём замены расширения на [[*.bones]]
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Преобразование всех анимаций из ogf или omf в skls
|-
|
<pre>
converter [-ogf|-omf] -skls <оригинал> [-out <результат>]
</pre>
Если ключ <code>-out <результат></code> не задан, имя результирующего файла генерируется из исходного путём замены расширения на [[*.skls]]

Замечания:
* анимация сохраняется в виде ступенчатых кривых и никакого преобразования в сплайны не производится (а надо бы).
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Преобразование отдельных анимаций из ogf или omf в skl
|-
|
<pre>
converter [-ogf|-omf] -skl <имя_анимации> <оригинал> [-out <результат>]
</pre>
Если ключ <code>-out <результат></code> не задан, имя результирующего файла генерируется из исходного путём замены расширения на [[*.skl]] и добавления суффикса с именем анимации.

Замечания/проблемы:
* Нельзя задать анимацию, в имени которой используются пробелы.
* См. выше про форму задания кривых.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Преобразование dm в object
|-
|
<pre>
converter [-dm] [-object] <оригинал> [-out <результат>]
</pre>
Если ключ <code>-out <результат></code> не задан, имя результирующего файла генерируется из исходного путём замены расширения на [[*.object]]

Замечания:
* Информация о границах масштабирования детальной модели теряется, однако можно её посмотреть с помощью ключа <code>-info</code> (вместо <code>-object</code>).
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Распаковка и упаковка игровых архивов
|-
|
<pre>
converter -unpack <архив> [-11xx|-2215|-2945|-2947ru|-2947|-xdb] [-flt <маска>]
</pre>
Ключ <code>-flt</code> служит для извлечения файлов по маске. Примеры:
<pre>
converter -unpack -xdb gamedata.db0 -flt .ogf
converter -unpack -2215 gamedata.xp0 -flt \levels\
</pre>
Команда для упаковки:
<pre>
converter -pack <папка> [-2947ru|-2947ww|-xdb|-xdb_ud <файл>] -out <путь>
</pre>
Пример:
<pre>
converter -pack gamedata -2947ru -out gamedata.db1
</pre>
Заметка:
* Используйте ключ <code>-xdb</code> для распаковки/запаковки архивов [[S.T.A.L.K.E.R. - Чистое Небо | Чистого Неба]] и [[S.T.A.L.K.E.R. - Зов Припяти | Зова Припяти]].
|}

'''ВНИМАНИЕ!''' Для использования — требуется дополнительная настройка!
{| class="mw-collapsible mw-collapsed wikitable"
! Преобразование игровых уровней в формат Level Editor
|-
|
<pre>
converter -level <номер_сборки>:<имя_уровня> [-out <имя_сцены>] [-mode maya|le|le2|raw] [-terrain]
</pre>
Примеры:
<pre>
converter -level default:l01_escape -out l01_escape -mode le
converter -level 1844:military_game -out military_game -mode le
</pre>
Ключ <code>-mode</code> задаёт режим работы:
* <code>maya</code> - декомпилировать только геометрию уровня
* <code>le</code> - декомпилировать в формат LE
* <code>le2</code> - декомпилировать в формат LE (для l12_stancia_2)
* <code>raw</code> - декомпилировать в формат LE (отладочный режим)

Ключ <code>-with_lods</code> обрабатывается в зависимости от значения <code>-mode</code>. Если он задан совместно с <code>-mode maya</code>, программа выдаст ещё и MU-модели. С остальными режимами его наличие заставляет converter разбивать LOD-текстуры, что необходимо для полной пересборки.

Ключ <code>-terrain</code> - в объект террейна добавляются только полигоны с текстурой террейна. Без ключа к террейну могут добавляться полигоны, близкие к объектам детейла (травы), например, бордюры.

Отладочные параметры: <code>-dbgcfrm, -dbgmrg</code>

Замечания/проблемы:
* Геометрия уровней из 1098, 1114, 1154 часто содержит ошибки, на которых валится современный [[xrLC]]. По крайней мере часть из них диагностируется при декомпилировании и сохраняется в стандартном формате LE в файле ''$log$\converter_<имя_сцены>.err''
* Деревья из ранних сборок (1098-1154) нельзя использовать с современными шейдерами для крупной растительности. Следует использовать современные MU-модели.
* Геометрия уровней из сборок 2215-3312 ([[S.T.A.L.K.E.R. - Тень Чернобыля|ТЧ]]) не содержит ошибок вроде нулевых треугольников или потяжек текстур, однако в редких случаях они могут появиться при пересборке с помощью [[xrLC]] на этапе оптимизации. Наблюдается, например, в шахтах лифтов на l11_pripyat.
* Геометрия уровней из сборки 3456 и выше ([[S.T.A.L.K.E.R. - Чистое Небо|ЧН]]) наоборот, иногда содержит ошибки (с точки зрения [[xrLC]] из X-Ray SDK 0.4).
* Неправильно назначается compiler shader для собранных в режиме draft уровней.
* Абажуры ламп, тайники -- фиксированная геометрия, то есть изменения будут видны только после полной пересборки уровня.
* Декали (wallmark.part) восстанавливаются только в случае наличия избыточного level.wallmarks.
* Не обрабатывается случай с пересекающимися областями звукового окружения (level.snd_env/sound_env.part). В оригинальной игре уровней с таким свойством нет.
* У моделей детальных объектов форсируется флажок two-sided для нормальной отрисовки в '''LE'''.
* Сетка навигации AI (level.ai/ai_map.part) некоторых уровней (например, l08_yantar) утоплена в геометрии. Вопрос о причине открыт.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Множественное преобразование текстур из dds в tga
|-
|
<pre>
converter -dds2tga [-with_solid] [-with_bump]
</pre>
Утилита читает все [[*.thm]] файлы в ''$textures$'' и воссоздаёт [[*.tga]] из [[*.dds]] в ''$game_textures$''. Уже существующие [[*.tga]] файлы не перезаписываются. Ключ <code>-with_solid</code> предписывает обрабатывать ещё и непрозрачные текстуры, что нужно при пересборке с <code>-gi</code>
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Множественное преобразование звуков из ogg в wav/thm
|-
|
<pre>
converter -ogg2wav
</pre>
Утилита воссоздаёт [[*.wav]]/[[*.thm]] файлы в ''$sounds$'', используя [[*.ogg]] из ''$game_sounds$''. Уже существующие [[*.wav]]/[[*.thm]] не перезаписываются.
|}

== Установка ==
Распакуйте архив '''converter 18102017.7z''' в удобную для вас директорию.

Переместите файлы "Converter Extra" из архива в директорию выбранной вами версии конвертера.

Например, ''Win32-Release/converter''

== Примечание ==
* Первый запуск после любых изменений в настройках желательно всегда делать с ключом <code>-ro</code> (работа без записи на диск).

* '''Владельцам видеокарт от NVIDIA'''! Для ускорения разбиения текстур лодов, используйте '''CUDA''' — эта версия конвертера, использует библиотеку [[NVIDIA Texture Tools]] с технологией CUDA. Результаты декомпиляции уровня ''l01_escape'' из ТЧ с разбиением текстуры лодов (система: Intel Core i5-4590, GTX 1060 6Gb): Win32-Release = ''162 секунды'' Win32-Release_CUDA = ''37 секунд'' x64-Release = ''130 секунд'' x64-Release_CUDA = ''38 секунд''

== Возможные ошибки и их исправление ==
{| class="mw-collapsible mw-collapsed wikitable"
! <code>[bug] unimplemented code path at ..\xr_entity_script.cxx</code>
|-
|
==== Ошибка ====
Может возникнуть при использовании ключа <code>-level</code>.

==== Решение ====
Попробуйте временно убрать из папки с декомпилируемым уровнем файл '''level.spawn''', и попробуйте снова.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>path $game_config$ does not exist</code>
|-
|
==== Ошибка ====
По пути указанному в <code>$game_data$</code> выбранного профиля файла '''converter.ini''', не найдена папка указанная <code>$game_config$</code> в '''fsconverter.ltx'''

Скорее всего, вы до этого работали с ЧН/ЗП, и вам понадобилось поработать с ТЧ, но вы забыли исправить имя папки <code>configs</code> на <code>config</code>.

==== Решение ====
Проверить наличие папки с указанными именем по указанному пути.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>path $maps$ does not exist</code>
|-
|
==== Ошибка ====
По пути указанному в <code>$game_data$</code> выбранного профиля файла '''converter.ini''', не найдена папка указанная <code>$maps$</code> в '''fsconverter.ltx'''

Скорее всего, в '''fsconverter.ltx''' указана старая исходная директория <code>$server_data_root$</code>, а не <code>$sdk_root$</code>. И папка <code>levels</code>, а не <code>maps</code>

==== Решение ====
Проверить наличие папки с указанными именем по указанному пути.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>[bug] unexpected code path at ..\level_tools_details.cxx</code>
|-
|
==== Ошибка ====
По пути указанному в <code>$game_data$</code> выбранного профиля файла '''converter.ini''', не найдена папка ''gamedata\textures\'''det'''''.

А так-же, причиной может стать переполнение этой папки.

==== Решение ====
Проверить наличие папки с указанными именем по указанному пути.

В случае переполнения, достаточно удалить, перенести, на время декомпиляции, хотя-бы одну текстуру.<ref>[https://www.amk-team.ru/forum/topic/13149-cop-voprosy-po-sdk/?do=findComment&comment=1434562 Пост пользователя "WolfHeart" на AMK форуме]</ref>
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>unspecifed output file</code>
|-
|
==== Ошибка ====
В [[*.bat]]\[[*.cmd]] файле запуска конвертера не задан необходимый ключ <code>-out</code>

==== Решение ====
Проверить его наличие ключа, и правильность указания
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>can't set scene name explicitly for multiple input levels</code>
|-
|
==== Ошибка ====
В [[*.bat]]\[[*.cmd]] файле запуска конвертера задан ключ <code>-out</code>, но не задано "имя сцены" (см. Преобразование игровых уровней в формат Level Editor).

==== Решение ====
Проверить чтобы после ключа было указано "имя сцены" (это имя папки или путь до неё относительно папки конвертера).
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>[bug] assertion failed at ..\level_tools.cxx</code>
|-
|
==== Ошибка ====
Актуальна только для старых версий конвертера.

==== Решение ====
Используйте крайнюю версию конвертера.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>path $objects$ does not exist</code>
|-
|
==== Ошибка ====
По пути указанному в <code>$objects$</code> файла '''fsconverter.ltx''', не найдена указанная папка.

==== Решение ====
Проверить наличие папки с указанными именем по указанному пути.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>[bug] unexpected code path at ..\xr_ogf.cxx</code>
|-
|
==== Ошибка ====
Актуальна только для старых версий конвертера.

==== Решение ====
Используйте крайнюю версию конвертера.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>[bug] unexpected code path at ..\xr_ini_file.cxx</code>
|-
|
==== Ошибка ====
Нарушена структура файла '''level.ltx''' декомпилируемого уровня<ref>[http://stalker-portal.ru/forums.php?m=posts&p=1221689#1221689 Пост пользователя "BeeRsek" на форуме Stalker-Portal.ru]</ref><ref>[https://www.amk-team.ru/forum/topic/12733-instrukcii-po-vyletam-i-oshibkam/?do=findComment&comment=1212114 Пост пользователя "UriZzz" на AMK форуме]</ref><ref>[https://ap-pro.ru/forum/100-11239-916221-16-1474818460 Пост пользователя "ur3icf" на форуме AP Production]</ref>.

==== Решение ====
Откройте файл любым текстовым редактором, и удалите его содержимое.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>[bug] unexpected code path at ..\xr_level.cxx</code>
|-
|
==== Ошибка ====
В папке с декомпилируемым уровнем отсутствует директория '''meshes''' с файлами вида '''brkbl#0.ogf''', прописанными в файле '''level.spawn''' уровня.

==== Решение ====
На время декомпиляции, убрать из папки уровня файл '''level.spawn'''<ref>[https://www.amk-team.ru/forum/topic/1560-soc-voprosy-po-sdk/?do=findComment&comment=1269251 Пост пользователя "WolfHeart" на AMK форуме]</ref>
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>[bug] assertion failed at ..\xr_packet.cxx:151</code>
|-
|
==== Ошибка ====
Ошибка в файле '''level.spawn''' декомпилируемого уровня.

==== Решение ====
На время декомпиляции, убрать из папки уровня файл '''level.spawn'''<ref>[https://www.amk-team.ru/forum/topic/1560-soc-voprosy-po-sdk/?do=findComment&comment=1436805 Пост пользователя "WolfHeart" на AMK форуме]</ref>
|}

== Источники ==
{{reflist|3}}

[[Категория:Утилиты для моддинга]]

X-Ray Converter

2022-08-24T21:16:07Z

WolfHeart: дополнение.

__NOTOC__
{| class="wikitable" style="float:right; margin-left:0.8em; clear:right; text-align: center; font-size:12px; width: 300px;"
|-
| colspan=2 style="font-size:20px;"|
'''X-Ray Converter'''
|-
| '''Разработчик'''
| bardak
|-
| '''Модифицировали'''
| Loxotron, [[Kolmogor]], NeoH, mnn, XiaNi, gr1ph00n, RedPython, abramcumner, Freack, xrNatteFrost, [[K.D.]], Charsi
|-
| '''Версия'''
| от 18 октября 2017 года
|-
| '''Тип'''
| Конвертер
|-
| '''Платформа'''
| Windows: Vista/ 7/ 8/ 8.1/ 10
|-
| '''Форматы файлов'''
| [[*.ogf]], [[*.object]], [[*.bones]], [[*.omf]], [[*.skls]], [[*.skl]], [[*.dm]], [[*.dds]], [[*.tga]], [[*.ogg]], [[*.wav]], [[*.thm]]
|-
| colspan=2| [[Версии X-Ray Converter|История версий]]
|}

'''X-Ray Converter'''<ref>[http://www.amk-team.ru/forum/user/16052-charsi/ "Converter 2016" в профиле пользователя "Charsi" на AMK форуме]</ref><ref>[https://bitbucket.org/stalker/xray_re-tools/downloads?tab=branches Документация конвертера в репозитории на bitbucket.org]</ref> — это многофункциональная утилита для работы с форматами файлов игры и '''X-Ray SDK'''.

{| class="mw-collapsible mw-collapsed wikitable"
! colspan=4| Ссылки на скачивание
|-
| X-Ray Converter
| https://yadi.sk/d/nivUmGybuCXSC 
https://cloud.mail.ru/public/3Zab/b8VBczdZp 
|-
| X-Ray Converter Extra
| https://yadi.sk/d/7137tI653PRnrU 
https://cloud.mail.ru/public/3REa/3SEVyeS6X
|-
| Visual C++ 2015 Redistributable
|
'''x86''' 
https://download.microsoft.com/download/6/A/A/6AA4EDFF-645B-48C5-81CC-ED5963AEAD48/vc_redist.x86.exe

'''x64''' 
https://download.microsoft.com/download/6/A/A/6AA4EDFF-645B-48C5-81CC-ED5963AEAD48/vc_redist.x64.exe
|}

Для использования конвертера, создайте в его корневой директории [[*.bat]] или [[*.cmd]] файл.

{| class="mw-collapsible mw-collapsed wikitable"
! Дополнительная настройка
|-
|
Для работы ключей <code>-level</code>, <code>-dds2tga</code> и <code>-ogg2wav</code>, необходимо задать путь к директории с '''X-Ray SDK'''.
# Откройте любым [[:Категория:Текстовые_редакторы|текстовым редактором]] файл '''fsconverter.ltx'''
# Найдите строку:<syntaxhighlight lang=ini>
$sdk_root$ = false| false| X:\
</syntaxhighlight>
# Исправьте путь в ней на свой. Например:<syntaxhighlight lang=ini>
$sdk_root$ = false| false| D:\X-Ray_SDK_0.7\editors\
</syntaxhighlight>

== Примечание ==
* Для [[X-Ray SDK 0.5|SDK 0.5]] / [[X-Ray SDK 0.7|0.7]] используйте файл '''fsconverter_cs-cop.ltx''', переименовав его в '''fsconverter.ltx'''. В нём исправлена ошибка <code>path $game_config$ does not exist</code>

Для правильной работы ключа <code>-level</code>, ещё также необходимо задать путь к директории с [[Распаковка_игровых_архивов|распакованными игровыми архивами]] для выбранной версии игры (билда).
# Откройте файл любым текстовым редактором '''converter.ini'''
# Найдите в нём секцию соответствующую необходимой версии игры. Например, для [[S.T.A.L.K.E.R. - Зов Припяти|Зова Припяти]] это секция:<syntaxhighlight lang=ini>
[3870_config]:3456_config
$game_data$ = X:\_builds_\CoP\gamedata\
$game_levels$ = X:\_builds_\CoP\gamedata\levels\
</syntaxhighlight>Исправьте пути в ней на свои. Например: <syntaxhighlight lang=ini>
$game_data$ = D:\S.T.A.L.K.E.R. Call of Pripyat\gamedata\
$game_levels$ = D:\S.T.A.L.K.E.R. Call of Pripyat\gamedata\levels\
</syntaxhighlight>
# Для последующей совместимости полученного уровня с используемой версией '''SDK''', обязательно допишите в секцию параметр <code>spawn_version</code>. <code>spawn_version = cs</code> — для '''SDK 0.6''' <code>spawn_version = cop</code> — для '''SDK 0.7'''

=== Примечание ===
* По умолчанию, если строка не указана, читается, как для [[X-Ray SDK 0.4|SDK 0.4]].
|}

== Возможности ==
{| class="mw-collapsible mw-collapsed wikitable"
! Преобразование ogf в object
|-
|
<pre>
converter [-ogf] [-object] <оригинал> [-out <результат>]
</pre>
Пример:
<pre>
converter -ogf balon_01.ogf -object
</pre>
Если ключ <code>-out <результат></code> не задан, имя результирующего файла генерируется из исходного путём замены расширения на [[*.object]]

Замечания/проблемы:
* для OGF v3 (сборки 1098, 1114, 1154) не восстанавливается bind pose скелета (просто потому что не предусмотрена форматом), но часто её можно (и нужно) реконструировать вручную из idle-анимации.
* для OGF v4+ ([[S.T.A.L.K.E.R. - Чистое Небо|ЧН]], в том числе сборка 3120) не восстанавливаются метки в анимациях (неизвестно, как они хранятся в обновлённом [[*.object]] и на данный момент нет в публичном доступе соответствующего '''X-Ray SDK'''). Кроме того, текущий '''X-Ray SDK''' игнорирует информацию о третьей и четвёртой влияющих на вершину костях.
* нет гарантии, что у двухсторонних поверхностей правильно определится "главная" сторона, однако на практике обычно всё хорошо.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Преобразование скелета из ogf в bones
|-
|
<pre>
converter [-ogf] -bones <оригинал> [-out <результат>]
</pre>
Если ключ <code>-out <результат></code> не задан, имя результирующего файла генерируется из исходного путём замены расширения на [[*.bones]]
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Преобразование всех анимаций из ogf или omf в skls
|-
|
<pre>
converter [-ogf|-omf] -skls <оригинал> [-out <результат>]
</pre>
Если ключ <code>-out <результат></code> не задан, имя результирующего файла генерируется из исходного путём замены расширения на [[*.skls]]

Замечания:
* анимация сохраняется в виде ступенчатых кривых и никакого преобразования в сплайны не производится (а надо бы).
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Преобразование отдельных анимаций из ogf или omf в skl
|-
|
<pre>
converter [-ogf|-omf] -skl <имя_анимации> <оригинал> [-out <результат>]
</pre>
Если ключ <code>-out <результат></code> не задан, имя результирующего файла генерируется из исходного путём замены расширения на [[*.skl]] и добавления суффикса с именем анимации.

Замечания/проблемы:
* Нельзя задать анимацию, в имени которой используются пробелы.
* См. выше про форму задания кривых.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Преобразование dm в object
|-
|
<pre>
converter [-dm] [-object] <оригинал> [-out <результат>]
</pre>
Если ключ <code>-out <результат></code> не задан, имя результирующего файла генерируется из исходного путём замены расширения на [[*.object]]

Замечания:
* Информация о границах масштабирования детальной модели теряется, однако можно её посмотреть с помощью ключа <code>-info</code> (вместо <code>-object</code>).
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Распаковка и упаковка игровых архивов
|-
|
<pre>
converter -unpack <архив> [-11xx|-2215|-2945|-2947ru|-2947|-xdb] [-flt <маска>]
</pre>
Ключ <code>-flt</code> служит для извлечения файлов по маске. Примеры:
<pre>
converter -unpack -xdb gamedata.db0 -flt .ogf
converter -unpack -2215 gamedata.xp0 -flt \levels\
</pre>
Команда для упаковки:
<pre>
converter -pack <папка> [-2947ru|-2947ww|-xdb|-xdb_ud <файл>] -out <путь>
</pre>
Пример:
<pre>
converter -pack gamedata -2947ru -out gamedata.db1
</pre>
Заметка:
* Используйте ключ <code>-xdb</code> для распаковки/запаковки архивов [[S.T.A.L.K.E.R. - Чистое Небо | Чистого Неба]] и [[S.T.A.L.K.E.R. - Зов Припяти | Зова Припяти]].
|}

'''ВНИМАНИЕ!''' Для использования — требуется дополнительная настройка!
{| class="mw-collapsible mw-collapsed wikitable"
! Преобразование игровых уровней в формат Level Editor
|-
|
<pre>
converter -level <номер_сборки>:<имя_уровня> [-out <имя_сцены>] [-mode maya|le|le2|raw] [-terrain]
</pre>
Примеры:
<pre>
converter -level default:l01_escape -out l01_escape -mode le
converter -level 1844:military_game -out military_game -mode le
</pre>
Ключ <code>-mode</code> задаёт режим работы:
* <code>maya</code> - декомпилировать только геометрию уровня
* <code>le</code> - декомпилировать в формат LE
* <code>le2</code> - декомпилировать в формат LE (для l12_stancia_2)
* <code>raw</code> - декомпилировать в формат LE (отладочный режим)

Ключ <code>-with_lods</code> обрабатывается в зависимости от значения <code>-mode</code>. Если он задан совместно с <code>-mode maya</code>, программа выдаст ещё и MU-модели. С остальными режимами его наличие заставляет converter разбивать LOD-текстуры, что необходимо для полной пересборки.

Ключ <code>-terrain</code> - в объект террейна добавляются только полигоны с текстурой террейна. Без ключа к террейну могут добавляться полигоны, близкие к объектам детейла (травы), например, бордюры.

Отладочные параметры: <code>-dbgcfrm, -dbgmrg</code>

Замечания/проблемы:
* Геометрия уровней из 1098, 1114, 1154 часто содержит ошибки, на которых валится современный [[xrLC]]. По крайней мере часть из них диагностируется при декомпилировании и сохраняется в стандартном формате LE в файле ''$log$\converter_<имя_сцены>.err''
* Деревья из ранних сборок (1098-1154) нельзя использовать с современными шейдерами для крупной растительности. Следует использовать современные MU-модели.
* Геометрия уровней из сборок 2215-3312 ([[S.T.A.L.K.E.R. - Тень Чернобыля|ТЧ]]) не содержит ошибок вроде нулевых треугольников или потяжек текстур, однако в редких случаях они могут появиться при пересборке с помощью [[xrLC]] на этапе оптимизации. Наблюдается, например, в шахтах лифтов на l11_pripyat.
* Геометрия уровней из сборки 3456 и выше ([[S.T.A.L.K.E.R. - Чистое Небо|ЧН]]) наоборот, иногда содержит ошибки (с точки зрения [[xrLC]] из X-Ray SDK 0.4).
* Неправильно назначается compiler shader для собранных в режиме draft уровней.
* Абажуры ламп, тайники -- фиксированная геометрия, то есть изменения будут видны только после полной пересборки уровня.
* Декали (wallmark.part) восстанавливаются только в случае наличия избыточного level.wallmarks.
* Не обрабатывается случай с пересекающимися областями звукового окружения (level.snd_env/sound_env.part). В оригинальной игре уровней с таким свойством нет.
* У моделей детальных объектов форсируется флажок two-sided для нормальной отрисовки в '''LE'''.
* Сетка навигации AI (level.ai/ai_map.part) некоторых уровней (например, l08_yantar) утоплена в геометрии. Вопрос о причине открыт.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Множественное преобразование текстур из dds в tga
|-
|
<pre>
converter -dds2tga [-with_solid] [-with_bump]
</pre>
Утилита читает все [[*.thm]] файлы в ''$textures$'' и воссоздаёт [[*.tga]] из [[*.dds]] в ''$game_textures$''. Уже существующие [[*.tga]] файлы не перезаписываются. Ключ <code>-with_solid</code> предписывает обрабатывать ещё и непрозрачные текстуры, что нужно при пересборке с <code>-gi</code>
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Множественное преобразование звуков из ogg в wav/thm
|-
|
<pre>
converter -ogg2wav
</pre>
Утилита воссоздаёт [[*.wav]]/[[*.thm]] файлы в ''$sounds$'', используя [[*.ogg]] из ''$game_sounds$''. Уже существующие [[*.wav]]/[[*.thm]] не перезаписываются.
|}

== Установка ==
Распакуйте архив '''converter 18102017.7z''' в удобную для вас директорию.

Переместите файлы "Converter Extra" из архива в директорию выбранной вами версии конвертера.

Например, ''Win32-Release/converter''

== Примечание ==
* Первый запуск после любых изменений в настройках желательно всегда делать с ключом <code>-ro</code> (работа без записи на диск).

* '''Владельцам видеокарт от NVIDIA'''! Для ускорения разбиения текстур лодов, используйте '''CUDA''' — эта версия конвертера, использует библиотеку [[NVIDIA Texture Tools]] с технологией CUDA. Результаты декомпиляции уровня ''l01_escape'' из ТЧ с разбиением текстуры лодов (система: Intel Core i5-4590, GTX 1060 6Gb): Win32-Release = ''162 секунды'' Win32-Release_CUDA = ''37 секунд'' x64-Release = ''130 секунд'' x64-Release_CUDA = ''38 секунд''

== Возможные ошибки и их исправление ==
{| class="mw-collapsible mw-collapsed wikitable"
! <code>[bug] unimplemented code path at ..\xr_entity_script.cxx</code>
|-
|
==== Ошибка ====
Может возникнуть при использовании ключа <code>-level</code>.

==== Решение ====
Попробуйте временно убрать из папки с декомпилируемым уровнем файл '''level.spawn''', и попробуйте снова.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>path $game_config$ does not exist</code>
|-
|
==== Ошибка ====
По пути указанному в <code>$game_data$</code> выбранного профиля файла '''converter.ini''', не найдена папка указанная <code>$game_config$</code> в '''fsconverter.ltx'''

Скорее всего, вы до этого работали с ЧН/ЗП, и вам понадобилось поработать с ТЧ, но вы забыли исправить имя папки <code>configs</code> на <code>config</code>.

==== Решение ====
Проверить наличие папки с указанными именем по указанному пути.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>path $maps$ does not exist</code>
|-
|
==== Ошибка ====
По пути указанному в <code>$game_data$</code> выбранного профиля файла '''converter.ini''', не найдена папка указанная <code>$maps$</code> в '''fsconverter.ltx'''

Скорее всего, в '''fsconverter.ltx''' указана старая исходная директория <code>$server_data_root$</code>, а не <code>$sdk_root$</code>. И папка <code>levels</code>, а не <code>maps</code>

==== Решение ====
Проверить наличие папки с указанными именем по указанному пути.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>[bug] unexpected code path at ..\level_tools_details.cxx</code>
|-
|
==== Ошибка ====
По пути указанному в <code>$game_data$</code> выбранного профиля файла '''converter.ini''', не найдена папка ''gamedata\textures\'''det'''''.
А так-же, причиной может стать переполнение этой папки.

==== Решение ====
Проверить наличие папки с указанными именем по указанному пути.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>unspecifed output file</code>
|-
|
==== Ошибка ====
В [[*.bat]]\[[*.cmd]] файле запуска конвертера не задан необходимый ключ <code>-out</code>

==== Решение ====
Проверить его наличие ключа, и правильность указания
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>can't set scene name explicitly for multiple input levels</code>
|-
|
==== Ошибка ====
В [[*.bat]]\[[*.cmd]] файле запуска конвертера задан ключ <code>-out</code>, но не задано "имя сцены" (см. Преобразование игровых уровней в формат Level Editor).

==== Решение ====
Проверить чтобы после ключа было указано "имя сцены" (это имя папки или путь до неё относительно папки конвертера).
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>[bug] assertion failed at ..\level_tools.cxx</code>
|-
|
==== Ошибка ====
Актуальна только для старых версий конвертера.

==== Решение ====
Используйте крайнюю версию конвертера.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>path $objects$ does not exist</code>
|-
|
==== Ошибка ====
По пути указанному в <code>$objects$</code> файла '''fsconverter.ltx''', не найдена указанная папка.

==== Решение ====
Проверить наличие папки с указанными именем по указанному пути.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>[bug] unexpected code path at ..\xr_ogf.cxx</code>
|-
|
==== Ошибка ====
Актуальна только для старых версий конвертера.

==== Решение ====
Используйте крайнюю версию конвертера.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>[bug] unexpected code path at ..\xr_ini_file.cxx</code>
|-
|
==== Ошибка ====
Нарушена структура файла '''level.ltx''' декомпилируемого уровня<ref>[http://stalker-portal.ru/forums.php?m=posts&p=1221689#1221689 Пост пользователя "BeeRsek" на форуме Stalker-Portal.ru]</ref><ref>[https://www.amk-team.ru/forum/topic/12733-instrukcii-po-vyletam-i-oshibkam/?do=findComment&comment=1212114 Пост пользователя "UriZzz" на AMK форуме]</ref><ref>[https://ap-pro.ru/forum/100-11239-916221-16-1474818460 Пост пользователя "ur3icf" на форуме AP Production]</ref>.

==== Решение ====
Откройте файл любым текстовым редактором, и удалите его содержимое.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>[bug] unexpected code path at ..\xr_level.cxx</code>
|-
|
==== Ошибка ====
В папке с декомпилируемым уровнем отсутствует директория '''meshes''' с файлами вида '''brkbl#0.ogf''', прописанными в файле '''level.spawn''' уровня.

==== Решение ====
На время декомпиляции, убрать из папки уровня файл '''level.spawn'''<ref>[https://www.amk-team.ru/forum/topic/1560-soc-voprosy-po-sdk/?do=findComment&comment=1269251 Пост пользователя "WolfHeart" на AMK форуме]</ref>
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>[bug] assertion failed at ..\xr_packet.cxx:151</code>
|-
|
==== Ошибка ====
Ошибка в файле '''level.spawn''' декомпилируемого уровня.

==== Решение ====
На время декомпиляции, убрать из папки уровня файл '''level.spawn'''<ref>[https://www.amk-team.ru/forum/topic/1560-soc-voprosy-po-sdk/?do=findComment&comment=1436805 Пост пользователя "WolfHeart" на AMK форуме]</ref>
|}

== Источники ==
{{reflist|3}}

[[Категория:Утилиты для моддинга]]

X-Ray Converter

2022-08-24T21:14:50Z

WolfHeart: /* Ошибка */

__NOTOC__
{| class="wikitable" style="float:right; margin-left:0.8em; clear:right; text-align: center; font-size:12px; width: 300px;"
|-
| colspan=2 style="font-size:20px;"|
'''X-Ray Converter'''
|-
| '''Разработчик'''
| bardak
|-
| '''Модифицировали'''
| Loxotron, [[Kolmogor]], NeoH, mnn, XiaNi, gr1ph00n, RedPython, abramcumner, Freack, xrNatteFrost, [[K.D.]], Charsi
|-
| '''Версия'''
| от 18 октября 2017 года
|-
| '''Тип'''
| Конвертер
|-
| '''Платформа'''
| Windows: Vista/ 7/ 8/ 8.1/ 10
|-
| '''Форматы файлов'''
| [[*.ogf]], [[*.object]], [[*.bones]], [[*.omf]], [[*.skls]], [[*.skl]], [[*.dm]], [[*.dds]], [[*.tga]], [[*.ogg]], [[*.wav]], [[*.thm]]
|-
| colspan=2| [[Версии X-Ray Converter|История версий]]
|}

'''X-Ray Converter'''<ref>[http://www.amk-team.ru/forum/user/16052-charsi/ "Converter 2016" в профиле пользователя "Charsi" на AMK форуме]</ref><ref>[https://bitbucket.org/stalker/xray_re-tools/downloads?tab=branches Документация конвертера в репозитории на bitbucket.org]</ref> — это многофункциональная утилита для работы с форматами файлов игры и '''X-Ray SDK'''.

{| class="mw-collapsible mw-collapsed wikitable"
! colspan=4| Ссылки на скачивание
|-
| X-Ray Converter
| https://yadi.sk/d/nivUmGybuCXSC 
https://cloud.mail.ru/public/3Zab/b8VBczdZp 
|-
| X-Ray Converter Extra
| https://yadi.sk/d/7137tI653PRnrU 
https://cloud.mail.ru/public/3REa/3SEVyeS6X
|-
| Visual C++ 2015 Redistributable
|
'''x86''' 
https://download.microsoft.com/download/6/A/A/6AA4EDFF-645B-48C5-81CC-ED5963AEAD48/vc_redist.x86.exe

'''x64''' 
https://download.microsoft.com/download/6/A/A/6AA4EDFF-645B-48C5-81CC-ED5963AEAD48/vc_redist.x64.exe
|}

Для использования конвертера, создайте в его корневой директории [[*.bat]] или [[*.cmd]] файл.

{| class="mw-collapsible mw-collapsed wikitable"
! Дополнительная настройка
|-
|
Для работы ключей <code>-level</code>, <code>-dds2tga</code> и <code>-ogg2wav</code>, необходимо задать путь к директории с '''X-Ray SDK'''.
# Откройте любым [[:Категория:Текстовые_редакторы|текстовым редактором]] файл '''fsconverter.ltx'''
# Найдите строку:<syntaxhighlight lang=ini>
$sdk_root$ = false| false| X:\
</syntaxhighlight>
# Исправьте путь в ней на свой. Например:<syntaxhighlight lang=ini>
$sdk_root$ = false| false| D:\X-Ray_SDK_0.7\editors\
</syntaxhighlight>

== Примечание ==
* Для [[X-Ray SDK 0.5|SDK 0.5]] / [[X-Ray SDK 0.7|0.7]] используйте файл '''fsconverter_cs-cop.ltx''', переименовав его в '''fsconverter.ltx'''. В нём исправлена ошибка <code>path $game_config$ does not exist</code>

Для правильной работы ключа <code>-level</code>, ещё также необходимо задать путь к директории с [[Распаковка_игровых_архивов|распакованными игровыми архивами]] для выбранной версии игры (билда).
# Откройте файл любым текстовым редактором '''converter.ini'''
# Найдите в нём секцию соответствующую необходимой версии игры. Например, для [[S.T.A.L.K.E.R. - Зов Припяти|Зова Припяти]] это секция:<syntaxhighlight lang=ini>
[3870_config]:3456_config
$game_data$ = X:\_builds_\CoP\gamedata\
$game_levels$ = X:\_builds_\CoP\gamedata\levels\
</syntaxhighlight>Исправьте пути в ней на свои. Например: <syntaxhighlight lang=ini>
$game_data$ = D:\S.T.A.L.K.E.R. Call of Pripyat\gamedata\
$game_levels$ = D:\S.T.A.L.K.E.R. Call of Pripyat\gamedata\levels\
</syntaxhighlight>
# Для последующей совместимости полученного уровня с используемой версией '''SDK''', обязательно допишите в секцию параметр <code>spawn_version</code>. <code>spawn_version = cs</code> — для '''SDK 0.6''' <code>spawn_version = cop</code> — для '''SDK 0.7'''

=== Примечание ===
* По умолчанию, если строка не указана, читается, как для [[X-Ray SDK 0.4|SDK 0.4]].
|}

== Возможности ==
{| class="mw-collapsible mw-collapsed wikitable"
! Преобразование ogf в object
|-
|
<pre>
converter [-ogf] [-object] <оригинал> [-out <результат>]
</pre>
Пример:
<pre>
converter -ogf balon_01.ogf -object
</pre>
Если ключ <code>-out <результат></code> не задан, имя результирующего файла генерируется из исходного путём замены расширения на [[*.object]]

Замечания/проблемы:
* для OGF v3 (сборки 1098, 1114, 1154) не восстанавливается bind pose скелета (просто потому что не предусмотрена форматом), но часто её можно (и нужно) реконструировать вручную из idle-анимации.
* для OGF v4+ ([[S.T.A.L.K.E.R. - Чистое Небо|ЧН]], в том числе сборка 3120) не восстанавливаются метки в анимациях (неизвестно, как они хранятся в обновлённом [[*.object]] и на данный момент нет в публичном доступе соответствующего '''X-Ray SDK'''). Кроме того, текущий '''X-Ray SDK''' игнорирует информацию о третьей и четвёртой влияющих на вершину костях.
* нет гарантии, что у двухсторонних поверхностей правильно определится "главная" сторона, однако на практике обычно всё хорошо.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Преобразование скелета из ogf в bones
|-
|
<pre>
converter [-ogf] -bones <оригинал> [-out <результат>]
</pre>
Если ключ <code>-out <результат></code> не задан, имя результирующего файла генерируется из исходного путём замены расширения на [[*.bones]]
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Преобразование всех анимаций из ogf или omf в skls
|-
|
<pre>
converter [-ogf|-omf] -skls <оригинал> [-out <результат>]
</pre>
Если ключ <code>-out <результат></code> не задан, имя результирующего файла генерируется из исходного путём замены расширения на [[*.skls]]

Замечания:
* анимация сохраняется в виде ступенчатых кривых и никакого преобразования в сплайны не производится (а надо бы).
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Преобразование отдельных анимаций из ogf или omf в skl
|-
|
<pre>
converter [-ogf|-omf] -skl <имя_анимации> <оригинал> [-out <результат>]
</pre>
Если ключ <code>-out <результат></code> не задан, имя результирующего файла генерируется из исходного путём замены расширения на [[*.skl]] и добавления суффикса с именем анимации.

Замечания/проблемы:
* Нельзя задать анимацию, в имени которой используются пробелы.
* См. выше про форму задания кривых.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Преобразование dm в object
|-
|
<pre>
converter [-dm] [-object] <оригинал> [-out <результат>]
</pre>
Если ключ <code>-out <результат></code> не задан, имя результирующего файла генерируется из исходного путём замены расширения на [[*.object]]

Замечания:
* Информация о границах масштабирования детальной модели теряется, однако можно её посмотреть с помощью ключа <code>-info</code> (вместо <code>-object</code>).
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Распаковка и упаковка игровых архивов
|-
|
<pre>
converter -unpack <архив> [-11xx|-2215|-2945|-2947ru|-2947|-xdb] [-flt <маска>]
</pre>
Ключ <code>-flt</code> служит для извлечения файлов по маске. Примеры:
<pre>
converter -unpack -xdb gamedata.db0 -flt .ogf
converter -unpack -2215 gamedata.xp0 -flt \levels\
</pre>
Команда для упаковки:
<pre>
converter -pack <папка> [-2947ru|-2947ww|-xdb|-xdb_ud <файл>] -out <путь>
</pre>
Пример:
<pre>
converter -pack gamedata -2947ru -out gamedata.db1
</pre>
Заметка:
* Используйте ключ <code>-xdb</code> для распаковки/запаковки архивов [[S.T.A.L.K.E.R. - Чистое Небо | Чистого Неба]] и [[S.T.A.L.K.E.R. - Зов Припяти | Зова Припяти]].
|}

'''ВНИМАНИЕ!''' Для использования — требуется дополнительная настройка!
{| class="mw-collapsible mw-collapsed wikitable"
! Преобразование игровых уровней в формат Level Editor
|-
|
<pre>
converter -level <номер_сборки>:<имя_уровня> [-out <имя_сцены>] [-mode maya|le|le2|raw] [-terrain]
</pre>
Примеры:
<pre>
converter -level default:l01_escape -out l01_escape -mode le
converter -level 1844:military_game -out military_game -mode le
</pre>
Ключ <code>-mode</code> задаёт режим работы:
* <code>maya</code> - декомпилировать только геометрию уровня
* <code>le</code> - декомпилировать в формат LE
* <code>le2</code> - декомпилировать в формат LE (для l12_stancia_2)
* <code>raw</code> - декомпилировать в формат LE (отладочный режим)

Ключ <code>-with_lods</code> обрабатывается в зависимости от значения <code>-mode</code>. Если он задан совместно с <code>-mode maya</code>, программа выдаст ещё и MU-модели. С остальными режимами его наличие заставляет converter разбивать LOD-текстуры, что необходимо для полной пересборки.

Ключ <code>-terrain</code> - в объект террейна добавляются только полигоны с текстурой террейна. Без ключа к террейну могут добавляться полигоны, близкие к объектам детейла (травы), например, бордюры.

Отладочные параметры: <code>-dbgcfrm, -dbgmrg</code>

Замечания/проблемы:
* Геометрия уровней из 1098, 1114, 1154 часто содержит ошибки, на которых валится современный [[xrLC]]. По крайней мере часть из них диагностируется при декомпилировании и сохраняется в стандартном формате LE в файле ''$log$\converter_<имя_сцены>.err''
* Деревья из ранних сборок (1098-1154) нельзя использовать с современными шейдерами для крупной растительности. Следует использовать современные MU-модели.
* Геометрия уровней из сборок 2215-3312 ([[S.T.A.L.K.E.R. - Тень Чернобыля|ТЧ]]) не содержит ошибок вроде нулевых треугольников или потяжек текстур, однако в редких случаях они могут появиться при пересборке с помощью [[xrLC]] на этапе оптимизации. Наблюдается, например, в шахтах лифтов на l11_pripyat.
* Геометрия уровней из сборки 3456 и выше ([[S.T.A.L.K.E.R. - Чистое Небо|ЧН]]) наоборот, иногда содержит ошибки (с точки зрения [[xrLC]] из X-Ray SDK 0.4).
* Неправильно назначается compiler shader для собранных в режиме draft уровней.
* Абажуры ламп, тайники -- фиксированная геометрия, то есть изменения будут видны только после полной пересборки уровня.
* Декали (wallmark.part) восстанавливаются только в случае наличия избыточного level.wallmarks.
* Не обрабатывается случай с пересекающимися областями звукового окружения (level.snd_env/sound_env.part). В оригинальной игре уровней с таким свойством нет.
* У моделей детальных объектов форсируется флажок two-sided для нормальной отрисовки в '''LE'''.
* Сетка навигации AI (level.ai/ai_map.part) некоторых уровней (например, l08_yantar) утоплена в геометрии. Вопрос о причине открыт.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Множественное преобразование текстур из dds в tga
|-
|
<pre>
converter -dds2tga [-with_solid] [-with_bump]
</pre>
Утилита читает все [[*.thm]] файлы в ''$textures$'' и воссоздаёт [[*.tga]] из [[*.dds]] в ''$game_textures$''. Уже существующие [[*.tga]] файлы не перезаписываются. Ключ <code>-with_solid</code> предписывает обрабатывать ещё и непрозрачные текстуры, что нужно при пересборке с <code>-gi</code>
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Множественное преобразование звуков из ogg в wav/thm
|-
|
<pre>
converter -ogg2wav
</pre>
Утилита воссоздаёт [[*.wav]]/[[*.thm]] файлы в ''$sounds$'', используя [[*.ogg]] из ''$game_sounds$''. Уже существующие [[*.wav]]/[[*.thm]] не перезаписываются.
|}

== Установка ==
Распакуйте архив '''converter 18102017.7z''' в удобную для вас директорию.

Переместите файлы "Converter Extra" из архива в директорию выбранной вами версии конвертера.

Например, ''Win32-Release/converter''

== Примечание ==
* Первый запуск после любых изменений в настройках желательно всегда делать с ключом <code>-ro</code> (работа без записи на диск).

* '''Владельцам видеокарт от NVIDIA'''! Для ускорения разбиения текстур лодов, используйте '''CUDA''' — эта версия конвертера, использует библиотеку [[NVIDIA Texture Tools]] с технологией CUDA. Результаты декомпиляции уровня ''l01_escape'' из ТЧ с разбиением текстуры лодов (система: Intel Core i5-4590, GTX 1060 6Gb): Win32-Release = ''162 секунды'' Win32-Release_CUDA = ''37 секунд'' x64-Release = ''130 секунд'' x64-Release_CUDA = ''38 секунд''

== Возможные ошибки и их исправление ==
{| class="mw-collapsible mw-collapsed wikitable"
! <code>[bug] unimplemented code path at ..\xr_entity_script.cxx</code>
|-
|
==== Ошибка ====
Может возникнуть при использовании ключа <code>-level</code>.

==== Решение ====
Попробуйте временно убрать из папки с декомпилируемым уровнем файл '''level.spawn''', и попробуйте снова.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>path $game_config$ does not exist</code>
|-
|
==== Ошибка ====
По пути указанному в <code>$game_data$</code> выбранного профиля файла '''converter.ini''', не найдена папка указанная <code>$game_config$</code> в '''fsconverter.ltx'''

Скорее всего, вы до этого работали с ЧН/ЗП, и вам понадобилось поработать с ТЧ, но вы забыли исправить имя папки <code>configs</code> на <code>config</code>.

==== Решение ====
Проверить наличие папки с указанными именем по указанному пути.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>path $maps$ does not exist</code>
|-
|
==== Ошибка ====
По пути указанному в <code>$game_data$</code> выбранного профиля файла '''converter.ini''', не найдена папка указанная <code>$maps$</code> в '''fsconverter.ltx'''

Скорее всего, в '''fsconverter.ltx''' указана старая исходная директория <code>$server_data_root$</code>, а не <code>$sdk_root$</code>. И папка <code>levels</code>, а не <code>maps</code>

==== Решение ====
Проверить наличие папки с указанными именем по указанному пути.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>[bug] unexpected code path at ..\level_tools_details.cxx</code>
|-
|
==== Ошибка ====
По пути указанному в <code>$game_data$</code> выбранного профиля файла '''converter.ini''', не найдена папка ''gamedata\textures\'''det'''''
А так-же, причиной может стать переполнение этой папки.

==== Решение ====
Проверить наличие папки с указанными именем по указанному пути.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>unspecifed output file</code>
|-
|
==== Ошибка ====
В [[*.bat]]\[[*.cmd]] файле запуска конвертера не задан необходимый ключ <code>-out</code>

==== Решение ====
Проверить его наличие ключа, и правильность указания
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>can't set scene name explicitly for multiple input levels</code>
|-
|
==== Ошибка ====
В [[*.bat]]\[[*.cmd]] файле запуска конвертера задан ключ <code>-out</code>, но не задано "имя сцены" (см. Преобразование игровых уровней в формат Level Editor).

==== Решение ====
Проверить чтобы после ключа было указано "имя сцены" (это имя папки или путь до неё относительно папки конвертера).
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>[bug] assertion failed at ..\level_tools.cxx</code>
|-
|
==== Ошибка ====
Актуальна только для старых версий конвертера.

==== Решение ====
Используйте крайнюю версию конвертера.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>path $objects$ does not exist</code>
|-
|
==== Ошибка ====
По пути указанному в <code>$objects$</code> файла '''fsconverter.ltx''', не найдена указанная папка.

==== Решение ====
Проверить наличие папки с указанными именем по указанному пути.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>[bug] unexpected code path at ..\xr_ogf.cxx</code>
|-
|
==== Ошибка ====
Актуальна только для старых версий конвертера.

==== Решение ====
Используйте крайнюю версию конвертера.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>[bug] unexpected code path at ..\xr_ini_file.cxx</code>
|-
|
==== Ошибка ====
Нарушена структура файла '''level.ltx''' декомпилируемого уровня<ref>[http://stalker-portal.ru/forums.php?m=posts&p=1221689#1221689 Пост пользователя "BeeRsek" на форуме Stalker-Portal.ru]</ref><ref>[https://www.amk-team.ru/forum/topic/12733-instrukcii-po-vyletam-i-oshibkam/?do=findComment&comment=1212114 Пост пользователя "UriZzz" на AMK форуме]</ref><ref>[https://ap-pro.ru/forum/100-11239-916221-16-1474818460 Пост пользователя "ur3icf" на форуме AP Production]</ref>.

==== Решение ====
Откройте файл любым текстовым редактором, и удалите его содержимое.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>[bug] unexpected code path at ..\xr_level.cxx</code>
|-
|
==== Ошибка ====
В папке с декомпилируемым уровнем отсутствует директория '''meshes''' с файлами вида '''brkbl#0.ogf''', прописанными в файле '''level.spawn''' уровня.

==== Решение ====
На время декомпиляции, убрать из папки уровня файл '''level.spawn'''<ref>[https://www.amk-team.ru/forum/topic/1560-soc-voprosy-po-sdk/?do=findComment&comment=1269251 Пост пользователя "WolfHeart" на AMK форуме]</ref>
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>[bug] assertion failed at ..\xr_packet.cxx:151</code>
|-
|
==== Ошибка ====
Ошибка в файле '''level.spawn''' декомпилируемого уровня.

==== Решение ====
На время декомпиляции, убрать из папки уровня файл '''level.spawn'''<ref>[https://www.amk-team.ru/forum/topic/1560-soc-voprosy-po-sdk/?do=findComment&comment=1436805 Пост пользователя "WolfHeart" на AMK форуме]</ref>
|}

== Источники ==
{{reflist|3}}

[[Категория:Утилиты для моддинга]]

X-Ray Converter

2022-08-24T20:51:34Z

WolfHeart: Добавлена новая ошибка.

__NOTOC__
{| class="wikitable" style="float:right; margin-left:0.8em; clear:right; text-align: center; font-size:12px; width: 300px;"
|-
| colspan=2 style="font-size:20px;"|
'''X-Ray Converter'''
|-
| '''Разработчик'''
| bardak
|-
| '''Модифицировали'''
| Loxotron, [[Kolmogor]], NeoH, mnn, XiaNi, gr1ph00n, RedPython, abramcumner, Freack, xrNatteFrost, [[K.D.]], Charsi
|-
| '''Версия'''
| от 18 октября 2017 года
|-
| '''Тип'''
| Конвертер
|-
| '''Платформа'''
| Windows: Vista/ 7/ 8/ 8.1/ 10
|-
| '''Форматы файлов'''
| [[*.ogf]], [[*.object]], [[*.bones]], [[*.omf]], [[*.skls]], [[*.skl]], [[*.dm]], [[*.dds]], [[*.tga]], [[*.ogg]], [[*.wav]], [[*.thm]]
|-
| colspan=2| [[Версии X-Ray Converter|История версий]]
|}

'''X-Ray Converter'''<ref>[http://www.amk-team.ru/forum/user/16052-charsi/ "Converter 2016" в профиле пользователя "Charsi" на AMK форуме]</ref><ref>[https://bitbucket.org/stalker/xray_re-tools/downloads?tab=branches Документация конвертера в репозитории на bitbucket.org]</ref> — это многофункциональная утилита для работы с форматами файлов игры и '''X-Ray SDK'''.

{| class="mw-collapsible mw-collapsed wikitable"
! colspan=4| Ссылки на скачивание
|-
| X-Ray Converter
| https://yadi.sk/d/nivUmGybuCXSC 
https://cloud.mail.ru/public/3Zab/b8VBczdZp 
|-
| X-Ray Converter Extra
| https://yadi.sk/d/7137tI653PRnrU 
https://cloud.mail.ru/public/3REa/3SEVyeS6X
|-
| Visual C++ 2015 Redistributable
|
'''x86''' 
https://download.microsoft.com/download/6/A/A/6AA4EDFF-645B-48C5-81CC-ED5963AEAD48/vc_redist.x86.exe

'''x64''' 
https://download.microsoft.com/download/6/A/A/6AA4EDFF-645B-48C5-81CC-ED5963AEAD48/vc_redist.x64.exe
|}

Для использования конвертера, создайте в его корневой директории [[*.bat]] или [[*.cmd]] файл.

{| class="mw-collapsible mw-collapsed wikitable"
! Дополнительная настройка
|-
|
Для работы ключей <code>-level</code>, <code>-dds2tga</code> и <code>-ogg2wav</code>, необходимо задать путь к директории с '''X-Ray SDK'''.
# Откройте любым [[:Категория:Текстовые_редакторы|текстовым редактором]] файл '''fsconverter.ltx'''
# Найдите строку:<syntaxhighlight lang=ini>
$sdk_root$ = false| false| X:\
</syntaxhighlight>
# Исправьте путь в ней на свой. Например:<syntaxhighlight lang=ini>
$sdk_root$ = false| false| D:\X-Ray_SDK_0.7\editors\
</syntaxhighlight>

== Примечание ==
* Для [[X-Ray SDK 0.5|SDK 0.5]] / [[X-Ray SDK 0.7|0.7]] используйте файл '''fsconverter_cs-cop.ltx''', переименовав его в '''fsconverter.ltx'''. В нём исправлена ошибка <code>path $game_config$ does not exist</code>

Для правильной работы ключа <code>-level</code>, ещё также необходимо задать путь к директории с [[Распаковка_игровых_архивов|распакованными игровыми архивами]] для выбранной версии игры (билда).
# Откройте файл любым текстовым редактором '''converter.ini'''
# Найдите в нём секцию соответствующую необходимой версии игры. Например, для [[S.T.A.L.K.E.R. - Зов Припяти|Зова Припяти]] это секция:<syntaxhighlight lang=ini>
[3870_config]:3456_config
$game_data$ = X:\_builds_\CoP\gamedata\
$game_levels$ = X:\_builds_\CoP\gamedata\levels\
</syntaxhighlight>Исправьте пути в ней на свои. Например: <syntaxhighlight lang=ini>
$game_data$ = D:\S.T.A.L.K.E.R. Call of Pripyat\gamedata\
$game_levels$ = D:\S.T.A.L.K.E.R. Call of Pripyat\gamedata\levels\
</syntaxhighlight>
# Для последующей совместимости полученного уровня с используемой версией '''SDK''', обязательно допишите в секцию параметр <code>spawn_version</code>. <code>spawn_version = cs</code> — для '''SDK 0.6''' <code>spawn_version = cop</code> — для '''SDK 0.7'''

=== Примечание ===
* По умолчанию, если строка не указана, читается, как для [[X-Ray SDK 0.4|SDK 0.4]].
|}

== Возможности ==
{| class="mw-collapsible mw-collapsed wikitable"
! Преобразование ogf в object
|-
|
<pre>
converter [-ogf] [-object] <оригинал> [-out <результат>]
</pre>
Пример:
<pre>
converter -ogf balon_01.ogf -object
</pre>
Если ключ <code>-out <результат></code> не задан, имя результирующего файла генерируется из исходного путём замены расширения на [[*.object]]

Замечания/проблемы:
* для OGF v3 (сборки 1098, 1114, 1154) не восстанавливается bind pose скелета (просто потому что не предусмотрена форматом), но часто её можно (и нужно) реконструировать вручную из idle-анимации.
* для OGF v4+ ([[S.T.A.L.K.E.R. - Чистое Небо|ЧН]], в том числе сборка 3120) не восстанавливаются метки в анимациях (неизвестно, как они хранятся в обновлённом [[*.object]] и на данный момент нет в публичном доступе соответствующего '''X-Ray SDK'''). Кроме того, текущий '''X-Ray SDK''' игнорирует информацию о третьей и четвёртой влияющих на вершину костях.
* нет гарантии, что у двухсторонних поверхностей правильно определится "главная" сторона, однако на практике обычно всё хорошо.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Преобразование скелета из ogf в bones
|-
|
<pre>
converter [-ogf] -bones <оригинал> [-out <результат>]
</pre>
Если ключ <code>-out <результат></code> не задан, имя результирующего файла генерируется из исходного путём замены расширения на [[*.bones]]
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Преобразование всех анимаций из ogf или omf в skls
|-
|
<pre>
converter [-ogf|-omf] -skls <оригинал> [-out <результат>]
</pre>
Если ключ <code>-out <результат></code> не задан, имя результирующего файла генерируется из исходного путём замены расширения на [[*.skls]]

Замечания:
* анимация сохраняется в виде ступенчатых кривых и никакого преобразования в сплайны не производится (а надо бы).
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Преобразование отдельных анимаций из ogf или omf в skl
|-
|
<pre>
converter [-ogf|-omf] -skl <имя_анимации> <оригинал> [-out <результат>]
</pre>
Если ключ <code>-out <результат></code> не задан, имя результирующего файла генерируется из исходного путём замены расширения на [[*.skl]] и добавления суффикса с именем анимации.

Замечания/проблемы:
* Нельзя задать анимацию, в имени которой используются пробелы.
* См. выше про форму задания кривых.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Преобразование dm в object
|-
|
<pre>
converter [-dm] [-object] <оригинал> [-out <результат>]
</pre>
Если ключ <code>-out <результат></code> не задан, имя результирующего файла генерируется из исходного путём замены расширения на [[*.object]]

Замечания:
* Информация о границах масштабирования детальной модели теряется, однако можно её посмотреть с помощью ключа <code>-info</code> (вместо <code>-object</code>).
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Распаковка и упаковка игровых архивов
|-
|
<pre>
converter -unpack <архив> [-11xx|-2215|-2945|-2947ru|-2947|-xdb] [-flt <маска>]
</pre>
Ключ <code>-flt</code> служит для извлечения файлов по маске. Примеры:
<pre>
converter -unpack -xdb gamedata.db0 -flt .ogf
converter -unpack -2215 gamedata.xp0 -flt \levels\
</pre>
Команда для упаковки:
<pre>
converter -pack <папка> [-2947ru|-2947ww|-xdb|-xdb_ud <файл>] -out <путь>
</pre>
Пример:
<pre>
converter -pack gamedata -2947ru -out gamedata.db1
</pre>
Заметка:
* Используйте ключ <code>-xdb</code> для распаковки/запаковки архивов [[S.T.A.L.K.E.R. - Чистое Небо | Чистого Неба]] и [[S.T.A.L.K.E.R. - Зов Припяти | Зова Припяти]].
|}

'''ВНИМАНИЕ!''' Для использования — требуется дополнительная настройка!
{| class="mw-collapsible mw-collapsed wikitable"
! Преобразование игровых уровней в формат Level Editor
|-
|
<pre>
converter -level <номер_сборки>:<имя_уровня> [-out <имя_сцены>] [-mode maya|le|le2|raw] [-terrain]
</pre>
Примеры:
<pre>
converter -level default:l01_escape -out l01_escape -mode le
converter -level 1844:military_game -out military_game -mode le
</pre>
Ключ <code>-mode</code> задаёт режим работы:
* <code>maya</code> - декомпилировать только геометрию уровня
* <code>le</code> - декомпилировать в формат LE
* <code>le2</code> - декомпилировать в формат LE (для l12_stancia_2)
* <code>raw</code> - декомпилировать в формат LE (отладочный режим)

Ключ <code>-with_lods</code> обрабатывается в зависимости от значения <code>-mode</code>. Если он задан совместно с <code>-mode maya</code>, программа выдаст ещё и MU-модели. С остальными режимами его наличие заставляет converter разбивать LOD-текстуры, что необходимо для полной пересборки.

Ключ <code>-terrain</code> - в объект террейна добавляются только полигоны с текстурой террейна. Без ключа к террейну могут добавляться полигоны, близкие к объектам детейла (травы), например, бордюры.

Отладочные параметры: <code>-dbgcfrm, -dbgmrg</code>

Замечания/проблемы:
* Геометрия уровней из 1098, 1114, 1154 часто содержит ошибки, на которых валится современный [[xrLC]]. По крайней мере часть из них диагностируется при декомпилировании и сохраняется в стандартном формате LE в файле ''$log$\converter_<имя_сцены>.err''
* Деревья из ранних сборок (1098-1154) нельзя использовать с современными шейдерами для крупной растительности. Следует использовать современные MU-модели.
* Геометрия уровней из сборок 2215-3312 ([[S.T.A.L.K.E.R. - Тень Чернобыля|ТЧ]]) не содержит ошибок вроде нулевых треугольников или потяжек текстур, однако в редких случаях они могут появиться при пересборке с помощью [[xrLC]] на этапе оптимизации. Наблюдается, например, в шахтах лифтов на l11_pripyat.
* Геометрия уровней из сборки 3456 и выше ([[S.T.A.L.K.E.R. - Чистое Небо|ЧН]]) наоборот, иногда содержит ошибки (с точки зрения [[xrLC]] из X-Ray SDK 0.4).
* Неправильно назначается compiler shader для собранных в режиме draft уровней.
* Абажуры ламп, тайники -- фиксированная геометрия, то есть изменения будут видны только после полной пересборки уровня.
* Декали (wallmark.part) восстанавливаются только в случае наличия избыточного level.wallmarks.
* Не обрабатывается случай с пересекающимися областями звукового окружения (level.snd_env/sound_env.part). В оригинальной игре уровней с таким свойством нет.
* У моделей детальных объектов форсируется флажок two-sided для нормальной отрисовки в '''LE'''.
* Сетка навигации AI (level.ai/ai_map.part) некоторых уровней (например, l08_yantar) утоплена в геометрии. Вопрос о причине открыт.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Множественное преобразование текстур из dds в tga
|-
|
<pre>
converter -dds2tga [-with_solid] [-with_bump]
</pre>
Утилита читает все [[*.thm]] файлы в ''$textures$'' и воссоздаёт [[*.tga]] из [[*.dds]] в ''$game_textures$''. Уже существующие [[*.tga]] файлы не перезаписываются. Ключ <code>-with_solid</code> предписывает обрабатывать ещё и непрозрачные текстуры, что нужно при пересборке с <code>-gi</code>
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Множественное преобразование звуков из ogg в wav/thm
|-
|
<pre>
converter -ogg2wav
</pre>
Утилита воссоздаёт [[*.wav]]/[[*.thm]] файлы в ''$sounds$'', используя [[*.ogg]] из ''$game_sounds$''. Уже существующие [[*.wav]]/[[*.thm]] не перезаписываются.
|}

== Установка ==
Распакуйте архив '''converter 18102017.7z''' в удобную для вас директорию.

Переместите файлы "Converter Extra" из архива в директорию выбранной вами версии конвертера.

Например, ''Win32-Release/converter''

== Примечание ==
* Первый запуск после любых изменений в настройках желательно всегда делать с ключом <code>-ro</code> (работа без записи на диск).

* '''Владельцам видеокарт от NVIDIA'''! Для ускорения разбиения текстур лодов, используйте '''CUDA''' — эта версия конвертера, использует библиотеку [[NVIDIA Texture Tools]] с технологией CUDA. Результаты декомпиляции уровня ''l01_escape'' из ТЧ с разбиением текстуры лодов (система: Intel Core i5-4590, GTX 1060 6Gb): Win32-Release = ''162 секунды'' Win32-Release_CUDA = ''37 секунд'' x64-Release = ''130 секунд'' x64-Release_CUDA = ''38 секунд''

== Возможные ошибки и их исправление ==
{| class="mw-collapsible mw-collapsed wikitable"
! <code>[bug] unimplemented code path at ..\xr_entity_script.cxx</code>
|-
|
==== Ошибка ====
Может возникнуть при использовании ключа <code>-level</code>.

==== Решение ====
Попробуйте временно убрать из папки с декомпилируемым уровнем файл '''level.spawn''', и попробуйте снова.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>path $game_config$ does not exist</code>
|-
|
==== Ошибка ====
По пути указанному в <code>$game_data$</code> выбранного профиля файла '''converter.ini''', не найдена папка указанная <code>$game_config$</code> в '''fsconverter.ltx'''

Скорее всего, вы до этого работали с ЧН/ЗП, и вам понадобилось поработать с ТЧ, но вы забыли исправить имя папки <code>configs</code> на <code>config</code>.

==== Решение ====
Проверить наличие папки с указанными именем по указанному пути.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>path $maps$ does not exist</code>
|-
|
==== Ошибка ====
По пути указанному в <code>$game_data$</code> выбранного профиля файла '''converter.ini''', не найдена папка указанная <code>$maps$</code> в '''fsconverter.ltx'''

Скорее всего, в '''fsconverter.ltx''' указана старая исходная директория <code>$server_data_root$</code>, а не <code>$sdk_root$</code>. И папка <code>levels</code>, а не <code>maps</code>

==== Решение ====
Проверить наличие папки с указанными именем по указанному пути.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>[bug] unexpected code path at ..\level_tools_details.cxx</code>
|-
|
==== Ошибка ====
По пути указанному в <code>$game_data$</code> выбранного профиля файла '''converter.ini''', не найдена папка ''gamedata\textures\'''det'''''

==== Решение ====
Проверить наличие папки с указанными именем по указанному пути.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>unspecifed output file</code>
|-
|
==== Ошибка ====
В [[*.bat]]\[[*.cmd]] файле запуска конвертера не задан необходимый ключ <code>-out</code>

==== Решение ====
Проверить его наличие ключа, и правильность указания
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>can't set scene name explicitly for multiple input levels</code>
|-
|
==== Ошибка ====
В [[*.bat]]\[[*.cmd]] файле запуска конвертера задан ключ <code>-out</code>, но не задано "имя сцены" (см. Преобразование игровых уровней в формат Level Editor).

==== Решение ====
Проверить чтобы после ключа было указано "имя сцены" (это имя папки или путь до неё относительно папки конвертера).
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>[bug] assertion failed at ..\level_tools.cxx</code>
|-
|
==== Ошибка ====
Актуальна только для старых версий конвертера.

==== Решение ====
Используйте крайнюю версию конвертера.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>path $objects$ does not exist</code>
|-
|
==== Ошибка ====
По пути указанному в <code>$objects$</code> файла '''fsconverter.ltx''', не найдена указанная папка.

==== Решение ====
Проверить наличие папки с указанными именем по указанному пути.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>[bug] unexpected code path at ..\xr_ogf.cxx</code>
|-
|
==== Ошибка ====
Актуальна только для старых версий конвертера.

==== Решение ====
Используйте крайнюю версию конвертера.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>[bug] unexpected code path at ..\xr_ini_file.cxx</code>
|-
|
==== Ошибка ====
Нарушена структура файла '''level.ltx''' декомпилируемого уровня<ref>[http://stalker-portal.ru/forums.php?m=posts&p=1221689#1221689 Пост пользователя "BeeRsek" на форуме Stalker-Portal.ru]</ref><ref>[https://www.amk-team.ru/forum/topic/12733-instrukcii-po-vyletam-i-oshibkam/?do=findComment&comment=1212114 Пост пользователя "UriZzz" на AMK форуме]</ref><ref>[https://ap-pro.ru/forum/100-11239-916221-16-1474818460 Пост пользователя "ur3icf" на форуме AP Production]</ref>.

==== Решение ====
Откройте файл любым текстовым редактором, и удалите его содержимое.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>[bug] unexpected code path at ..\xr_level.cxx</code>
|-
|
==== Ошибка ====
В папке с декомпилируемым уровнем отсутствует директория '''meshes''' с файлами вида '''brkbl#0.ogf''', прописанными в файле '''level.spawn''' уровня.

==== Решение ====
На время декомпиляции, убрать из папки уровня файл '''level.spawn'''<ref>[https://www.amk-team.ru/forum/topic/1560-soc-voprosy-po-sdk/?do=findComment&comment=1269251 Пост пользователя "WolfHeart" на AMK форуме]</ref>
|}
{| class="mw-collapsible mw-collapsed wikitable"
! <code>[bug] assertion failed at ..\xr_packet.cxx:151</code>
|-
|
==== Ошибка ====
Ошибка в файле '''level.spawn''' декомпилируемого уровня.

==== Решение ====
На время декомпиляции, убрать из папки уровня файл '''level.spawn'''<ref>[https://www.amk-team.ru/forum/topic/1560-soc-voprosy-po-sdk/?do=findComment&comment=1436805 Пост пользователя "WolfHeart" на AMK форуме]</ref>
|}

== Источники ==
{{reflist|3}}

[[Категория:Утилиты для моддинга]]

Распаковка игровых архивов

2019-01-15T17:35:54Z

WolfHeart: Вставил ссылку на S.T.A.L.K.E.R. Universal Extractor 2.0

__NOTOC__
{| class="wikitable" style="float:right; margin-left:0.8em; clear:right; text-align: center; font-size:12px; width: 300px;"
|-
| colspan=2 style="font-size:20px;"|
'''Распаковка игровых архивов'''
|-
| '''Автор'''
| [[Участник:aka_sektor|aka_sektor]]
|-
| '''Тип статьи'''
| руководство
|-
| '''Актуальность'''
| [[S.T.A.L.K.E.R. - Тень Чернобыля|ТЧ]], [[S.T.A.L.K.E.R. - Чистое Небо|ЧН]], [[S.T.A.L.K.E.R. - Зов Припяти|ЗП]]
|-
| '''Необходимый софт'''
| [https://yadi.sk/d/pV0WvHBb2dsxFA S.T.A.L.K.E.R. Universal Extractor], [[X-Ray Converter]]
|-
| '''Необходимые файлы'''
| [[*.db]] и [[*.xdb]] архивы
|}

Если вы решили модифицировать игры серии S.T.A.L.K.E.R., вы столкнетесь с главной проблемой: все ресурсы запакованы в [[*.db]] и [[*.xdb]] архивы.

Благо, её очень просто решить. Существует несколько способов распаковки.

== Основной способ ==
Он же самый простой способ - это распаковать игровые архивы специализированной утилитой [[S.T.A.L.K.E.R. Universal Extractor]].

Утилита обладает интуитивно-понятным графическим интерфейсом.

{| class="wikitable" width: 250px;"
|-
| style="text-align:center"| [https://images.gameru.net/image/8bfd20847b819a4.png.html https://images.gameru.net/thumb/8bfd20847b819a4.png]
|-
| Интерфейс S.T.A.L.K.E.R. Universal Extractor 2.0
|}
{| class="wikitable" style="float:left; margin-right:0.8em; clear:left; width: 250px;"
|-
| style="text-align:center"| [https://images.gameru.net/image/0d3b74829188cf6.png.html https://images.gameru.net/thumb/0d3b74829188cf6.png]
|-
| Исправленный порядок распаковки [[S.T.A.L.K.E.R. - Чистое Небо|ЧН]]/[[S.T.A.L.K.E.R. - Зов Припяти|ЗП]]
|}
Все что нужно сделать, это:

1. Выбрать подходящий ключ распаковки. Для [[S.T.A.L.K.E.R. - Тень Чернобыля|ТЧ]] это <code>-2947ru</code>, а для [[S.T.A.L.K.E.R. - Чистое Небо|ЧН]] и [[S.T.A.L.K.E.R. - Зов Припяти|ЗП]] - <code>-xdb</code>

2. Нажать кнопку "'''Найти архивы'''", и указать корневую директорию игры.

3. Дождаться загрузки списка найденных архивов, он формируется в алфавитном порядке. Если с [[S.T.A.L.K.E.R. - Тень Чернобыля|ТЧ]] такой порядок роли не играет, то с [[S.T.A.L.K.E.R. - Чистое Небо|ЧН]]/[[S.T.A.L.K.E.R. - Зов Припяти|ЗП]] '''ОБЯЗАТЕЛЬНО''' необходимо вручную передвигать архивы локализации и патчей в самый конец списка.

4. Нажать кнопку "'''Начать распаковку'''".

По окончанию распаковки вы получите папку '''gamedata''' со всеми файлами игры.

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

Утилита использующаяся в предыдущем способе фактически лишь '''GUI''' для другой утилиты [[X-Ray Converter]]. Она работает в командной строке, это значит, что вам необходимо создать [[*.bat]]-файл и вручную задать в нём какие архивы, каким ключом и куда распаковывать. Причем, важно правильно указать порядок, иначе старые файлы могут перезаписать новые, например, старый патч может перезаписать новый (с утилитой подобной проблемы нет).

Используйте готовые пресеты:
{| class="mw-collapsible mw-collapsed wikitable"
! Команды для распаковки [[S.T.A.L.K.E.R. - Тень Чернобыля|ТЧ]]
|- class="mw-collapsible-content" style="display: none;"
|
<pre>
converter.exe -unpack gamedata.db0 -2947ru -dir unpack
converter.exe -unpack gamedata.db1 -2947ru -dir unpack
converter.exe -unpack gamedata.db2 -2947ru -dir unpack
converter.exe -unpack gamedata.db3 -2947ru -dir unpack
converter.exe -unpack gamedata.db4 -2947ru -dir unpack
converter.exe -unpack gamedata.db5 -2947ru -dir unpack
converter.exe -unpack gamedata.db6 -2947ru -dir unpack
converter.exe -unpack gamedata.db7 -2947ru -dir unpack
converter.exe -unpack gamedata.db8 -2947ru -dir unpack
converter.exe -unpack gamedata.db9 -2947ru -dir unpack
converter.exe -unpack gamedata.dba -2947ru -dir unpack
converter.exe -unpack gamedata.dbb -2947ru -dir unpack
converter.exe -unpack gamedata.dbc -2947ru -dir unpack
converter.exe -unpack gamedata.dbd -2947ru -dir unpack
</pre>
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Команды для распаковки [[S.T.A.L.K.E.R. - Чистое Небо|ЧН]]
|- class="mw-collapsible-content" style="display: none;"
|
<pre>
converter.exe -unpack -xdb mp\mp_agroprom.db -dir unpack
converter.exe -unpack -xdb mp\mp_atp.db -dir unpack
converter.exe -unpack -xdb mp\mp_autostation.db -dir unpack
converter.exe -unpack -xdb mp\mp_bath.db -dir unpack
converter.exe -unpack -xdb mp\mp_darkvalley.db -dir unpack
converter.exe -unpack -xdb mp\mp_factory.db -dir unpack
converter.exe -unpack -xdb mp\mp_firestation.db -dir unpack
converter.exe -unpack -xdb mp\mp_garbage.db -dir unpack
converter.exe -unpack -xdb mp\mp_limansk.db -dir unpack
converter.exe -unpack -xdb mp\mp_lost_village.db -dir unpack
converter.exe -unpack -xdb mp\mp_military_1.db -dir unpack
converter.exe -unpack -xdb mp\mp_military_2.db -dir unpack
converter.exe -unpack -xdb mp\mp_pool.db -dir unpack
converter.exe -unpack -xdb mp\mp_railroad.db -dir unpack
converter.exe -unpack -xdb mp\mp_rembasa.db -dir unpack
converter.exe -unpack -xdb mp\mp_rostok.db -dir unpack
converter.exe -unpack -xdb mp\mp_sport_center.db -dir unpack
converter.exe -unpack -xdb mp\mp_training_camp.db -dir unpack
converter.exe -unpack -xdb mp\mp_workshop.db -dir unpack
converter.exe -unpack -xdb levels\levels.db0 -dir unpack
converter.exe -unpack -xdb levels\levels.db1 -dir unpack
converter.exe -unpack -xdb levels\levels.db2 -dir unpack
converter.exe -unpack -xdb resources\configs.db -dir unpack
converter.exe -unpack -xdb resources\resources.db0 -dir unpack
converter.exe -unpack -xdb resources\resources.db1 -dir unpack
converter.exe -unpack -xdb resources\resources.db2 -dir unpack
converter.exe -unpack -xdb localization\xrussian.db -dir unpack
converter.exe -unpack -xdb patches\xpatch_03.db -dir unpack
converter.exe -unpack -xdb patches\xpatch_04.db -dir unpack
converter.exe -unpack -xdb patches\xpatch_05.db -dir unpack
converter.exe -unpack -xdb patches\xpatch_07.db -dir unpack
converter.exe -unpack -xdb patches\xpatch_08.db -dir unpack
converter.exe -unpack -xdb patches\xpatch_09.db -dir unpack
converter.exe -unpack -xdb patches\xpatch_10.db -dir unpack
</pre>
|}
{| class="mw-collapsible mw-collapsed wikitable"
! Команды для распаковки [[S.T.A.L.K.E.R. - Зов Припяти|ЗП]]
|- class="mw-collapsible-content" style="display: none;"
|
<pre>
converter.exe -unpack -xdb mp\mp_agroprom.db -dir unpack
converter.exe -unpack -xdb mp\mp_atp.db -dir unpack
converter.exe -unpack -xdb mp\mp_autostation.db -dir unpack
converter.exe -unpack -xdb mp\mp_bath.db -dir unpack
converter.exe -unpack -xdb mp\mp_darkvalley.db -dir unpack
converter.exe -unpack -xdb mp\mp_factory.db -dir unpack
converter.exe -unpack -xdb mp\mp_firestation.db -dir unpack
converter.exe -unpack -xdb mp\mp_garbage.db -dir unpack
converter.exe -unpack -xdb mp\mp_limansk.db -dir unpack
converter.exe -unpack -xdb mp\mp_lost_village.db -dir unpack
converter.exe -unpack -xdb mp\mp_pool.db -dir unpack
converter.exe -unpack -xdb mp\mp_pripyat.db -dir unpack
converter.exe -unpack -xdb mp\mp_railroad.db -dir unpack
converter.exe -unpack -xdb mp\mp_rembasa.db -dir unpack
converter.exe -unpack -xdb mp\mp_rostok.db -dir unpack
converter.exe -unpack -xdb mp\mp_sport_center.db -dir unpack
converter.exe -unpack -xdb mp\mp_workshop.db -dir unpack
converter.exe -unpack -xdb levels\levels.db0 -dir unpack
converter.exe -unpack -xdb levels\levels.db1 -dir unpack
converter.exe -unpack -xdb resources\configs.db -dir unpack
converter.exe -unpack -xdb resources\resources.db0 -dir unpack
converter.exe -unpack -xdb resources\resources.db1 -dir unpack
converter.exe -unpack -xdb resources\resources.db2 -dir unpack
converter.exe -unpack -xdb resources\resources.db3 -dir unpack
converter.exe -unpack -xdb resources\resources.db4 -dir unpack
converter.exe -unpack -xdb localization\xrussian.db -dir unpack
converter.exe -unpack -xdb patches\xpatch_01.db -dir unpack
converter.exe -unpack -xdb patches\xpatch_02.db -dir unpack
</pre>
|}
Поместите файлы конвертера и [[*.bat]]-файл с кодом пресета в корневую директорию игры, после чего запустите его, и дождитесь окончания распаковки.

Все ресурсы будут находится в папке '''unpack'''.

[[Категория:Игровые архивы]][[Категория:F.A.Q.]]