Para instalar um veículo adicional, coloque o recurso FiveM completo na pasta resources do servidor, inicie esse recurso e crie o modelo indicado em vehicles.meta. Teste o veículo antes de adicioná-lo a uma concessionária ou juntá-lo a outros pacotes.
Confirme a edição de GTA de destino antes de instalar ou exportar assets. Pacotes Legacy não estão automaticamente prontos para o Enhanced; siga a orientação oficial de conversão de assets para o Enhanced quando esse for o seu objetivo.
Confira o pacote primeiro
Use um pacote que você tenha permissão para executar e distribuir aos jogadores que se conectarem. Guarde o arquivo compactado original e o README. Um recurso preparado para FiveM normalmente inclui um manifesto e arquivos de modelo, textura e metadados. Um instalador .oiv para o modo de um jogador ou um plugin .asi não é um recurso de servidor.
Um add-on introduz um modelo separado. Uma substituição sobrescreve intencionalmente um nome de modelo existente. Confira qual tipo você tem para não substituir a frota padrão por engano.
1. Instale um recurso
Para um recurso chamado my_vehicle, o manifesto deve estar em resources/[cars]/my_vehicle/fxmanifest.lua, não dentro de uma pasta extra criada na extração. Preserve os caminhos fornecidos e as maiúsculas e minúsculas dos nomes de arquivo. Servidores Linux diferenciam maiúsculas de minúsculas.
Mantenha um manifesto funcional fornecido pelo autor. O exemplo abaixo cobre apenas um pacote cujos quatro arquivos de metadados indicados realmente existem em data/; outros pacotes podem precisar de registros adicionais.
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'Mantenha os modelos .yft e as texturas .ytd fornecidos nos respectivos caminhos de streaming. Se o autor fornecer layouts, áudio ou outros arquivos de dados, preserve as entradas correspondentes no manifest; não as descarte para reproduzir este exemplo.
2. Inicie o recurso
Adicione ensure my_vehicle ao arquivo ativo server.cfg. Em um servidor de desenvolvimento em execução, execute estes dois comandos separadamente no console do FXServer:
refresh
ensure my_vehicleLeia a saída de inicialização. Resolva arquivos ausentes, XML malformado ou erros de dependência antes de criar o carro. Inicie um recurso novo por vez para identificar claramente a origem de uma falha.
3. Use o nome do modelo
Abra vehicles.meta e encontre o modelName do veículo. Esse é o nome do modelo usado para gerar o veículo. gameName é um rótulo de texto exibido e pode ser diferente. Insira o nome do modelo na ferramenta administrativa de geração de veículos que você tem instalada e está autorizado a usar.
Inspecione rodas, luzes, portas, bancos, pinturas, modificações, colisão e comportamento de direção. Teste com outro jogador conectado e após uma reconexão. Um modelo aparecer uma vez não comprova que todos os metadados dele funcionam.
4. Adicione a propriedade e a integração com a loja
Depois que o spawn funcionar, siga a configuração real ou o esquema de banco de dados do recurso de loja de veículos. O nome do framework sozinho não identifica esse esquema. Use o mesmo nome de modelo, a categoria pretendida e um preço escolhido de forma deliberada.
Teste a compra, a atribuição de chaves, o armazenamento na garagem, a retirada e a persistência após reinicialização. Remova os veículos e as compras de teste pelas ferramentas administrativas apropriadas. Faça backup dos dados alterados durante a integração.
Se você tem um DLC de singleplayer
Inspecione o arquivo com a ferramenta de criação adequada e identifique os modelos, as texturas e todas as dependências de metadados. A conversão pode envolver áudio personalizado, layouts e peças de modificação além do exemplo de quatro arquivos. Prefira as instruções FiveM do autor quando disponíveis; extrair dois arquivos de modelo não é uma conversão completa.
Solucione problemas pelo sintoma
Se nada aparecer, verifique a inicialização e modelName. Se aparecer o carro errado, procure conflitos de nomes de modelo entre recursos. Para texturas ou modificações ausentes, compare os metadados e as dependências de streaming com o pacote original. Em caso de falhas, registre o erro exato e teste o veículo sozinho em uma versão compatível do jogo.
Meça o comportamento gráfico e de streaming em uma cena reproduzível com a quantidade esperada de veículos. O tempo dos scripts do cliente no Resmon não mede a geometria do modelo nem o custo das texturas para a GPU. Facilite a reversão mantendo cada pacote testado separado.
Documentação de referência
Cfx.re — manifesto de recurso · Cfx.re — arquivos de dados · Fonte: dexyfex/CodeWalker