HZ Scripts

HZ-Loading

HZ-Loading est un créateur de loading screen pour FiveM. L'écran de chargement lui-même est une application React servie par votre serveur — et il s'édite en jeu, depuis le panel admin HZ-Bridge, dans un éditeur en deux volets qui affiche un aperçu en direct du vrai écran.

Aucun fichier de config, aucun restart. Tout se règle dans /hzpanel et se publie en un clic. Le nouvel écran est actif pour tous ceux qui se connectent à partir de cet instant.

Ce qu'il fait

  • Le Loading Creator — un builder WYSIWYG dans votre panel admin. Placement libre en glisser-déposer avec aimantation, et le volet de droite fait tourner le vrai loading screen, pas une maquette.
  • Vraie progression — branchée sur les événements de streaming de FXServer (phases init / map / run, fichier en cours, pourcentage réel), pas une animation CSS sur un minuteur.
  • Données serveur en direct — compteur de joueurs, slots et uptime poussés par votre propre serveur, livrés par la poignée de main de connexion, donc justes pour un joueur encore en train de se connecter.
  • Planificateur de scènes — des superpositions de config programmées par cron : un skin Halloween du 25 au 31 octobre, une bannière de maintenance le mardi, un week-end promo.
  • Fonds — playlist d'images avec fondu, fichier vidéo, YouTube, ou fond animé génératif, avec effets d'obscurcissement, désaturation, saturation, contraste et scanlines.
  • Lecteur de musique — playlist, aléatoire, saut de piste, volume, sourdine, avec préférences par joueur conservées entre les connexions.
  • Panneaux de contenu — Actualités et Règlement en Markdown (le Règlement dispose d'une recherche plein texte), une grille d'équipe et un bandeau d'astuces rotatif.
  • Tableau des keybinds — le clavier physique dessiné avec vos touches assignées allumées, et un sélecteur QWERTY / AZERTY.
  • 7 langues — anglais, français, espagnol, allemand, portugais, turc, italien, contenu d'exemple intégré traduit compris.

Comment ça s'articule

/hzpanel → Loading Creator          (l'admin édite, aperçu live dans une iframe)
      ↓  Publier
data/HZ-Loading.json                (le document du Creator, côté serveur)
      ↓  superposé à la config panel + la scène active
getConfig()
      ↓
deferrals.handover  →  le loading screen du joueur qui se connecte
data/effective.json →  instantané de repli, lu en nui://

Le loading screen reçoit sa configuration par la poignée de main de connexion — il ne la demande jamais. Pendant la fenêtre de chargement, HZ-Loading est la seule resource qui tourne côté client et les événements réseau ne sont pas encore routés : un aller-retour requête/réponse resterait souvent sans réponse.

Prérequis

  • HZ-Bridge — obligatoire. Fournit le panel admin, les permissions de rôles et la cascade d'apparence.
  • Standalone — aucun framework nécessaire. Tourne à côté d'ESX, QBCore, QBox ou autre.
  • N'importe quel build FXServer récent.

Pour aller plus loin