Installation

Dépendances

Dépendance	Obligatoire	Pourquoi
HZ-Bridge	Oui	Panel admin, permissions de rôles, cascade d'apparence
Framework (ESX / QBCore / QBox)	Non	HZ-Loading est standalone

HZ-Bridge est une dépendance dure déclarée dans le manifest. S'il manque, HZ-Loading refuse de démarrer plutôt que de booter dans un état cassé.

Étapes

Déposez le dossier HZ-Loading dans votre répertoire resources.
Dans votre server.cfg, assurez-vous que HZ-Bridge démarre en premier :

ensure HZ-Bridge
ensure HZ-Loading

Redémarrez le serveur (une resource de loading screen ne peut pas être démarrée à chaud de façon utile — elle ne tourne que pendant qu'un joueur se connecte).
Reconnectez-vous.

C'est tout. Il n'y a aucune étape de build — l'interface est livrée déjà compilée, donc ni Node.js ni npm install.

Ce que vous devez voir

Un loading screen anglais complet : images de fond, une piste musicale, une vraie barre de progression, un compteur de joueurs en direct, et le contenu d'exemple Actualités / Règlement / astuces dans votre langue.

Ce défaut est volontairement livrable tel quel. Vous pouvez le laisser ainsi, puis ouvrir le Loading Creator pour le faire vôtre.

Confirmer que ça marche

Le loading screen est par nature difficile à inspecter — il a disparu au moment où vous pouvez taper une commande. Deux vérifications fiables :

Regardez la console serveur au démarrage. HZ-Loading affiche les assets découverts, par exemple

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

Lancez /hzloading:diag une fois en jeu (admin). Il rapporte la configuration effective et les temps de boot des sessions récentes.

« Your Server » avec un compteur 0 / – signifie que le payload de boot n'est jamais arrivé — pas que votre configuration est mauvaise. C'est un problème de livraison (HZ-Bridge absent, ou démarré après HZ-Loading), pas de réglage. Vérifiez d'abord l'ordre dans votre server.cfg.

Permissions

L'accès au panel et le droit de publier sont gérés par les rôles HZ-Bridge. Publier le loading screen exige la permission config sur HZ-Loading, distincte de l'accès général au panel — vous pouvez donc laisser un modérateur éditer le loading screen sans en faire un administrateur global. Voir Commandes et permissions.