HZ-Loading Screen Creator

Qu'est-ce que HZ-Loading ?

HZ-Loading est un créateur de loading screen pour FiveM — un écran de chargement que vos admins construisent en jeu, depuis votre propre panel, sans toucher à un fichier de config ni à une ligne de code. Ouvrez l'éditeur et vous obtenez un builder en deux volets : les réglages à gauche, et à droite le vrai loading screen qui tourne en direct, qui se met à jour pendant que vous tapez. Déplacez les blocs à la souris, choisissez vos couleurs, sélectionnez votre musique, cliquez sur Publier — tous ceux qui se connectent à partir de cette seconde voient le nouvel écran. Sans restart, sans FTP, sans développeur.

C'est aussi le loading screen qui sait vraiment des choses sur votre serveur. La barre de progression est branchée sur les vrais événements de streaming de FXServer, elle suit donc le téléchargement réel au lieu de s'animer sur un minuteur. Le compteur de joueurs, le nombre de slots et l'uptime viennent de votre serveur et sont livrés par la poignée de main de connexion — autrement dit ils sont déjà justes pour un joueur encore en train de se connecter, ce que la plupart des loading screens ne savent tout simplement pas faire.

Et il est à vous. Achat unique, entièrement auto-hébergé, sans abonnement et sans service externe. Il tourne sur votre serveur, lit vos données, et continue de fonctionner que le site de quelqu'un d'autre soit en ligne ou non.

Pourquoi le loading screen compte plus qu'on ne le croit

C'est l'écran le plus vu de votre serveur. Chaque joueur le voit, à chaque fois, pendant trente secondes à plusieurs minutes — avant d'avoir aperçu quoi que ce soit de ce que vous avez construit. C'est votre première impression, répétée des centaines de fois par jour.

Et pourtant c'est en général la resource la plus négligée, pour une raison très pratique : le modifier est pénible. Les loading screens gratuits sont des fichiers HTML et CSS. Mettre à jour votre règlement veut dire éditer un fichier en FTP, redémarrer la resource, et espérer que rien n'a cassé. Alors personne ne le fait. Le règlement se périme, le bloc actualités annonce encore un événement d'il y a quatre mois, et la liste du staff contient deux personnes parties depuis longtemps.

Les éditeurs hébergés suppriment cette friction mais introduisent un autre problème : la porte d'entrée de votre serveur vit désormais sur l'infrastructure de quelqu'un d'autre, derrière un abonnement mensuel, et elle tombe quand ils tombent.

HZ-Loading prend la troisième voie. L'éditeur est dans votre serveur, dans le panel admin que votre staff utilise déjà, avec les permissions que vous avez déjà configurées. Votre modérateur peut rafraîchir les actualités sans client FTP, sans restart, et sans vous.

Les fonctionnalités en détail

Le Loading Creator

Ouvrez /hzpanel, choisissez HZ-Loading → Open editor. Le volet de droite n'est ni une maquette ni une approximation : c'est la même application React que chargent vos joueurs, montée dans une iframe et pilotée en direct pendant que vous éditez.

Le placement est libre, en glisser-déposer avec aimantation sur une grille : le bloc de marque, les onglets de navigation, les icônes sociales, la carte musique, le bandeau d'astuces, la carte de statut, le logo et les infos serveur peuvent tous se poser où vous voulez. Fonds, couleurs, styles de panneaux, musique, keybinds et contenus se règlent au même endroit et s'affichent instantanément. Publier enregistre votre document et le diffuse à tous les joueurs en cours de connexion.

Comme publier est une action distincte et soumise à permission, vous pouvez confier le loading screen à un modérateur restreint sans en faire un administrateur global.

Vraie progression, vraies données

La barre de progression est câblée sur les véritables événements de chargement de FXServer — les phases init, map et run, le fichier en cours de streaming, et un vrai pourcentage. Le joueur obtient un signal honnête du temps restant plutôt qu'une barre qui se remplit à vitesse fixe puis stagne à 99 %.

Les informations serveur sont un problème plus coriace qu'il n'y paraît : un joueur encore en connexion ne peut pas encore recevoir d'événements réseau classiques. HZ-Loading le résout en faisant voyager la donnée dans la poignée de main de connexion elle-même, si bien que le compteur est juste dès la toute première image — auquel s'ajoute un rafraîchissement ciblé toutes les 15 secondes pour les écrans déjà affichés.

Le planificateur de scènes

Chaque scène déclare une expression cron et une configuration partielle. Quand l'horloge correspond, cette scène se superpose à vos réglages normaux — la première qui correspond l'emporte. Un thème Halloween pour la dernière semaine d'octobre, une bannière de maintenance le mardi matin, une playlist thématique pour un week-end promo. Tout ce qu'une scène ne surcharge pas retombe directement sur votre configuration habituelle, ce qui garde les scènes petites et sans risque. Réglez-les une fois, elles tournent toutes seules chaque année.

