Como converter um mod de carro single-player do GTA 5 em add-on de FiveM

1. Abra o dlc.rpf do mod em uma ferramenta de arquivos RPF e extraia tudo.
2. Crie uma pasta de resource com as subpastas stream e data.
3. Mova os arquivos de modelo e de textura (.yft, .ytd) para stream.
4. Mova os arquivos .meta para data.
5. Escreva o fxmanifest.lua: cada meta em files e em uma linha data_file.
6. Se for um mod replace, renomeie os arquivos e escreva uma entrada no vehicles.meta para o nome novo.
7. Adicione o ensure ao server.cfg, reinicie, dê spawn no carro e leia o console do servidor.

Um carro add-on para single-player vem como um arquivo dlc.rpf que o jogador adiciona à pasta dlcpacks do jogo. Dentro dele estão os mesmos arquivos de que um resource de FiveM precisa, embrulhados na estrutura de DLC do single-player:

dlc.rpf
  content.xml                     list of every file and its type
  setup2.xml                      name and load order of the pack
  data/                           (or common/data/)
    handling.meta
    vehicles.meta
    carcols.meta
    carvariations.meta
  x64/vehicles.rpf                (or x64/levels/gta5/vehicles/...rpf)
    mycar.yft
    mycar_hi.yft
    mycar.ytd

Os nomes das pastas variam de autor para autor. O arquivo que diz o que é o quê é o content.xml: ele lista cada arquivo de dados com um fileType, e esses nomes de tipo são os mesmos que o FiveM usa nas linhas data_file.

<Item>
  <filename>dlc_mycar:/data/vehicles.meta</filename>
  <fileType>VEHICLE_METADATA_FILE</fileType>
</Item>
<Item>
  <filename>dlc_mycar:/data/carvariations.meta</filename>
  <fileType>VEHICLE_VARIATION_FILE</fileType>
</Item>
<Item>
  <filename>dlc_mycar:/%PLATFORM%/vehicles.rpf</filename>
  <fileType>RPF_FILE</fileType>
</Item>

No dlc.rpf	No resource de FiveM
.yft, .ytd dentro do vehicles.rpf	stream/
Modelos das peças de tuning, em um arquivo próprio quando o carro tem	stream/
Arquivos .meta	data/, cada um com uma linha data_file do tipo indicado no content.xml
content.xml, setup2.xml	Não são usados. O fxmanifest.lua faz o trabalho deles.
Text labels (.gxt2)	Não são usados. Adicione o nome com uma linha de script, veja abaixo.

O FiveM não carrega arquivos .rpf de dentro de um resource, então os arquivos têm que sair de lá. Qualquer ferramenta de arquivos do GTA V serve. No CodeWalker, abra o RPF Explorer, use File > Open Folder... na pasta onde está o dlc.rpf, abra o arquivo e os arquivos dentro dele, selecione o que quer e extraia com Extract Raw... ou Extract All.... O OpenIV faz o mesmo trabalho.

Os arquivos RPF ficam um dentro do outro: o dlc.rpf contém o vehicles.rpf, que contém os modelos. Continue abrindo até chegar a arquivos .yft, .ytd e .meta soltos. As duas ferramentas são comparadas em CodeWalker vs Sollumz.

Organize os arquivos extraídos como em qualquer resource de veículo:

resources/
  mycar/
    fxmanifest.lua
    data/
      handling.meta
      vehicles.meta
      carcols.meta
      carvariations.meta
    stream/
      mycar.yft
      mycar_hi.yft
      mycar.ytd

Depois escreva o manifest. Cada meta é listado duas vezes: uma em files, para o servidor enviá-lo aos jogadores, e outra em uma linha data_file, para o jogo carregá-lo como o tipo certo.

fx_version 'cerulean'
game 'gta5'

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

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

fileType no content.xml	Arquivo
HANDLING_FILE	handling.meta
VEHICLE_METADATA_FILE	vehicles.meta
CARCOLS_FILE	carcols.meta
VEHICLE_VARIATION_FILE	carvariations.meta
VEHICLE_LAYOUTS_FILE	vehiclelayouts.meta

A lista completa de tipos e a ordem em que eles carregam está em fxmanifest.lua e data_file para veículos. Iniciar o resource e dar spawn está em como adicionar um veículo add-on a um servidor FiveM.

Um mod replace não tem metas nem nome novo. Os arquivos dele têm o nome de um carro original, por exemplo sultan.yft, e o jogo desenha esses arquivos no lugar do original. Enviados por stream a partir de um resource de FiveM eles funcionam do mesmo jeito: todo Sultan do servidor muda. Para manter o carro original e adicionar o seu ao lado dele, dê ao modelo um nome próprio.

1. Renomeie os arquivos. Os nomes dos arquivos são o nome do modelo.

   sultan.yft      ->  mycar.yft
   sultan_hi.yft   ->  mycar_hi.yft
   sultan.ytd      ->  mycar.ytd

   As texturas dentro do .ytd mantêm os nomes delas. O dicionário é encontrado pelo nome do arquivo, não pelo que tem dentro.
2. Escreva uma entrada no vehicles.meta. Copie a entrada do carro substituído do vehicles.meta do próprio jogo e troque modelName e txdName pelo nome novo, mais o gameName para o nome de exibição. Deixe handlingId, layout e audioNameHash como estão e o carro anda, tem os assentos e o som do original. Cada campo é explicado em vehicles.meta explicado.
3. Adicione uma entrada no carvariations.meta com o novo modelName se quiser suas próprias combinações de cores. Veja carvariations e carcols.
4. Dê a ele um handling próprio só se quiser ajustar. Nesse caso copie também a entrada de handling, com um handlingName novo, e aponte o handlingId para ela.

O nome de exibição vem de um text label. No FiveM, uma linha de script de client adiciona o label:

-- client script: readable name for <gameName>MYCAR</gameName>
AddTextEntry('MYCAR', 'My Car GT')

Sintoma	Causa	Onde olhar
O console avisa sobre oversized assets	Mods de single-player costumam vir com texturas de 4096 e uma malha pesada	Como otimizar um veículo de FiveM
Aparecem peças de tuning de outro carro	Dois arquivos carcols.meta usam o mesmo ID de kit	carvariations e carcols
O carro não dá spawn	Um meta está faltando em files ou em data_file, ou um nome não bate	Solução de problemas de veículos
Algumas texturas estão faltando	O mod dependia de um dicionário de texturas compartilhado que estava em outro arquivo	Adicione esse .ytd a stream e mantenha o vínculo de pai em txdRelationships.

Mais uma checagem antes de colocar o mod de outra pessoa em um servidor público: leia os termos do autor. Alguns mods de single-player não permitem redistribuição nem uso em servidores.

Um carro de outro jogo ou um arquivo 3D comum não tem esqueleto, nem shaders do GTA, nem colisão, então não há nada para extrair e reorganizar. Antes ele tem que ser refeito como veículo do GTA em uma ferramenta 3D. Esse processo está em como fazer um veículo de FiveM no Blender com o Sollumz.