Assets

Alle Mediendateien liegen im Ordner assets/ der Resource:

hz_loading/assets/
├── audio/       Ihre MP3s
├── images/      Hintergründe + Logo
├── video/       eine MP4 (Vorgaben siehe unten)
└── keybinds/    SVG-Tastensymbole

Eine Datei ablegen

Legen Sie eine Datei in den richtigen Ordner und sie erscheint in der Auswahl des Creators. Klicken Sie im Editor auf Rescan und die Liste aktualisiert sich — ohne Neustart.

Die Erkennung führt zwei Quellen zusammen: ein Manifest, das beim Bauen der Resource erzeugt wird, und einen Live-Scan des Verzeichnisses. Das Manifest garantiert, dass die mitgelieferten Assets immer gefunden werden, auch auf Hostern, die das Auflisten von Verzeichnissen unterbinden; der Live-Scan findet die Datei, die Sie gerade abgelegt haben.

Blockiert Ihr Hoster das Auflisten, sagt es die Konsole einmal beim Start:
[hz_loading] io.popen unavailable — live asset discovery off, manifest only.
Auf einem solchen Hoster kann Rescan keine neuen Dateien sehen — tragen Sie sie stattdessen von Hand in die Playlist-Felder des Creators ein.

Hintergründe

Vier Typen:

Typ	Was er macht
images	Eine Playlist mit Überblendung. Intervall und Überblenddauer sind einstellbar.
video	Ein einzelnes Video, bildschirmfüllend.
video + images	Video mit der Bild-Playlist als Rückfall.
generative	Ein im Browser erzeugter animierter Hintergrund — keine Datei nötig.

Auf jedem davon: Abdunklung, Graustufen, Sättigung, Kontrast und Scanlines. Auto-Playlist ist standardmäßig aktiv: Jedes in assets/images/ gefundene Bild wird verwendet. Schalten Sie sie ab, um stattdessen eine gezielte Auswahl zu kuratieren.

Videovorgaben

720p, unter 5 MB, H.264. Ein Loading-Screen-Video wird dekodiert, während das Spiel Assets streamt — auf einem mittelmäßigen Rechner kostet eine zu große Datei den Spieler genau dann Bilder pro Sekunde, wenn er keine übrig hat. Der Editor zeigt diese Grenzen direkt am Feld an.

Ein eingebettetes Web-Video wird als Hintergrundquelle unterstützt. Das setzt voraus, dass der Spieler in diesem Moment Internet hat; hinter dem Embed wird eine Rückfallfläche gezeichnet, damit ein langsames oder blockiertes Laden nie eine schwarze Leere zeigt.

Musik

Legen Sie MP3s in assets/audio/ ab oder fügen Sie eine direkte Audio-URL ein.

Spieler erhalten Playlist, Zufallswiedergabe, Überspringen, Lautstärke und Stumm, dazu verstrichene Zeit / Dauer und eine Positionsleiste. Lautstärke und Stummschaltung bleiben zwischen Verbindungen erhalten, und die Wiedergabe pausiert automatisch beim Alt-Tab.

Ein eingebettetes Web-Video ist nicht als Musik abspielbar. Nur echte Audiodateien werden wiedergegeben. Solche Einträge in einer Musik-Playlist werden herausgefiltert, und falls eine Playlist am Ende nur noch daraus besteht, blendet sich die Musikkarte aus, statt tote Bedienelemente zu zeigen.

Logo

Entweder eine Datei in assets/images/ oder eine vollständige https://-URL. Logo size legt die Grundhöhe in Pixeln fest; der Größengriff im Layout-Editor multipliziert sie zusätzlich, sodass ein großes Logo einen erheblichen Teil des Bildschirms füllen kann.

Sie können logo.webp, images/logo.webp oder assets/images/logo.webp schreiben — das überflüssige Präfix wird normalisiert, ein eingefügter Repo-Pfad wird also korrekt aufgelöst statt zu brechen.

Tastensymbole

assets/keybinds/ enthält eine SVG-Datei pro Taste, benannt nach der Taste selbst — F1.svg, TAB.svg, M.svg. Ein Standardsatz wird mitgeliefert.

Symbole werden nur von den Tastenstilen grid, list und compact genutzt. Der Standardstil keyboard zeichnet die physische Tastatur und braucht sie nicht. Hat eine Taste keine passende SVG-Datei, wird der Tastenname als Text-Chip angezeigt.

Dateinamen

Dateinamen werden serverseitig validiert, mit Schutz vor Verzeichnistraversierung. Bleiben Sie bei einfachen Namen und üblichen Endungen. Leerzeichen und Umlaute sind in Ordnung — die Oberfläche kodiert sie korrekt — aber ein Name mit #, ? oder & sollte vermieden werden.