Commandes et permissions

Commandes

Les quatre exigent des droits admin et peuvent aussi être lancées depuis la console serveur.

Commande	Ce qu'elle fait
`/hzloading:diag`	Rapporte la configuration effective et les temps de boot récents. La première chose à lancer quand quelque chose cloche.
`/hzloading:rescan`	Re-scanne `assets/audio` et `assets/images` et rafraîchit les sélecteurs du Creator, sans restart.
`/hzloading:scenes`	Liste les scènes déclarées, laquelle est active et pourquoi.
`/hzloading:resetdoc`	Efface le document du Creator. Le loading screen retombe sur la configuration panel plus les défauts. Trappe de secours après une mauvaise publication.

Permissions

Deux portes distinctes, toutes deux gérées par les rôles HZ-Bridge :

L'accès panel à HZ-Loading — permet d'ouvrir le module et l'éditeur, et de lire le document courant.
La permission config — nécessaire pour publier. Vérifiée côté serveur au moment de la publication, pas seulement dans l'interface.

C'est tout l'intérêt de cette séparation : vous pouvez laisser un modérateur ouvrir l'éditeur, parcourir les assets et lancer un rescan sans lui donner le pouvoir de réécrire le loading screen de tous les joueurs — ni de changer le webhook Discord.

Lire le document est toujours en lecture seule. Une tentative de publication sans la permission est refusée et journalisée dans la console serveur avec l'ID de la source.

Événements

HZ-Loading n'expose pas d'exports publics — c'est un écran autonome, pas une bibliothèque. Il émet et écoute en revanche un petit jeu d'événements :

Écoutés (serveur, pilotés par le panel, allowlistés par la vue du module) :

hz_loading:admin:requestDocument — lire le document Creator courant
hz_loading:admin:publishDocument — persister et diffuser (soumis à permission)
hz_loading:admin:rescanAssets — rafraîchir les assets découverts

Envoyés au loading screen (client) :

HZ-Loading:boot — le payload initial
HZ-Loading:configUpdate — une édition en direct pendant la connexion d'un joueur
HZ-Loading:themeUpdate — un changement d'apparence venu de HZ-Bridge
HZ-Loading:serverInfo — le rafraîchissement périodique du compteur de joueurs

Diagnostiquer un loading screen qu'on ne peut pas voir

Le loading screen est détruit au moment où vous apparaissez en jeu, ce qui le rend pénible à déboguer. Deux symptômes à savoir reconnaître :

« Your Server » plus un compteur 0 / – = le payload de boot n'est jamais arrivé. C'est un échec de livraison, pas de configuration. Vérifiez que HZ-Bridge démarre avant HZ-Loading dans server.cfg. Republier n'y changera rien.

Votre changement n'apparaît pas — reconnectez-vous d'abord. Votre propre loading screen avait disparu bien avant que vous sauvegardiez. Et ne jugez pas depuis l'aperçu de l'éditeur : il passe par un canal différent et peut sembler juste pendant que l'écran réel ne l'est pas.

Pour tout le reste, /hzloading:diag montre ce que le serveur a réellement résolu, ce qui suffit en général à distinguer un mauvais réglage d'une mauvaise livraison.