Assets

Todos los archivos multimedia viven en la carpeta assets/ del recurso:

hz_loading/assets/
├── audio/       tus MP3
├── images/      fondos + logo
├── video/       un MP4 (restricciones más abajo)
└── keybinds/    iconos SVG de teclas

Soltar un archivo

Pon un archivo en la carpeta correcta y aparecerá en el selector del Creator. Pulsa Rescan en el editor y la lista se actualiza — sin reiniciar.

La detección combina dos fuentes: un manifiesto generado al compilar el recurso y un escaneo del directorio en vivo. El manifiesto garantiza que los assets incluidos siempre se encuentren, incluso en alojamientos que impiden listar directorios; el escaneo en vivo es lo que detecta el archivo que acabas de soltar.

Si tu alojamiento bloquea el listado, la consola lo dice una vez al arrancar:
[hz_loading] io.popen unavailable — live asset discovery off, manifest only.
En ese caso, Rescan no puede ver archivos nuevos — anótalos a mano en los campos de lista del Creator.

Fondos

Cuatro tipos:

Tipo	Qué hace
images	Una lista con fundido encadenado. Ajusta el intervalo y la duración del fundido.
vídeo	Un único vídeo, a pantalla completa.
vídeo + images	Vídeo con la lista de imágenes como respaldo.
generative	Un fondo animado generado en el navegador — no hace falta ningún archivo.

Sobre cualquiera de ellos: oscurecimiento, escala de grises, saturación, contraste y scanlines.

La lista automática viene activada: se usan todas las imágenes encontradas en assets/images/. Desactívala para elegir tú un subconjunto concreto.

Restricciones de vídeo

720p, menos de 5 MB, H.264. Un vídeo de loading screen se decodifica mientras el juego transmite sus assets — en una máquina modesta, un archivo demasiado grande le cuesta al jugador fotogramas justo cuando no le sobra ninguno. El editor muestra estos límites junto al campo.

Un vídeo web incrustado se admite como fuente de fondo. Requiere que el jugador tenga internet en ese momento, y se dibuja una superficie de respaldo detrás del embed para que una carga lenta o bloqueada nunca muestre un vacío negro.

Música

Suelta MP3 en assets/audio/, o pega una URL de audio directa.

Los jugadores disponen de lista, aleatorio, saltar pista, volumen y silencio, con tiempo transcurrido / duración y una barra de posición. Sus ajustes de volumen y silencio se conservan entre conexiones, y la reproducción se pausa automáticamente al hacer alt-tab.

Un vídeo web incrustado no se puede reproducir como música. Solo suenan archivos de audio reales. Esas entradas en una lista musical se filtran, y si una lista acaba compuesta solo por ellas, la tarjeta de música se oculta en lugar de mostrar controles muertos.

Logo

O un archivo en assets/images/, o una URL https:// completa. Logo size fija su altura base en píxeles; el tirador de redimensionado del editor la multiplica por encima, de modo que un logo protagonista puede ocupar buena parte de la pantalla.

Puedes escribir logo.webp, images/logo.webp o assets/images/logo.webp — el prefijo redundante se normaliza, así que una ruta pegada del repositorio se resuelve correctamente en lugar de romperse.

Iconos de teclas

assets/keybinds/ contiene un SVG por tecla, con el nombre de la propia tecla — F1.svg, TAB.svg, M.svg. Se incluye un juego por defecto.

Los iconos solo los usan los estilos de teclas grid, list y compact. El estilo keyboard por defecto dibuja el teclado físico y no los necesita. Cuando una tecla no tiene SVG correspondiente, se muestra su nombre como etiqueta de texto.

Nombres de archivo

Los nombres se validan en el servidor, con protección contra travesía de directorios. Quédate con nombres sencillos y extensiones normales. Los espacios y los acentos van bien — la interfaz los codifica correctamente — pero conviene evitar un nombre con #, ? o &.