Samochód addon w FiveM się nie spawnuje? Typowe błędy i jak je znaleźć

Dodałeś samochód, zrestartowałeś, wpisałeś jego nazwę spawnu i nic. Albo spawnuje się bez tekstur, albo jeździ dokładnie jak inny samochód. Samochód addon to garść plików, które muszą wskazywać na siebie po nazwie, i wystarczy jedna zła nazwa.

Z czego składa się samochód addon

• stream/: model (<name>.yft, a do bliska <name>_hi.yft) i jego tekstury (<name>.ytd).
• Pliki meta: vehicles.meta (sam samochód), handling.meta, carvariations.meta (kolory, zestawy, livery) i często carcols.meta (syreny, światła, zestawy modyfikacji).
• fxmanifest, który wymienia pliki meta w files i wczytuje każdy linią 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'

Typowe błędy

• Brak fxmanifest.lua (także brak starego __resource.lua, albo nadal nazywa się .off): FiveM w ogóle nie wczytuje folderu.
• Linia data_file wskazująca na plik, którego nie ma, albo plik meta w folderze, którego żadna linia data_file nie wczytuje.
• Brak bloku files { }: pliki meta muszą być w nim wymienione, inaczej gracze mogą ich nigdy nie dostać.
• modelName niepasujący do .yft. Nazwa spawnu to nazwa modelu; plik nazwany inaczej nigdy nie zostanie znaleziony.
• txdName niepasujący do .ytd: samochód pojawia się bez tekstury.
• handlingId, którego nie ma w żadnym handling.meta, ani w paczce, ani w grze.
• ID syreny albo nazwa zestawu modyfikacji w carvariations.meta, których nic nie definiuje: brak syren albo brak części tuningu.
• Dwa pliki o tej samej nazwie w folderze stream: używany jest tylko jeden.

Nazwy dłuższe niż 11 znaków to kolejna pułapka: gra tnie tam gameName, a niektóre skrypty robią to samo z nazwą modelu.

Znajdź w kilka sekund

Przeciągnij folder zasobu samochodu do Vehicle Pack Check. Działa w przeglądarce (nic nie jest wysyłane) i sprawdza wszystko powyższe względem handlingów, syren i zestawów modyfikacji gry, a potem wymienia znalezione problemy, najpierw błędy: "No fxmanifest.lua", "<model>.yft is not in the folder" (<model>.yft nie ma w folderze), "Its textures, <txd>.ytd, are not in the folder" (jego tekstur, <txd>.ytd, nie ma w folderze), "handlingId X is in no handling.meta here or in the game" (handlingId X nie ma w żadnym handling.meta, ani tu, ani w grze) …

Błędy uniemożliwiają wczytanie lub działanie samochodu: napraw je najpierw. Ostrzeżenia to rzeczy, które działają, ale wyglądają źle, np. brak _hi.yft (samochód z bliska używa zwykłego modelu) albo streamowany plik powyżej 16 MB.

Masz tylko .yft i .ytd?

Jeśli samochód przyszedł jako luźne .yft i .ytd bez plików meta, Vehicle Addon Builder utworzy je. Przeciągnij model, wybierz najbliższy samochód gry jako szablon (podpowiadany wg rozmiaru, kół i rodzaju), ustaw nazwę spawnu (do 11 znaków) i nazwę widoczną w grze, dostosuj masę, prędkość, hamowanie i przyczepność, jeśli chcesz, i pobierz gotowy zasób z plikami meta, liniami data_file i README. Sprawdza też model: brak miejsca dla kierowcy, brak kolizji, niewidoczne koła.

Potem ensure go, zrestartuj i zespawnuj po nazwie spawnu (komendą twojego frameworka, np. /car <nazwa> na ESX, albo przez txAdmin).

Pytania

Spawnuje się, ale nie ma tekstur. Dlaczego?

Jego txdName w vehicles.meta nie pasuje do żadnego .ytd w folderze stream. Części, które zostają białe, opisuje dlaczego tekstury FiveM są białe lub fioletowe.

Czy potrzebuję carcols.meta?

Tylko dla syren, świateł lub zestawów modyfikacji samego samochodu. Bez niego samochód używa tego, na co wskazuje jego carvariations.meta.

Narzędzie do tego

Vehicle Pack Check

Przeciągnij folder zasobu pojazdu: brakujące pliki meta, złe nazwy i błędy streamingu, najpierw błędy, z informacją, co naprawić.

Otwórz Vehicle Pack Check

Przydatne także tutaj: Vehicle Addon Builder