Аддон-машина в FiveM не спавнится? Частые ошибки и как их найти

Вы добавили машину, перезапустили, ввели имя спавна и ничего не произошло. Или она спавнится без текстур, или едет точно как другая машина. Аддон-машина — это горсть файлов, которые должны указывать друг на друга по имени, и одного неверного имени достаточно.

Из чего состоит аддон-машина

• stream/: модель (<name>.yft, а вблизи <name>_hi.yft) и её текстуры (<name>.ytd).
• Меты: vehicles.meta (сама машина), handling.meta, carvariations.meta (цвета, модкиты, livery) и часто carcols.meta (сирены, огни, модкиты).
• fxmanifest, который перечисляет меты в files и загружает каждую строкой data_file.

files {
  'data/vehicles.meta',
  'data/handling.meta',
  'data/carvariations.meta',
}

data_file 'HANDLING_FILE' 'data/handling.meta'
data_file 'VEHICLE_METADATA_FILE' 'data/vehicles.meta'
data_file 'VEHICLE_VARIATION_FILE' 'data/carvariations.meta'

Частые ошибки

• Нет fxmanifest.lua (и старого __resource.lua тоже нет, или файл всё ещё называется с .off): FiveM вообще не загружает папку.
• Строка data_file, указывающая на файл, которого нет, или мета в папке, которую никакая строка data_file не загружает.
• Нет блока files { }: меты должны быть в нём перечислены, иначе игроки могут их никогда не получить.
• modelName, не совпадающий с .yft. Имя спавна — это имя модели; файл с другим именем никогда не будет найден.
• txdName, не совпадающий с .ytd: машина появляется без текстуры.
• handlingId, которого нет ни в одном handling.meta, ни в паке, ни в игре.
• ID сирены или имя модкита в carvariations.meta, которое ничто не определяет: нет сирен или нет деталей тюнинга.
• Два файла с одним именем в папке stream: используется только один.

Имена длиннее 11 символов — ещё одна ловушка: игра обрезает там gameName, а некоторые скрипты делают то же самое с именем модели.

Найдите за секунды

Перетащите папку ресурса машины в Vehicle Pack Check. Он работает в браузере (ничего не загружается) и проверяет всё вышеперечисленное по handling, сиренам и модкитам самой игры, затем перечисляет находки, сначала ошибки: "No fxmanifest.lua", "<model>.yft is not in the folder" (<model>.yft нет в папке), "Its textures, <txd>.ytd, are not in the folder" (его текстур <txd>.ytd нет в папке), "handlingId X is in no handling.meta here or in the game" (handlingId X нет ни в одном handling.meta ни здесь, ни в игре) …

Ошибки не дают машине загрузиться или работать: исправьте их первыми. Предупреждения — это то, что работает, но выглядит неправильно, например отсутствующий _hi.yft (машина вблизи использует обычную модель) или стримируемый файл больше 16 МБ.

Есть только .yft и .ytd?

Если машина пришла как отдельные .yft и .ytd без мета-файлов, Vehicle Addon Builder создаст их. Перетащите модель, выберите ближайшую машину игры как шаблон (подсказывается по размеру, колёсам и типу), задайте имя спавна (до 11 символов) и название, которое видно в игре, при желании подправьте массу, скорость, торможение и сцепление и скачайте готовый ресурс с метами, строками data_file и README. Он также проверяет модель: нет места для водителя, нет коллизии, невидимые колёса.

Затем ensure её, перезапустите и заспавните по имени спавна (командой вашего фреймворка, например /car <имя> на ESX, или через txAdmin).

Вопросы

Спавнится, но без текстур. Почему?

Её txdName в vehicles.meta не совпадает ни с одним .ytd в папке stream. Для частей, которые остаются белыми, см. почему текстуры FiveM белые или фиолетовые.

Нужен ли carcols.meta?

Только для собственных сирен, огней или модкитов машины. Без него машина использует то, на что указывает её carvariations.meta.

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

Vehicle Pack Check

Перетащите папку ресурса машины: отсутствующие меты, неверные имена и ошибки стриминга, ошибки первыми, с тем, что исправить.

Открыть Vehicle Pack Check

Пригодится также: Vehicle Addon Builder