Universal ACDC и другие perl-скрипты

KD87 · 16 Сентября 2011

Введение (Показать)

Ридми от ACDC: universal acdc (Показать)

-----------------------------------------------------------
--S.T.A.L.K.E.R. *.spawn compiler/decompiler--
-----------------------------------------------------------
Версия: 1.38
Дата последних правок: 21.05.2014

Кратко (Показать)

Данный acdc предназначен для распаковки и запаковки all.spawn/level.spawn от любого билда, начиная с 1265.
Основные фичи:
-распаковка оригинальных спавнов ТЧ, ЧН, ЗП и билдов ТЧ, начиная с xrCore build 1265.
-распаковка спавнов от модов (требуется папка конфигов от мода)
-конвертация спавна в любую другую версию.
-массовая замена гейм-вертексов в распакованном спавне.
-разбивка all.spawn на level.spawn'ы и level.game'ы
-сравнение файлов распакованного спавна
-обновление вертексов согласно координат объектов
Что нужно для работы:
-собственно, сам спавн (all.spawn, level.spawn)
-game.graph (только если распаковываете all.spawn).
Если all.spawn от билда 3120, ЧН или ЗП - game.graph не нужен (он вшит в спавн).
-папка configs (если распаковываете мод и acdc жалуется на unknown section)

Для корректной работы используйте с папкой stkutils строго последней версии.

Использование:
Кладете all.spawn (или level.spawn) и game.graph в папку с программой, делаете батник (команды ниже),
запускаете батник, радуетесь жизни.

Пояснение по дальнейшему тексту: в угловых скобочках (<>) указано значение опции. Это путь до спавна,
папка для распаковки и т.п., то есть то, что нужно вписывать вам. В квадратных скобочках ([])
указаны необязательные опции. Опции без скобочек - обязательны.

Распаковка спавна (Показать)

Режим предназначен для распаковки файлов all.spawn и level.spawn

Команда: universal_acdc.pl -d <spawn_file> [common_options]

-d <spawn_file> - путь до спавна.
common_options - общие опции. Читайте про них ниже.
При распаковке спавнов от модов может возникнуть ошибка "unknown section".
Это означает, что в моде используются нестандартные секции предметов/мобов.
Для распаковки такого спавна необходимо использовать ключ -scan, указав ему в качестве параметра
путь до папки config/configs. Пример смотрите в батнике acdc_decompile_scan.

Запаковка спавна (Показать)

Режим предназначен для запаковки распакованных текстовых файлов спавна в all.spawn или level.spawn

Команда: universal_acdc.pl -compile <dir> [-idx <index_file>] [-f <flag1,flag2,...>] [common_options]

-compile <dir> - папка, в которой лежит распакованный спавн. Если работаете в текущей папке, <dir> не нужно.
common_options - общие опции. Читайте про них ниже.
-idx <index_file> - с этим ключом скрипт сформирует ltx конфиг с секциями вида:

[13_box_wood_01_0021] ;формат - "индекс_локации"_"имя_объекта"
id = 2907 ;id объекта
story_id = -1 ;story_id объекта

Такие записи создадутся для ВСЕХ объектов из спавна.
Если указать ключ -idx без пути до конфига, он появится в папке с acdc (spawn_ids).
Зачем это нужно? В игре вы сможете открыть этот файл из скриптов и найти нужный вам объект.
Если раньше для нахождения нужного id объекта по имени требовалось перебрать все объекты в игре,
теперь это можно сделать, просто считав id из нужной секции конфига.
Также есть кое-какие дополнительные фичи:
- при компиляции для правильной работы необязательно проставлять всем секциям в спавне
параметры version и script_version. Достаточно поставить их в секции актора, ацдц далее будет использовать их.
Полезно, когда спавн "сборный".
- при компиляции контролируется уникальность параметров story_id, чтобы не мучиться потом с вылетами игры.

Конвертирование спавна (Показать)

Режим позволяет конвертировать спавны ТЧ, ЧН, ЗП между собой.

