Instale cada mapa ou veículo como um recurso independente, mantenha sua estrutura original, declare apenas os arquivos de dados de que precisa e prove-o em staging antes da produção. Mapas e veículos compartilham o mesmo ciclo de vida de recursos, mas seus ativos e etapas de validação diferem.
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.
Escolha o caminho correto
| Recurso | Conteúdo típico | Guia mais aprofundado |
|---|---|---|
| Mapa/MLO | .ymap, .ytyp, modelos, texturas e colisão |
Adicione um FiveM MLO a um servidor |
| Veículo | .yft, .ytd e arquivos meta de veículos documentados |
Siga as notas de instalação atuais do pacote. |
Verificações iniciais comuns
- Verifique o criador, a origem, a licença, a versão e a build do jogo ou o framework compatível.
- Verifique o arquivo com um antivírus e mantenha o pacote original como referência para reverter a instalação.
- Faça backup da configuração e de qualquer recurso que o pacote substitua.
- Extraia para uma pasta de recurso dedicada com
fxmanifest.luana sua raiz. - Leia as dependências e as notas de instalação antes de alterar o manifesto.
Instalar um recurso de mapa
Mantenha juntos os arquivos .ymap, .ytyp, modelos, texturas e colisões fornecidos. Preserve o manifesto do criador. Use this_is_a_map ou uma declaração DLC_ITYP_REQUEST somente quando o pacote e a documentação atual da Cfx.re exigirem; adicionar diretivas sem verificar pode esconder a falha real de empacotamento.
Inicie o recurso em staging, percorra todo o limite, inspecione interiores e colisões, e verifique se há posicionamentos duplicados de mapa ou outro recurso editando a mesma área. Teste à distância e após reconectar, não apenas no ponto de spawn.
Instalar um recurso de veículo
Mantenha os assets de modelos e texturas junto com os arquivos exatos de metadados documentados. Pacotes comuns usam entradas de veículos, handling, variações e cores de carros, mas os tipos corretos de data_file são definidos pelo pacote e pela referência oficial de arquivos de dados. Não cole todas as declarações conhecidas em todos os manifestos de veículos.
Um nome de modelo não garante um comando de spawn. O spawn pertence ao framework instalado, menu de administração ou recurso de veículo. Verifique o nome do modelo configurado e use o comando documentado ou o fluxo da garagem.
Ativar em ordem de dependência
Adicione uma linha ensure resource-name depois das bibliotecas exigidas e antes dos recursos que dependem dele. Reinicie a homologação e inspecione o console do servidor e o F8 do cliente. Resolva arquivos ausentes, manifestos incorretos e nomes duplicados em vez de reiniciar repetidamente.
Teste o recurso completo
- Mapa: posicionamento, portais, colisão, oclusão, iluminação, portas e edições conflitantes de IPL/mapa.
- Veículo: spawn, texturas, assentos, portas, luzes, áudio, dirigibilidade, danos e persistência na garagem.
- Ambos: download com um cliente limpo, reconexão, reinício do servidor, reinício do recurso e saída dos logs.
Isolar conflitos
Desative outros recursos que modificam a mesma área do mapa, nome do modelo ou entrada de metadados e, em seguida, reative-os um por um. Altere apenas uma variável por teste. Renomear uma pasta de recurso não resolve identificadores de ativos conflitantes dentro dela.
Restauração
Remova a nova entrada ensure, restaure os arquivos e a configuração anteriores e reverta as alterações documentadas do banco de dados. Reinicie e repita o trajeto ou fluxo de veículo usado como referência. Mantenha o recurso desativado até reproduzir e corrigir o defeito em homologação.