$ USD
  • $ USD
  • € EUR
  • £ GBP
Como instalar carros personalizados (FiveM)

Como instalar carros personalizados (FiveM)

Este é o guia confiável e prático para instalar carros personalizados em um servidor FiveM—com segurança, corretamente, e com pronto para produção Configurações que você pode copiar e colar. Abordaremos carros adicionais únicos, pacotes multicarros, conversão de DLCs para um jogador e conexão de veículos em lojas ESX/QBCore.


O que você precisa (pré-requisitos)

Melhores práticas opinativas: Agrupe todos os veículos em uma pasta de categoria de recurso como resources/[cars]/.... Isso mantém seu servidor organizado e permite que você ensure [cars] para começar todos os pacotes de uma vez.


Mapa rápido — escolha seu caminho


Instalar um único carro complementar (o caso 90%)

Vamos supor que seu carro se chama elegy e você recebeu arquivos de modelo YFT/YTD e metadados de veículos padrão.

1) Crie a estrutura de recursos

resources/
 [cars]/
 fm_elegy/
 stream/
 elegy.yft
 elegy_hi.yft
 elegy.ytd
 data/
 handling.meta
 vehicles.meta
 carcols.meta
 carvariations.meta
 vehiclelayouts.meta (if provided)
 fxmanifest.lua
 vehicle_names.lua (optional, for in‑game display name)

Regras que economizam horas

  • Não derrubar .asi/.oiv instaladores em um servidor. Somente ativos e metas que podem ser transmitidos.
  • Mantenha os modelos em stream/, metas em data/.
  • Os nomes de arquivos diferenciam maiúsculas de minúsculas no Linux — correspondam exatamente.

2) fxmanifest.lua (copiar e colar)

fx_version 'cerulean'
game 'gta5'

files {
 'data/handling.meta',
 'data/vehicles.meta',
 'data/carcols.meta',
 'data/carvariations.meta',
 'data/vehiclelayouts.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'
data_file 'VEHICLE_LAYOUTS_FILE' 'data/vehiclelayouts.meta'

client_script 'vehicle_names.lua' -- optional

Nota de legado: __resource.lua está obsoleto. Se você deve suporte apenas legado, use este arquivo mínimo:

-- __resource.lua (legacy)
resource_manifest_version '77731fab-63ca-442c-a67b-abc70f28dfa5'

files {
 'data/handling.meta',
 'data/vehicles.meta',
 'data/carcols.meta',
 'data/carvariations.meta',
 'data/vehiclelayouts.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'
data_file 'VEHICLE_LAYOUTS_FILE' 'data/vehiclelayouts.meta'

client_script 'vehicle_names.lua'

3) Opcional vehicle_names.lua

Alguns pacotes não vêm com a etiqueta GXT. Adicione uma para que o carro mostre um nome limpo na interface do usuário.

-- vehicle_names.lua
CreateThread(function()
 -- key must match spawn name in vehicles.meta <gameName>
 AddTextEntry('elegy', 'Elegy RH8 Custom')
end)

4) Inicie o recurso em server.cfg

# Start all cars inside the [cars] group
ensure [cars]

# (or) start this car only
# ensure fm_elegy

Reinicie o servidor ou execute refresh + ensure fm_elegy do console.

Carros amigáveis ao Gabz Lore

5) Encontre o nome do spawn & teste

Abrir data/vehicles.meta e encontre:

<Item type="CHandlingData">
 ...
</Item>
<!-- Look for -->
<modelName>elegy</modelName>
<gameName>elegy</gameName>
  • Seu código de spawn geralmente é o <gameName> ou <modelName> (por exemplo, elegy).
  • Teste com uma ferramenta de administração:
    • vMenu → Gerador de veículos → Complemento → elegy
    • ou use seu comando de administrador (depende do seu menu de administração).

Se aparecer e as rodas, luzes e peças de ajuste estiverem corretas, está pronto.


Converter um DLC para um jogador em um recurso FiveM

Muitos carros “somente SP” vêm como dlc.rpf pacotes. Converta-os assim:

  1. Abrir Aberto IV → navegue até os DLCs dlc.rpf.
  2. Extrair modelos de x64/vehicles.rpf (YFT/YTD) → colocar em stream/.
  3. Extrair metas de common/data/ em data/:
    • handling.meta, vehicles.meta, carcols.meta, carvariations.meta, vehiclelayouts.meta (se presente).
  4. Criar fxmanifest.lua exatamente como mostrado acima.
  5. Inicie o recurso e teste o nome do spawn de <gameName>.

