HZ Scripts

HZ-Loading

O HZ-Loading é um criador de loading screen para FiveM. O ecrã de carregamento é uma aplicação React servida pelo seu servidor — e é editado dentro do jogo, a partir do painel de administração hz_lib, num editor de dois painéis com pré-visualização ao vivo do ecrã real.

Sem ficheiro de configuração, sem reinício. Tudo se define em /hzpanel e publica-se com um clique. O novo ecrã fica ativo para todos os que se ligarem a partir desse momento.

O que faz

  • O Loading Creator — um construtor WYSIWYG dentro do seu painel. Colocação livre com arrastar e largar e alinhamento a uma grelha, e no painel da direita corre o loading screen real, não uma maquete.
  • Progresso real — ligado aos eventos de streaming do FXServer (fases init / map / run, ficheiro atual, percentagem verdadeira), não uma animação CSS com temporizador.
  • Dados do servidor ao vivo — contagem de jogadores, slots e uptime enviados pelo seu próprio servidor e entregues pelo handshake de ligação, portanto corretos para um jogador que ainda se está a ligar.
  • Planeador de cenas — sobreposições de configuração agendadas por cron: um tema de Halloween de 25 a 31 de outubro, um aviso de manutenção às terças, um fim de semana promocional.
  • Fundos — lista de imagens com transição, ficheiro de vídeo, um vídeo web incorporado ou fundo animado generativo, com efeitos de escurecimento, tons de cinzento, saturação, contraste e scanlines.
  • Leitor de música — lista de reprodução, aleatório, saltar faixa, volume, silêncio, com preferências por jogador mantidas entre ligações.
  • Painéis de conteúdo — Novidades e Regras em Markdown (as Regras com pesquisa de texto integral), uma grelha de equipa e um ticker de dicas rotativo.
  • Quadro de teclas — o teclado físico desenhado com as suas teclas atribuídas acesas, e um seletor QWERTY / AZERTY.
  • 7 idiomas — inglês, francês, espanhol, alemão, português, turco, italiano, incluindo o conteúdo de exemplo integrado traduzido.

Como tudo encaixa

/hzpanel → Loading Creator          (o admin edita, pré-visualização num iframe)
      ↓  Publicar
data/hz_loading.json                (o documento do Creator, no servidor)
      ↓  sobreposto à configuração do painel + a cena ativa
getConfig()
      ↓
deferrals.handover  →  o loading screen do jogador que se está a ligar
data/effective.json →  instantâneo de recurso, lido por nui://

O loading screen recebe a sua configuração pelo handshake de ligação — nunca a pede. Durante a janela de carregamento, o HZ-Loading é o único recurso a correr no cliente e os eventos de rede ainda não estão encaminhados: uma ida e volta de pedido e resposta ficaria muitas vezes sem resposta.

Requisitos

  • hz_lib — obrigatório. Fornece o painel de administração, as permissões de função e a cascata de aparência.
  • Standalone — não é preciso qualquer framework. Corre ao lado do ESX, QBCore, QBox ou outro.
  • Qualquer build recente do FXServer.

Continuar