Команда: universal_acdc.pl -convert <file> -version <new_version> [common_options]

-convert <file> - файл, который нужно сконвертировать. Можно указывать как запакованный (*.spawn) спавн,
так и распакованный (alife_***.ltx). Внимание! Так как граф и кросс-таблицы в ЧН и ЗП вшиты в спавн,
для конвертирования ЗАПАКОВАННЫХ спавнов ТЧ в эти форматы вам потребуется положить в папку с acdc
папку levels из игры. Необязательно копировать все файлы, достаточно оставить в папке с каждой локацией
файл level.gct.

-version <new_version> - новая версия спавна. Подобрать версию вы сможете, посмотрев файл spawn_versions.txt
common_options - общие опции. Читайте про них ниже.

Также поддерживается тонкая настройка конвертации через файл convert.ini.
В файле есть две секции: [exclude] и [change]. В секции exclude можно прописать те секции,
которые надо удалить из спавна при конвертации. Пример:

[exclude]
sections = m_trader, m_car, flesh_weak

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

[change]
sections = inventory_box

Далее заполняете файл записями для тех секций, которые вы прописали в change. Пример:

[inventory_box] //section_name нужной секции
add:custom_data = PREVED //префикс add используется для тех параметров, в которые нужно добавить
add:game_vertex_id = 10000 //необходимое значение (если число - складывается, если строка - добавляется в конец)
rep:level_vertex_id = 0 //префикс rep используется для параметров, которые необходимо заменить на что-то

Общий пример. Следующий конфиг приведет к тому, что у всех сталкеров прибавится 500 к гейм-вертексу и
визуал сменится на визуал вояки в противогазе:

[exclude]

[change]
sections = stalker

[stalker]
add:game_vertex_id = 500
rep:visual_name = actors/soldier/soldier_antigas.ogf

Массовая замена вертексов (Показать)

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

Команда: acdc -parse <file> -old <old_gvid0> -new <new_gvid0> [-way] [common_options]

-parse <file> - имя ltx, в котором находится спавн.
-old <old_gvid0> - старый начальный game_vertex_id локации.
-new <new_gvid0> - новый начальный game_vertex_id локации.
-way - обрабатывает также файл way_***.ltx для этой же локации.

Пример: acdc -parse alife_l01_escape.ltx -old 0 -new 934

Разбивка all.spawn на level.spawn (Показать)

Разбивка all.spawn на level.spawn может быть полезна при одновременной правке спавна в СДК и с помощью ACDC.

Команда: acdc -split <file> [-use_graph] [-way] [common_options]

-split <file> - разбиваемый спавн. Для восстановления граф-поинтов необходимы level.spawn для всех локаций,
находящихся в графе. Их следует поместить в папку levels согласно их положению в геймдате сталкера - по папкам,
соответствующим локациям. Папка levels должна быть в папке с acdc (или путь до нее можно задать ключом - читайте далее).
-use_graph - использование game.graph для восстановления граф-поинтов. Плюс - не нужны level.spawn, минус -
не восстанавливаются имена граф-поинтов (за исключением граф-поинтов переходов).
-way - также из спавна генерируются level.game

Сравнение файлов распакованного спавна (Показать)

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

Команда:  acdc -compare <file1,file2> [common_options]

-compare <file1,file2> - файлы для сравнения

Обновление вертексов по координатам (Показать)

Зачем нужно: при изменении аи-сетки у объектов изменяются game_vertex_id и level_vertex_id.
Это влечет за собой необходимость повторного снятия данных параметров в игре. Данный режим
позволяет автоматически обновить вертексы у всех секций спавна.

Команда: universal_acdc -update <spawn_name> [common_options]

-update <spawn_name> - all.spawn, для которого надо обновить вертексы.

