Как объединить паки машин FiveM в один ресурс без поломок

Пятьдесят ресурсов машин — это пятьдесят папок, за которыми нужно следить, и объединение их в один пак — популярный способ навести порядок на сервере. Если делать это вручную, копируя файлы в одну папку stream и склеивая меты, это ещё и популярный способ сломать машины: меню тюнинга пустеют, сирены меняются местами, машина спавнится как другая.

Что конфликтует при ручном объединении

• Имена файлов. FiveM стримит по имени файла; два пака с .ytd или деталью тюнинга одного имени — загрузится только один.
• Имена спавна. Две машины с одним именем модели: одна пропадает.
• ID сирен, огней и модкитов. Два пака с одним ID перезаписывают друг друга (почему, и что делают ID больше 255).
• Имена модкитов. Пак, определяющий 0_default_modkit, меняет каждую машину игры, которая его использует.
• Имена handling и раскладок, которые должны быть уникальны во всём объединённом паке.
• Отображаемые имена. gameName — не более 11 символов, и имя, копирующее подпись машины игры, показывает название машины игры.
• Большие словари текстур. Один .ytd больше 16 MiB памяти — это то, о чём предупреждает FiveM в сообщении об oversized asset.

Объединяйте пошагово

Откройте Vehicle Pack Merger и перетащите ресурсы машин: их папки или .zip, несколько сразу, или родительскую папку вроде [cars]. Каждая папка с fxmanifest — один пак. Всё выполняется в браузере, кроме разделения .ytd больше 16 MiB.

1. Упорядочьте паки. Первый сохраняет свои ID и имена; более поздний пак, который с ним конфликтует, изменяется.
2. Прочитайте Check these (проверьте это) и What was fixed (что исправлено): каждое изменение по типу (сирены, огни и модкиты; имена; файлы; копии).
3. Отредактируйте список Vehicles (машины): имя, марку, категорию и цену каждой машины для списков магазинов.
4. Назовите ресурс и нажмите Download.

Что именно исправляется: машина, дважды встречающаяся с одним и тем же файлом, сохраняется один раз, а другая машина с тем же именем становится <имя>_2 со своими файлами; конфликтующие stream-файлы, которые упоминает мета-файл (.ytd, деталь тюнинга, клип), переименовываются вместе с тем, на что они указывают, а прочие конфликтующие пропускаются с предупреждением; ID сирен, огней и модкитов переезжают на свободные; имена модкитов, handling и раскладок делаются уникальными; повторяющиеся, пустые или слишком длинные отображаемые имена получают новую подпись; .ytd больше 16 MiB делится на связанные между собой части, каждая текстура сохраняется как была (+hi.ytd и одиночная текстура больше 16 MiB не делятся).

Что вы получаете

Один ресурс: один vehicles.meta, handling.meta, carcols.meta, carvariations.meta, vehiclelayouts.meta и dlctext.meta, файлы каждого пака в stream/<пак>/, fxmanifest со строками data_file по порядку, names.lua для отображаемых имён и merge_report.txt со всеми изменениями. Плюс списки магазинов для qb-core, Qbox, ESX (SQL) и JG Garages. Их цены — заглушки по классу машины: задайте свои.

Остановите старые паки, ensure объединённый и проверьте его последний раз в Vehicle Pack Check.

Ограничения

• Зашифрованные (escrow) паки нельзя объединить.
• Скрипты, которые выходят за рамки назначения имён машинам, копируются в extra/, но не загружаются; звуковые банки переносятся как есть.
• До 10 машин объединяются бесплатно; до 50 с планом Creator, больше с Studio.

Вопросы

Мой тюнинг перестал работать после объединения. Почему?

Два пака использовали один ID модкита или одно имя модкита, поэтому модкит одной машины перезаписал модкит другой. Merger переносит конфликтующие модкиты на свободные ID и имена.

Мои машины куда-то загружаются?

Нет. Объединение происходит в вашем браузере; только .ytd больше 16 MiB отправляется для разделения.

Инструмент для этого

Vehicle Pack Merger

Перетащите паки машин: получится один ресурс с исправленными конфликтующими ID, именами спавна, handling и именами текстур и списками магазинов для вашего фреймворка.

Открыть Vehicle Pack Merger

Пригодится также: Siren ID Check · Vehicle Pack Check