Befehle und Berechtigungen

Befehle

Alle vier erfordern Admin-Rechte und lassen sich auch aus der Serverkonsole ausführen.

Befehl	Was er tut
`/hzloading:diag`	Meldet die effektive Konfiguration und die jüngsten Boot-Zeiten. Das Erste, was man ausführt, wenn etwas nicht stimmt.
`/hzloading:rescan`	Durchsucht `assets/audio` und `assets/images` erneut und aktualisiert die Auswahllisten des Creators, ohne Neustart.
`/hzloading:scenes`	Listet die deklarierten Szenen auf, welche aktiv ist und warum.
`/hzloading:resetdoc`	Löscht das Creator-Dokument. Der Loading Screen fällt auf die Panel-Konfiguration plus Standardwerte zurück. Notausstieg nach einer misslungenen Veröffentlichung.

Berechtigungen

Zwei getrennte Tore, beide über hz_lib-Rollen verwaltet:

Panel-Zugang zu HZ-Loading — erlaubt, das Modul und den Editor zu öffnen und das aktuelle Dokument zu lesen.
Die config-Berechtigung — nötig zum Veröffentlichen. Serverseitig zum Zeitpunkt der Veröffentlichung geprüft, nicht nur in der Oberfläche.

Genau darum geht es bei dieser Trennung: Sie können einen Moderator den Editor öffnen, Assets durchsehen und einen Rescan ausführen lassen, ohne ihm die Macht zu geben, den Loading Screen für alle Spieler neu zu schreiben — oder den Discord-Webhook zu ändern.

Das Lesen des Dokuments ist immer schreibgeschützt. Ein Veröffentlichungsversuch ohne die Berechtigung wird abgelehnt und mit der Quell-ID in der Serverkonsole protokolliert.

Events

HZ-Loading stellt keine öffentlichen Exports bereit — es ist ein in sich geschlossener Bildschirm, keine Bibliothek. Es sendet und empfängt jedoch einen kleinen Satz Events:

Empfangen (Server, panelgesteuert, von der Modulansicht freigegeben):

hz_loading:admin:requestDocument — das aktuelle Creator-Dokument lesen
hz_loading:admin:publishDocument — speichern und verteilen (berechtigungsgeschützt)
hz_loading:admin:rescanAssets — die gefundenen Assets aktualisieren

An den Loading Screen gesendet (Client):

HZ-Loading:boot — der anfängliche Payload
HZ-Loading:configUpdate — eine Live-Änderung während der Verbindung eines Spielers
HZ-Loading:themeUpdate — eine Erscheinungsbild-Änderung aus hz_lib
HZ-Loading:serverInfo — die periodische Aktualisierung der Spielerzahl

Einen Loading Screen diagnostizieren, den man nicht sehen kann

Der Loading Screen wird in dem Moment zerstört, in dem Sie ins Spiel kommen, was die Fehlersuche unhandlich macht. Zwei Symptome, die man kennen sollte:

„Your Server" plus Spielerzahl 0 / – = der Boot-Payload ist nie angekommen. Das ist ein Auslieferungsfehler, kein Konfigurationsfehler. Prüfen Sie, ob hz_lib in der server.cfg vor HZ-Loading startet. Erneutes Veröffentlichen hilft nicht.

Ihre Änderung erscheint nicht — verbinden Sie sich zuerst neu. Ihr eigener Loading Screen war längst weg, bevor Sie gespeichert haben. Und urteilen Sie nicht nach der Editor-Vorschau: Sie wird über einen anderen Kanal gespeist und kann korrekt aussehen, während der Live-Bildschirm es nicht ist.

Für alles Weitere zeigt /hzloading:diag, was der Server tatsächlich aufgelöst hat — das genügt meist, um eine falsche Einstellung von einer fehlgeschlagenen Auslieferung zu unterscheiden.