Режим update требует дополнительной настройки. В папке с acdc есть файл fs_vertex.ltx
В этот файл необходимо вписать путь до локаций с ОБНОВЛЕННОЙ аи-сеткой. Обязательно
должны присутствовать файлы level.ai, level.gct для всех локаций из спавна.
ВНИМАНИЕ! Для нормальной отработки режима геймграф должен быть СТАРЫЙ, использовавшийся
до перекомпиляции. После нормальной отработки режима спавн можно распаковывать уже с НОВЫМ геймграфом.

Общие опции (Показать)

Важные замечания (Показать)

История версий (Показать)

1.38:
[!] добавлена поддержка релизного спавна Lost Alpha
[!] исправлена конвертация и конвертация
1.37:
[+] добавлена распаковка и запаковка спавна билда Lost Alpha
[!] все не распознанные пути при сплите теперь сваливаются в unrecognized_ways.game
1.36:
[!] исправлена разбивка спавна на level.spawn и level.game
[!] исправлено сканирование конфигов
1.35:
[!] исправлено автоназначение версии при отсутствии этого параметра в секции
[!] убрано чтение game.graph при компиляции
1.34:
[!] исправлено обновление вертексов
[+] добавлено обновление параметра distance при обновлении вертексов
[+] добавлен контроль уникальности story_id при компиляции
1.33:
[!] исправлена распаковка спавнов некоторых билдов
[+] добавлен режим обновления вертексов
[+] добавлен "умный" разбор way-объектов по локациям для режима split
1.322:
[+] добавлено сравнение распакованных файлов
1.321:
[!] исправлена распаковка спавнов ЗП
1.32:
[!] guids.ltx больше не нужен без ключа -idx
[+] реализована сортировка way-объектов по алфавиту
[+] реализовано определение принадлежности way-секции к локации по gvid и префиксу
[+] реализована сортировка alife-объектов
1.31:
[!] изменен алгоритм сканирования конфигов
[!] изменен приоритет запросов из clsids.ini, теперь данные из него перекрывают внутренние таблицы
[!] скрипт адаптирован под новую систему отладочных сообщений
[f] поправлена логика работы с пакетом актора в ЧН
[+] добавлена возможность вынесения лога в файл
[+] добавлена возможность вынесения сетов в отдельный конфиг-файл
1.30:
[f] теперь новая версия обработчика ошибок по-прежнему обрабатывает спавн Народной солянки
[f] исправлены проблемы распаковки level.spawn некоторых билдов
1.29:
[f] исправлена ошибка распаковки level.spawn билдов
[f] исправлена ошибка распаковки спавна ЧН
[f] всякие мелкие правки
1.28:
[f] исправлено игнорирование парсером ключа -way в режиме split.
[f] исправлена ошибка сканирования конфигов при компиляции.
[f] исправлена ошибка чтения секций некоторых se-классов.
[f] исправлена ошибка разбивки спавна, из-за которой генерировались левел спавны неправильного формата.
[+] добавлен контроль дубликатов актора при компиляции.

1.27:
[f] исправлена ошибка парсера, в некоторых случаях приводившая к порче логики.
[f] исправлено создание папок при сохранении результата.
[+] добавлена переинициализация параметров секции после смены класса при конвертации. Это расширяет диапазон
версий, доступных для конвертирования.
[+] добавлена поддержка масок при конвертации.
[+] добавлен ключ -ini в режиме конвертации

1.26:
[f] поправлена распаковка спавнов ЧН.
[+] добавлено автоматическое заполнение версии спавна из первой секции (если актора в спавне нет).
[+] что-то еще по мелочи, не помню.

1.25:
[f] отключен вывод пустого параметра spawned_obj при распаковке.
[+] реализовано автоматическое заполнение параметров version и script_version
при запаковке спавнов с секциями из разных версий игры. Версия берется из конфига актора.

1.24:
[f] исправлена распаковка/запаковка спавна билда 2571.
[f] исправлена запись guids.ltx
[f] мелкие правки

1.23b:
[+] убрано предупреждение "state data left" при распаковке спавнов ЗП, запакованных
ранее с помощью acdccop.
[f] исправлены ошибки split, из-за которых могли получаться кривые level.spawn
[f] переделана логика чтения/записи пакетов se_stalker/se_monster
[f] мелкие изменения

