Auto addon FiveM non appare? Errori comuni e come trovarli

Hai aggiunto un'auto, hai riavviato, hai digitato il suo nome di spawn, e niente. Oppure appare senza texture, o guida esattamente come un'altra auto. Un'auto addon sono alcuni file che devono puntarsi a vicenda per nome, e basta un nome sbagliato per rompere tutto.

Di cosa è fatta un'auto addon

• stream/: il modello (<name>.yft, e <name>_hi.yft per vederlo da vicino) e le sue texture (<name>.ytd).
• I meta: vehicles.meta (l'auto stessa), handling.meta, carvariations.meta (colori, kit, livery) e spesso carcols.meta (sirene, luci, kit di modifica).
• Il fxmanifest, che elenca i meta in files e carica ciascuno con la sua riga 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'

Gli errori comuni

• Nessun fxmanifest.lua (né un vecchio __resource.lua, o è chiamato .off): FiveM non carica affatto la cartella.
• Una riga data_file che punta a un file che non c'è, o un meta nella cartella che nessun data_file carica.
• Nessun blocco files { }: i meta devono essere elencati lì, altrimenti i giocatori potrebbero non riceverli mai.
• Un modelName che non corrisponde al .yft. Il nome di spawn è il nome del modello; un file chiamato diversamente non viene mai trovato.
• Un txdName che non corrisponde al .ytd: l'auto appare senza texture.
• Un handlingId che non è in nessun handling.meta, né quello del pack né quello del gioco.
• Un id di sirena o un nome di kit di modifica in carvariations.meta che nulla definisce: nessuna sirena, o nessun pezzo di tuning.
• Due file con lo stesso nome nella cartella stream: ne viene usato solo uno.

I nomi di più di 11 caratteri sono un'altra trappola: il gioco taglia lì un gameName, e alcuni script fanno lo stesso con il nome del modello.

Trovalo in pochi secondi

Trascina la cartella della risorsa dell'auto nel Vehicle Pack Check. Gira nel tuo browser (non viene caricato nulla) e controlla tutto quanto sopra contro gli handling, le sirene e i kit di modifica del gioco, poi elenca ciò che trova, prima gli errori: "No fxmanifest.lua", "<model>.yft is not in the folder", "Its textures, <txd>.ytd, are not in the folder", "handlingId X is in no handling.meta here or in the game"…

Gli errori impediscono a un'auto di caricarsi o di funzionare: sistemali per primi. Gli avvisi sono cose che funzionano ma sembrano sbagliate, come un _hi.yft mancante (l'auto usa il suo modello normale da vicino) o un file trasmesso oltre 16 MB.

Hai solo il .yft e il .ytd?

Se l'auto è arrivata come un .yft e un .ytd sciolti, senza meta, il Vehicle Addon Builder li scrive. Trascina il modello, scegli l'auto del gioco più vicina come modello (suggerita per dimensione, ruote e tipo), imposta il suo nome di spawn (fino a 11 caratteri) e il nome mostrato nel gioco, regola massa, velocità, frenata e aderenza se vuoi, e scarica una risorsa pronta con i meta, le righe data_file e un README. Controlla anche il modello: nessun sedile per il guidatore, nessuna collisione, ruote invisibili.

Poi metti ensure, riavvia e spawna l'auto con il suo nome di spawn (con il comando del tuo framework, come /car <name> su ESX, o da txAdmin).

Domande

Appare ma senza texture. Perché?

Il suo txdName in vehicles.meta non corrisponde a nessun .ytd della cartella stream. Per le parti che restano bianche, vedi perché le texture FiveM sono bianche o viola.

Mi serve carcols.meta?

Solo per sirene, luci o kit di modifica propri dell'auto. Senza, l'auto usa ciò che indica il suo carvariations.meta.

Lo strumento per questo

Vehicle Pack Check

Trascina la cartella della risorsa del tuo veicolo: meta mancanti, nomi sbagliati ed errori di stream, con gli errori per primi e cosa correggere.

Apri Vehicle Pack Check

Utile anche qui: Vehicle Addon Builder