HZ Scripts

HZ-Loading

HZ-Loading es un creador de loading screen para FiveM. La pantalla de carga es una aplicación React servida por tu servidor — y se edita dentro del juego, desde el panel de administración hz_lib, en un editor de dos paneles con vista previa en vivo de la pantalla real.

Sin archivo de configuración, sin reinicio. Todo se ajusta en /hzpanel y se pública con un clic. La nueva pantalla queda activa para todos los que se conecten a partir de ese momento.

Qué hace

  • El Loading Creator — un function Object() { [native code] } WYSIWYG dentro de tu panel. Colocación libre con arrastrar y soltar e imantado a una rejilla, y en el panel derecho corre el loading screen real, no una maqueta.
  • Progreso real — conectado a los eventos de streaming de FXServer (fases init / map / run, archivo actual, porcentaje verdadero), no una animación CSS con temporizador.
  • Datos del servidor en vivo — contador de jugadores, slots y uptime enviados por tu propio servidor y entregados por el handshake de conexión, así que son correctos para un jugador que todavía se está conectando.
  • Planificador de escenas — superposiciones de configuración programadas por cron: un skin de Halloween del 25 al 31 de octubre, un aviso de mantenimiento los martes, un fin de semana promocional.
  • Fondos — lista de imágenes con fundido, archivo de vídeo, un vídeo web incrustado o fondo animado generativo, con efectos de oscurecimiento, escala de grises, saturación, contraste y scanlines.
  • Reproductor de música — lista, aleatorio, saltar pista, volumen, silencio, con preferencias por jugador que se conservan entre conexiones.
  • Paneles de contenido — Novedades y Normas en Markdown (las Normas con búsqueda de texto completo), una rejilla de equipo y un ticker de consejos rotativo.
  • Tablero de teclas — el teclado físico dibujado con tus teclas asignadas iluminadas, y un selector QWERTY / AZERTY.
  • 7 idiomas — inglés, francés, español, alemán, portugués, turco, italiano, con el contenido de ejemplo integrado también traducido.

Cómo encaja todo

/hzpanel → Loading Creator          (el admin edita, vista previa en un iframe)
      ↓  Publicar
data/hz_loading.json                (el documento del Creator, en el servidor)
      ↓  superpuesto a la config del panel + la escena activa
getConfig()
      ↓
deferrals.handover  →  el loading screen del jugador que se conecta
data/effective.json →  instantánea de respaldo, leída por nui://

El loading screen recibe su configuración a través del handshake de conexión — nunca la pide. Durante la ventana de carga, HZ-Loading es el único recurso que corre en el cliente y los eventos de red aún no están enrutados: una ida y vuelta de petición y respuesta se quedaría a menudo sin respuesta.

Requisitos

  • hz_lib — obligatorio. Aporta el panel de administración, los permisos de rol y la cascada de apariencia.
  • Standalone — no hace falta ningún framework. Convive con ESX, QBCore, QBox o cualquier otro.
  • Cualquier build reciente de FXServer.

Continuar