HZ Scripts

HZ-Loading

HZ-Loading ist ein Loading-Screen-Creator für FiveM. Der Ladebildschirm selbst ist eine React-Anwendung, die Ihr Server ausliefert — und er wird im Spiel bearbeitet, über das hz_lib Admin-Panel, in einem zweigeteilten Editor mit Live-Vorschau des echten Bildschirms.

Keine Config-Datei, kein Neustart. Alles wird in /hzpanel eingestellt und mit einem Klick veröffentlicht. Der neue Bildschirm ist sofort für alle aktiv, die sich ab diesem Moment verbinden.

Was es kann

  • Der Loading Creator — ein WYSIWYG-Builder in Ihrem Admin-Panel. Freies Drag-and-drop mit Raster-Einrastung, und im rechten Bereich läuft der echte Loading Screen, keine Attrappe.
  • Echter Fortschritt — an die Streaming-Events von FXServer gebunden (Phasen Init / Map / Run, aktuelle Datei, echter Prozentwert), keine CSS-Animation auf einem Timer.
  • Live-Serverdaten — Spielerzahl, Slots und Uptime von Ihrem eigenen Server, über den Verbindungs-Handshake ausgeliefert und damit korrekt für einen Spieler, der sich noch verbindet.
  • Szenen-Planer — per Cron geplante Konfigurations-Überlagerungen: ein Halloween-Skin vom 25. bis 31. Oktober, ein Wartungsbanner dienstags, ein Aktionswochenende.
  • Hintergründe — Bild-Playlist mit Überblendung, Videodatei, ein eingebettetes Web-Video oder generativer animierter Hintergrund, mit Abdunklung, Graustufen, Sättigung, Kontrast und Scanlines.
  • Musikplayer — Playlist, Zufallswiedergabe, Überspringen, Lautstärke, Stumm, mit spielerbezogenen Einstellungen, die zwischen Verbindungen erhalten bleiben.
  • Inhaltsbereiche — Updates und Regeln in Markdown (die Regeln mit Volltextsuche), ein Team-Raster und ein rotierendes Tipp-Laufband.
  • Tastenbelegungs-Übersicht — die physische Tastatur mit Ihren belegten Tasten hervorgehoben, plus QWERTZ / AZERTY-Umschalter.
  • 7 Sprachen — Englisch, Französisch, Spanisch, Deutsch, Portugiesisch, Türkisch, Italienisch, inklusive übersetzter Beispielinhalte.

Wie es zusammenspielt

/hzpanel → Loading Creator          (Admin bearbeitet, Live-Vorschau im iframe)
      ↓  Veröffentlichen
data/hz_loading.json                (das Creator-Dokument, serverseitig)
      ↓  über die Panel-Konfiguration + die aktive Szene gelegt
getConfig()
      ↓
deferrals.handover  →  der Loading Screen des sich verbindenden Spielers
data/effective.json →  Rückfall-Snapshot, über nui:// gelesen

Der Loading Screen empfängt seine Konfiguration über den Verbindungs-Handshake — er fragt sie nie ab. Während des Ladefensters ist HZ-Loading die einzige Resource, die clientseitig läuft, und Netzwerk-Events werden noch nicht geroutet: Eine Anfrage-Antwort-Runde bliebe oft unbeantwortet.

Voraussetzungen

  • hz_lib — erforderlich. Liefert Admin-Panel, Rollenberechtigungen und Erscheinungsbild-Kaskade.
  • Standalone — kein Framework nötig. Läuft neben ESX, QBCore, QBox oder allem anderen.
  • Jeder aktuelle FXServer-Build.

Weiterlesen