Para instalar um HUD FiveM, confirme seu framework e dependências, adicione sua pasta de recursos, inicie-o após essas dependências e teste os valores exibidos com um jogador normal. Um HUD que aparece na tela ainda precisa de uma verificação de dados e usabilidade.
Verifique a compatibilidade e mantenha um rollback
Leia a documentação do HUD para a versão do framework suportada, inventário, status e recursos de voz. As integrações ESX, QBCore e Qbox não são intercambiáveis, a menos que o criador as suporte explicitamente. Faça backup do HUD atual, da configuração e de quaisquer tabelas de banco de dados que a instalação altere.
Teste em um servidor separado primeiro. Desative o HUD antigo durante o teste para evitar sobreposições duplicadas e lógica de minimapa ou status concorrente.
Instale o recurso
- Extraia o pacote. A pasta de recursos deve conter fxmanifest.lua em sua raiz, em vez de outra cópia aninhada da pasta. Preserve os nomes de pastas documentados.
- Instale as dependências necessárias e configure a integração do framework suportado pelo HUD. Mantenha os segredos fora dos arquivos do cliente e NUI.
- Adicione ensure seguido pelo nome exato da pasta de recursos ao server.cfg após suas dependências. Inicie o servidor de teste e leia o primeiro erro de recurso antes de continuar.
- Entre com uma conta comum. Verifique os valores de saúde, armadura, fome/sede (onde suportado), dinheiro, trabalho e veículo em relação ao estado real do jogo.
Verifique a interface
Teste diferentes resoluções e dimensionamento da interface do usuário, entrando e saindo de veículos, reconectando, mudanças de personagem e um reinício completo do servidor. Confirme que os menus permanecem clicáveis e que o texto importante é legível sem depender apenas da cor. Inspecione os consoles F8 e do servidor em busca de erros.
Encontre a causa de uma falha
Sem interface: verifique o erro de inicialização do recurso, manifesto, caminhos de arquivo NUI e ativos do navegador. Uma interface com valores incorretos aponta para o framework ou integração de status. Elementos sobrepostos sugerem que outro HUD ou recurso de minimapa ainda está em execução.
Restaure o HUD e a configuração antigos se o novo recurso falhar nessas verificações. Restaure um backup do banco de dados apenas quando sua migração alterar dados; coordene isso para que o progresso mais recente do jogador não seja sobrescrito.
Referências oficiais
O manifesto de recursos explica as declarações de script e UI; comandos do servidor documenta o ensure.