Carro addon do FiveM não aparece? Erros comuns e como achá-los

Você adicionou um carro, reiniciou, digitou o nome de spawn e nada. Ou ele aparece sem texturas, ou dirige exatamente como outro carro. Um carro addon são alguns arquivos que precisam apontar uns para os outros pelo nome, e um nome errado basta para quebrar tudo.

Do que é feito um carro addon

• stream/: o modelo (<name>.yft, e <name>_hi.yft para ver de perto) e as texturas dele (<name>.ytd).
• Os metas: vehicles.meta (o carro em si), handling.meta, carvariations.meta (cores, kits, liveries) e muitas vezes carcols.meta (sirenes, luzes, kits de modificação).
• O fxmanifest, que lista os metas em files e carrega cada um com a linha 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'

Os erros comuns

• Sem fxmanifest.lua (nem um __resource.lua antigo, ou ele se chama .off): o FiveM não carrega a pasta de jeito nenhum.
• Uma linha data_file apontando para um arquivo que não existe, ou um meta na pasta que nenhum data_file carrega.
• Sem bloco files { }: os metas precisam estar listados ali, ou os jogadores podem nunca recebê-los.
• modelName que não bate com o .yft. O nome de spawn é o nome do modelo; um arquivo com outro nome nunca é encontrado.
• txdName que não bate com o .ytd: o carro aparece sem textura.
• handlingId que não existe em nenhum handling.meta, nem o do pack nem o do jogo.
• Um id de sirene ou nome de kit de modificação no carvariations.meta que nada define: sem sirenes, ou sem peças de tuning.
• Dois arquivos com o mesmo nome na pasta stream: só um é usado.

Nomes com mais de 11 caracteres são outra armadilha: o jogo corta ali um gameName, e alguns scripts fazem o mesmo com o nome do modelo.

Ache em segundos

Arraste a pasta de recursos do carro para o Vehicle Pack Check. Ele roda no seu navegador (nada é enviado) e confere tudo isso contra os handlings, sirenes e kits de modificação do jogo, depois lista o que encontrou, com os erros primeiro: "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"…

Erros impedem um carro de carregar ou de funcionar: corrija-os primeiro. Avisos são coisas que funcionam mas parecem erradas, como um _hi.yft faltando (o carro usa o modelo normal de perto) ou um arquivo transmitido com mais de 16 MB.

Só tem o .yft e o .ytd?

Se o carro veio como um .yft e um .ytd soltos, sem metas, o Vehicle Addon Builder os escreve. Arraste o modelo, escolha o carro do jogo mais parecido como modelo (sugerido por tamanho, rodas e tipo), defina o nome de spawn (até 11 caracteres) e o nome mostrado no jogo, ajuste massa, velocidade, frenagem e aderência se quiser, e baixe um recurso pronto com os metas, as linhas data_file e um README. Ele também confere o modelo: sem assento para o motorista, sem colisão, rodas invisíveis.

Depois, dê ensure, reinicie e spawne o carro pelo nome de spawn (com o comando do seu framework, como /car <name> no ESX, ou pelo txAdmin).

Perguntas

Ele spawna mas sem texturas. Por quê?

O txdName dele no vehicles.meta não bate com nenhum .ytd da pasta stream. Para as partes que continuam brancas, veja por que as texturas do FiveM ficam brancas ou roxas.

Preciso do carcols.meta?

Só para sirenes, luzes ou kits de modificação próprios do carro. Sem ele, o carro usa o que o carvariations.meta dele aponta.

A ferramenta para isso

Vehicle Pack Check

Arraste a pasta de recursos do seu veículo: metas faltando, nomes errados e erros de stream, com os erros primeiro e o que corrigir.

Abrir Vehicle Pack Check

Também útil aqui: Vehicle Addon Builder