1.22b:
[+] добавлен ключ -nofatal

1.21b:
[f] исправлены небольшие опечатки в коде.
[f] парсер теперь корректно читает значения с комментариями.

1.2b:
[f] небольшие правки по конвертации.
[+] добавленные в модах соответствия clsid -> серверный класс теперь редактируются
в отдельном конфиге (clsids.ini).
[+] ошибка при встрече незнакомого clsid теперь выдается при распаковки секции
спавна с таким clsid, а не при сканировании конфигов, как раньше.

1.1b:
[+] проверена распаковка билд-спавнов, решена проблема декомпиляции спавнов
билдов 25хх.
[+] добавлен контроль наличия параметра version в секциях распакованного спавна.
[f] исправлено исключение файла со spawn_id объектов при сканировании конфигов.

1.0b:
[+] основательно переработан код, часть скрипта вынесена в отдельные модули.
[f] исправлены все не работавшие функции.
[+] увеличена скорость выполнения кода, уменьшены требования по памяти.

Копирайты (Показать)

Новичкам в редактировании спавна поможет краткая инструкция:

Инструкция по установке и работе с acdc от Artos (Показать)

Чтобы не плодить сторонних папок и все было под рукой для работы и игры - будем работать прямо в рабочей папке с игрой/модом.
Устанавливаем и настраиваем комплект ACDC:

1. Открываем папку 'gamedata\spawns' и в ней создаем папку 'acdc'.

2. В эту папку (acdc) копируем (распаковываем) весь комплект файлов из архива 'Universal ACDC.7z', т.е. в папке должны лежать:
- universal_acdc.pl - перл-скрипт утилиты;
- acdc_decompile.bat - командный файл для распаковки;
- acdc_compile.bat - командный файл для запаковки;
- stkutils - папка со служебными библиотеками утилиты;
... - необязательные или технологические файлы (universal_acdc_readme.txt и т.п.).

4. Выходим опять в папку 'gamedata\spawns' и создаем в ней папку 'unpack' - в этой папке будут находиться файлы распакованного спавна.

5. Открываем командный файл (батник) 'acdc_decompile.bat' и изменяем в нем строку на эту:

universal_acdc.pl -d ../all.spawn -o ../unpack -g ../../ -scan ../../config/

6. Открываем командный файл (батник) 'acdc_compile.bat' и изменяем в нем строку на эту:

universal_acdc.pl -c ../unpack -o ../all.spawn

7. Проверьте, есть ли в папке 'gamedata' файл 'game.graph'.
Если его нет - распакуйте его из пак-файлов (gamedata.db*) оригинальной игры и скопируйте в папку 'gamedata' мода.

8. Важно! Для вашей безопасности скопируйте файл 'all.spawn' в удобное вам место (зарезервируйте) для возможности восстановления исходного файла спавна после возможных ваших ошибок при редактировании.

Все, ваш комплект готов для работы с 'all/spawn'-ом на лету, т.е. вы можете запускать игру и играть, можете распаковывать, редактировать и запаковывать файл спавна.
- Распаковка - запускаете 'acdc_decompile.bat' (см. по пути '\gamedata\spawns\acdc');
- Редактируете в папке 'unpack' (см. по пути '\gamedata\spawns\unpack');
- Запаковка - запускаете 'acdc_compile.bat' (см. по пути '\gamedata\spawns\acdc');
- ... проверяете в игре.

Примечание: Если у вас стоит ОС Windows 7 - возможно потребуется в начало командных строк добавить вызов 'perl':

perl universal_acdc.pl -d ../all.spawn -o ../unpack -g ../../ -scan ../../config/
perl universal_acdc.pl -c ../unpack -o ../all.spawn

Успехов в модмейкерстве! :-)

Ссылки (Показать)

Список проверенных модов, спавн которых распаковывается (Показать)

Внимание! Для повторного сканирования конфигов необходимо удалить файл sections.ini. Или воспользоваться батником acdc_decompile_scan (распаковка).