Dica: Se o carro tiver kits de som personalizados (áudio), o pacote pode incluir um .awc roteamento que não funciona no lado do servidor. Prefira pacotes já marcados Pronto para FiveM ou trocar <audioNameHash> para um kit de baunilha.


Recurso multi-carro (lote)

Você pode transmitir muitos carros de um recurso para simplificar o gerenciamento.

Layout de pasta

resources/[cars]/vip_pack/
 stream/
 elegy.yft
 elegy_hi.yft
 elegy.ytd
 supra.yft
 supra_hi.yft
 supra.ytd
 ...
 data/
 handling.meta # merged or per‑car files
 vehicles.meta
 carcols.meta
 carvariations.meta
 fxmanifest.lua

fxmanifest.lua para dados curinga

fx_version 'cerulean'
game 'gta5'

files {
 'data/*.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'

Mesclando metas: Use apenas fusões comprovadamente válidas. Duplicar <initDatas> ou extraviado <kit> entradas em carcols.meta são o motivo #1 para rodas pretas ou extras quebrados.


Conecte-se às lojas de veículos ESX/QBCore

A geração é ótima para testes. Para uma economia real, conecte os carros à sua oficina de estruturas.

QBCore (exemplo de entrada)

adicionar à qb-core/shared/vehicles.lua (ou a configuração da sua loja):

['elegy'] = {
 ['name'] = 'Elegy RH8',
 ['brand'] = 'Annis',
 ['model'] = 'elegy', -- spawn code
 ['price'] = 125000,
 ['category'] = 'sports',
 ['shop'] = 'pdm'
}

ESX (adição rápida de SQL)

Se sua loja lê do banco de dados:

INSERT INTO vehicles (name, label, price, category) VALUES
 ('elegy', 'Elegy RH8', 125000, 'sports');

Garagem e chaves: Emparelhe sua loja com uma loja confiável garagem e chaves do veículo script para que os jogadores mantenham a propriedade durante as reinicializações:

Controle e ajuste do carro: Para controle de janelas/portas/luzes/bancos e imersão de ajuste:


Lista de verificação de desempenho e segurança

A instalação é apenas metade do trabalho.mantenha-o rápido e estável.

  • Orçamentos de textura: Manter .ytd menos de ~16 MB; prefira texturas de 1k a 2k. Reduza as texturas pesadas no OpenIV.
  • LODs do modelo: Garantir que os carros tenham LODs (_hi.yft + base). Falta de LODs → grandes quedas de FPS no tráfego.
  • UVs de rodas/pneus: Rodas pretas geralmente significam falta carcols.meta ou IDs de materiais ruins — conserte a meta antes de culpar o ELS.
  • Conflitos de geração: Se o seu <gameName> corresponde a um veículo vanilla, renomeia modelo e todas as referências de forma consistente.
  • Ordem de transmissão: Não confie em hacks de ordem de carregamento. Coloque todos os metas no mesmo recurso que transmite o modelo.
  • Use Resmon: Após cada instalação, dirija por 1 a 2 minutos e observe resmon para picos. Guia: https://fivemx.com/how-to-use-resmon-in-fivem-optimize-resources/
  • Limpar cache do cliente depois de grandes pacotes se os jogadores reportarem carros invisíveis: https://fivemx.com/how-to-clear-fivem-cache/

Solução de problemas (soluções rápidas)

O carro não aparece

  • Código de spawn incorreto. Aberto vehicles.meta e pegue <gameName>.
  • O recurso não foi iniciado. Verifique txAdmin → Live Console para erros; executar ensure fm_elegy.

As rodas são pretas / pinturas quebradas

  • Ausente carcols.meta/carvariations.meta ou fusões ruins. Adicione novamente os kits e modkits corretos.

O jogo trava ao aparecer

  • Texturas com excesso de peso ou ossos faltando. Reduzir escala .ytd e confirme a base/_hi par existe.

O interior ou os mostradores não funcionam

Os nomes aparecem como NULL

  • Adicionar um vehicle_names.lua com AddTextEntry('SPAWN', 'Nice Name').

Dica profissional: mantenha os carros organizados

  • Coloque todos os veículos sob [cars] e pacotes de nomes com um prefixo, por exemplo, fm_fm_civ_sports, fm_pd_fleet.
  • Mantenha um simples CHANGELOG.md dentro de cada pacote para você no futuro.
  • Evite misturar ELS pacotes projetados para SP, a menos que o autor forneça uma variante FiveM.

Exemplo: pacote de carros pronto para produção que você pode colocar

Duplique este modelo para cada pacote de carro que você adicionar.

fxmanifest.lua

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'

server.cfg

# FiveM car packs
ensure [cars]

data/vehicles.meta (trecho mínimo apenas para mostrar onde o nome do spawn está)

<CVehicleModelInfo__InitDataList>
 <initDatas>
 <Item>
 <modelName>elegy</modelName>
 <txdName>elegy</txdName>
 <handlingId>elegy</handlingId>
 <gameName>elegy</gameName>
 <vehicleMakeName>ANNIS</vehicleMakeName>
 <plateType>VPT_DEFAULT</plateType>
 <vehicleClass>VC_SPORT</vehicleClass>
 <flags>440010</flags>
 </Item>
 </initDatas>
</CVehicleModelInfo__InitDataList>

vehicle_names.lua (opcional)

CreateThread(function()
 AddTextEntry('elegy', 'Elegy RH8')
end)

Transforme instalações em conteúdo e retenção (próximas etapas)


Perguntas frequentes

Isso funciona com OneSync e servidores grandes?
Sim, veículos transmitidos são a norma. Mantenha os tamanhos de textura sensatos e observe resmon.

Onde posso obter carros de alta qualidade?
De criadores que enviam pacotes prontos para FiveM — ou explore nosso catálogo selecionado: https://fivemx.com/fivem-cars/.

Posso agrupar frotas policiais/civis?
Sim. Organizar por função (fm_pd_fleet, fm_civ_sports) para que você possa habilitar/desabilitar pacotes rapidamente.

Preciso definir uma versão específica do jogo?
Somente se o mod depender de recursos mais recentes. O autor geralmente menciona isso. Se algo aparecer com defeito, teste em uma versão mais recente e tente novamente.


Resumo de copiar e colar (lista de verificação)

  1. Criar resources/[cars]/<pack>/ com stream/ + data/.
  2. Solte YFT/YTD em stream/; metas em data/.
  3. Adicionar fxmanifest.lua com files { ... } + data_file ... linhas.
  4. ensure [cars] (ou o pacote) em server.cfg.
  5. Encontrar <gameName> em vehicles.meta e gerar via vMenu/admin.
  6. Fio para loja (ESX SQL ou QBCore mesa) e emparelhar com garagem/chaves.
  7. Teste Resmon, verificação do orçamento de textura e pronto.

Está tudo pronto. Se você quiser um caminho ainda mais rápido, pegue um pacote de servidor pré-fabricado e comece a personalizar: https://fivemx.com/fivem-servers/

Pacotes de carros pagos

Produtos por categoria

Veículos adicionais versus substitutos

Um veículo adicional introduz um modelo de spawn separado e mantém o veículo original GTA intacto. Um veículo substituto reutiliza um nome de modelo existente e substitui esse veículo base. Prefira adicionais quando quiser vários veículos personalizados sem alterar a frota padrão; use substitutos apenas quando a substituição desse modelo base exato for intencional.

Verificações seguras de pacotes e pastas

  • Mantenha os recursos do veículo agrupados em uma pasta, como resources/[cars]/, mas comece cada recurso real ou use ensure [cars] apenas após verificar se o servidor resolve o grupo corretamente.
  • Inspecione os arquivos de modelo fornecidos fxmanifest.lua, os arquivos de modelo transmitidos e todo arquivo de metadados referenciado. Não substitua um manifesto funcional por um modelo genérico sem comparar seus arquivos declarados e tipos de dados.
  • Verifique os nomes do modelo e do spawn, o caso do nome do arquivo e as referências de metadados para duplicatas antes de combinar pacotes. Uma colisão de nomes pode carregar o veículo errado mesmo quando o recurso começa sem um erro óbvio.
  • Adicione um recurso de cada vez, reinicie no estágio, spawn em cada modelo adicionado e inspecione os consoles do servidor e do cliente. Desfaça o último recurso se os modelos, texturas, manipulação ou entradas da loja falharem.