Fonds, musique et contenus

Le fond peut être une playlist d'images avec fondu enchaîné, un fichier vidéo, une vidéo YouTube, ou un fond animé génératif — avec par-dessus des effets d'obscurcissement, de désaturation, de saturation, de contraste et de scanlines. Le lecteur de musique gère les playlists, l'aléatoire, le saut de piste, le volume et la sourdine, avec des préférences par joueur conservées entre les connexions et une mise en pause automatique à l'alt-tab.

Les panneaux Actualités et Règlement acceptent le Markdown — titres, listes, gras, liens — et le Règlement dispose d'une recherche plein texte, avec une section cherchable par titre. S'y ajoutent une grille d'équipe et un bandeau d'astuces rotatif qui retient les astuces déjà vues par chaque joueur, de sorte que les habitués découvrent les nouvelles en priorité.

Les assets sont découverts sur le disque : déposez un MP3 ou une image dans le dossier de la resource et il apparaît dans le sélecteur du Creator, avec un bouton Rescan qui rafraîchit la liste sans restart.

Le tableau des keybinds

La vue par défaut dessine le clavier physique avec vos touches assignées allumées, chacune portant un libellé, une description et une infobulle, plus un champ de recherche. Elle inclut un sélecteur QWERTY / AZERTY, qui compte plus qu'il n'y paraît : GTA assigne la touche physique, donc le A d'un joueur AZERTY se trouve là où le QWERTY imprime Q. Afficher le mauvais clavier mal-étiquette une rangée entière. Des styles en grille, en liste et compact sont proposés en alternative.

Sept langues, fini dès la sortie de boîte

Anglais, français, espagnol, allemand, portugais, turc et italien. L'interface et le contenu d'exemple intégré sont traduits, si bien qu'une installation fraîche ressemble déjà à un loading screen terminé dans chaque langue — un vrai règlement, de vraies actualités, de vraies astuces. Un bouton Load example recopie ce texte dans l'éditeur pour que vous puissiez le retoucher au lieu de le retaper.

Cohérent avec le reste de votre serveur

HZ-Loading suit la cascade de thème hz_lib : réglez votre couleur d'accent une fois et toutes les resources HZ la reprennent, loading screen compris. Accent, surbrillance, or, surfaces et couleurs de texte, arrondis et opacité des panneaux sont tous exposés, avec deux presets prêts à l'emploi comme point de départ.

Permissions et durcissement

Publier est protégé par une permission hz_lib explicite, distincte de l'accès général au panel. Le Markdown est assaini avant rendu : un compte panel compromis ne peut pas injecter de script chez tous les joueurs en connexion. Les noms de fichiers et les URLs sont validés avec protection contre la traversée de répertoire, et votre webhook Discord n'est jamais inclus dans ce qui est envoyé à un client.

Compatibilité

• Standalone. Aucun framework requis — tourne à côté d'ESX, QBCore, QBox ou autre.
• Requiert hz_lib (gratuit) pour le panel admin, les permissions de rôles et la cascade de thème.
• N'importe quel build FXServer récent.

Installation

1. Déposez hz_loading dans votre dossier resources.
2. Assurez-vous que hz_lib démarre avant lui dans votre server.cfg.
3. Ajoutez ensure hz_loading.
4. Reconnectez-vous.

La configuration par défaut livre déjà un loading screen complet en anglais — images de fond, une piste musicale, une vraie barre de progression et un compteur de joueurs en direct. Vous pouvez le mettre en ligne tel quel, puis ouvrir le Loading Creator dans /hzpanel pour le faire vôtre. Pas de Node.js, pas d'étape de build : l'interface est livrée déjà compilée.

Performance

Le loading screen tourne dans sa propre fenêtre avant que le monde du jeu existe, il ne coûte donc rien en jeu. Ce qui compte, c'est plutôt sa vitesse d'affichage et le peu qu'il demande à votre serveur.

Les polices sont auto-hébergées et sous-ensemblées — aucune requête vers un CDN, ce qui veut aussi dire que l'écran s'affiche correctement pour un joueur dont le DNS n'est pas encore opérationnel. Les panneaux Règlement et Actualités, moteur Markdown et index de recherche compris, sont découpés en chunks séparés chargés uniquement quand un joueur les ouvre vraiment, ce qui garde le premier affichage léger. Côté serveur, le rafraîchissement en direct est ciblé sur les seuls joueurs en connexion au lieu d'être diffusé à tout le monde, et toute la configuration est résolue une fois par connexion au lieu d'être interrogée en boucle.