Перл-скрипты и адаптация (Показать)

Собрал большинство перл-скриптов в кучу и адаптировал их под единую библиотеку модулей stkutils. Написал пару новых скриптов. Итак:

Распаковщики xr-файлов (Показать)

Распаковщики level.* файлов (Показать)

Распаковщики файлов разных форматов (Показать)

Разные скрипты (Показать)

Единая для всех скриптов библиотека модулей (Показать)

Правки и дополнения (Показать)

temakonkin · 13 Апреля 2012

ХОВАН

благодарю! -действиельно не удалил sections.ini!

ХОВАН · 14 Апреля 2012

Стреловидный, ACDC не нашел папки all/ с распакованным all.spawn

Цитата
Команда: universal_acdc.pl -compile <dir> [-idx <index_file>] [-f <flag1,flag2,...>] [common_options]
-compile <dir> - папка, в которой лежит распакованный спавн. Если работаете в текущей папке, <dir> не нужно.

Изменено 14 Апреля 2012 пользователем ХОВАН

Стреловидный · 15 Апреля 2012

ХОВАН

олл лежит в папке с асдс. Вроде бы

Цитата
Если работаете в текущей папке, <dir> не нужно.

Или я что-то не так понял?

buka.stalker · 18 Апреля 2012

Приветствую всех.

Я пытаюсь подключить Промзону и МГ от Бандероса.

С помощью graph recompiler v.0.6 добавил эти локи в гейм.граф, обновиг левел.гтк в локах. Прописал секции алайфа и изменил кол-ко лок в [header] файла all.

Для теста спавню ГГ на новой Промзоне. При начале новой игры вылет:

Expression : !(i->used_ai_locations()) || (i->m_tNodeID != u32(-1))

Function : CALifeSimulatorBase::create

File : D:\xray-svn\xr_3da\xrGame\alife_simulator_base.cpp

Line : 193

Description : Invalid vertex for object

Arguments : promz_dog_les

Неверный вертекс. Как быть? Не переписавать же вертексы ВСЕХ объектов в алайфе локи...

KD87 · 18 Апреля 2012

buka.stalker, именно переписывать. Благо давно есть утилиты для этого. Чего там, даже acdc это умеет. См. parse.

Стреловидный, полный лог приведи.

buka.stalker · 18 Апреля 2012

Вопрос по graph recompiler v.0.6.

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

А левел.гтк в подключаемых уровнях изменяться разве не должен?

Scavenger · 18 Апреля 2012

Подключив к финалке с помощью game.graph recompiler 0.6 Мёртвый город из 2571, обнаружил такие странности - какой-то перехлёст графов что-ли... Курсор ГГ перескакивает то на Склады, то на Радар. Сейвы, сделанные в МГ, ведут себя соответствующе - сохраняют ГГ то на Складах, то на Радаре... о_0 Щито же делать? =)

Изменено 18 Апреля 2012 пользователем Scavenger

Стреловидный · 22 Апреля 2012

KD87

FATAL ERROR!

Function: main

Line: 1200

Expression:

Description: cannot open all

Такая вот фигня прилетает :fie:

Comador · 23 Апреля 2012

Стреловидный, тебе же сказали, что батник ругается на не существующую папку all. Убери с батника "ссылку" на эту папку.

Стреловидный · 28 Апреля 2012

Comador

1) Папка all существует, в ней лежит распакованный спавн

2)Даже если меняю в батнике -compile all на -compile , ничего не меняется, тот же самый вылет, только с Description: cannot open

buka.stalker · 29 Апреля 2012

Нужно конвертировать спавн 1.0003 до версии 1.0004. В описании сказано: "Подобрать версию вы сможете, посмотрев файл spawn_versions.txt".

Где ж брать этот spawn_versions.txt? В папке с прогой его нет.

ХОВАН · 29 Апреля 2012

