Como Instalar e Testar um HUD FiveM

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

1. 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.
2. 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.
3. 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.
4. 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.