Instalação

Dependências

Dependência	Obrigatória	Para quê
hz_lib	Sim	Painel de administração, permissões de função, cascata de aparência
Framework (ESX / QBCore / QBox)	Não	O HZ-Loading é standalone

O hz_lib é uma dependência dura declarada no manifest. Se faltar, o HZ-Loading recusa arrancar em vez de iniciar num estado partido.

Passos

Coloque a pasta hz_loading no seu diretório resources.
No seu server.cfg, garanta que o hz_lib arranca primeiro:

ensure hz_lib
ensure hz_loading

Reinicie o servidor (um recurso de loading screen não pode ser arrancado a quente de forma útil — só corre enquanto um jogador se liga).
Volte a ligar-se.

É tudo. Não há passo de compilação — a interface é entregue já compilada, por isso nada de Node.js nem de npm install.

O que deve ver

Um loading screen completo em inglês: imagens de fundo, uma faixa musical, uma barra de progresso real, uma contagem de jogadores ao vivo e o conteúdo de exemplo de Novidades / Regras / dicas no seu idioma.

Esse valor por omissão é deliberadamente publicável tal como está. Pode deixá-lo assim e depois abrir o Loading Creator para o tornar seu.

Confirmar que funciona

O loading screen é, por natureza, difícil de inspecionar — já desapareceu quando consegue escrever um comando. Duas verificações fiáveis:

Veja a consola do servidor no arranque. O HZ-Loading escreve os assets detetados, por exemplo

[hz_loading] assets : 3 audio, 7 images (manifest 3/7 + scan 3/7).

Execute /hzloading:diag uma vez no jogo (admin). Relata a configuração efetiva e os tempos de arranque das sessões recentes.

«Your Server» com uma contagem 0 / – significa que o payload de arranque nunca chegou — não que a sua configuração esteja errada. É um problema de entrega (hz_lib em falta, ou arrancado depois do HZ-Loading), não de definições. Verifique primeiro a ordem no seu server.cfg.

Permissões

O acesso ao painel e o direito de publicar são geridos pelas funções do hz_lib. Publicar o loading screen exige a permissão config sobre o HZ-Loading, distinta do acesso geral ao painel — pode assim deixar um moderador editar o loading screen sem o tornar administrador global. Ver Comandos e permissões.