buka.stalker, Это есть в моем "Хелп для версии 1.27 от XOBAH" что лежит в шапке. Смотреть в "Доп. информация" - "Версии spawn-файлов"

И еще, SHOC 1.00003 от SHOC 1.00004 ничем не отличаются (структурно), поэтому конвертировать нечего

Стреловидный, Покажи скрин каталога и полный текст батника на компилирование приведи

*Shoker* · 30 Апреля 2012

Кто нибудь знает как правильно расшифровать object_flags? (object_flags = 0xffffff3a)

Нашёл это http://www.amk-team.ru/forum/index.php?act...&pid=692030 но далеко не продвинулся.

Появилось необходимость поменять некоторые флажки.

Malandrinus · 30 Апреля 2012

*Shoker*,

Цитата
Кто нибудь знает как правильно расшифровать object_flags?

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

Изменено 30 Апреля 2012 пользователем malandrinus

Стреловидный · 2 Мая 2012

ХОВАН

Вот скрин каталога

Вот полный текст батника

батник (Показать)

universal_acdc.pl -compile all  -out new.spawn -scan config\ -nofatal
pause

Изменено 2 Мая 2012 пользователем Стреловидный

ХОВАН · 2 Мая 2012

Стреловидный, Удали "-scan config\". Параметр -scan используется только при декомпиляции

Пример:

PERL universal_acdc.pl -compile all -out new.spawn -nofatal
PAUSE

VEX · 3 Мая 2012

Подскажите в чём проблема,разбил all.spawn от билда 2571на level.spaw(ны),все прошло успешно.Беру из папок с уровнями level.spawn пытаюсь декомпилировать,вылетает ошибка:

+ (Показать)

Изменено 3 Мая 2012 пользователем VEX

KD87 · 4 Мая 2012

ХОВАН, -scan может использоваться когда угодно.

Стреловидный, а дай еще скрин содержимого папки all.

VEX, это баг скрипта, про это уже писали. Может быть, выпущу исправление на праздники.

Scavenger, buka.stalker, есть версия 0.7, лучше использовать ее. Где-то в этой теме была ссылка.

ХОВАН · 4 Мая 2012

KD87, Не соглашусь. Я сам пробовал, распаковал all.spawn ЗП в папку all. Пробую закомпилировать без ключа:

PERL universal_acdc.pl -compile all -out new.spawn -nofatal
PAUSE

Все отлично компилируется, но пробую добавить -scan, как уже получаю вылет о ненахождении all:

PERL universal_acdc.pl -compile all -out new.spawn -scan ../configs -nofatal
PAUSE

Вот наглядный пример исполнения батника, первое выполнение - с ключом -scan, второе - без

Стреловидный · 4 Мая 2012

KD87

Папка all (Показать)

Войти

Universal ACDC и другие perl-скрипты

Рекомендуемые сообщения

KD87 719

Ссылка на комментарий

temakonkin 0

Ссылка на комментарий

ХОВАН 3

Ссылка на комментарий

Стреловидный 0

Ссылка на комментарий

buka.stalker 1

Ссылка на комментарий

KD87 719

Ссылка на комментарий

buka.stalker 1

Ссылка на комментарий

Scavenger 0

Ссылка на комментарий

Стреловидный 0

Ссылка на комментарий

Comador 204

Ссылка на комментарий

Стреловидный 0

Ссылка на комментарий

buka.stalker 1

Ссылка на комментарий

ХОВАН 3

Ссылка на комментарий

*Shoker* 322

Ссылка на комментарий

Malandrinus 615

Ссылка на комментарий

Стреловидный 0

Ссылка на комментарий

ХОВАН 3

Ссылка на комментарий

VEX 23

Ссылка на комментарий

KD87 719

Ссылка на комментарий

ХОВАН 3

Ссылка на комментарий

Стреловидный 0

Ссылка на комментарий

Создайте аккаунт или авторизуйтесь, чтобы оставить комментарий

Создать аккаунт

Войти

Недавно просматривали 0 пользователей

Куратор(ы) темы:

AMK Склад

Shoker 322