Assets

Todos os ficheiros de média vivem na pasta assets/ do recurso:

hz_loading/assets/
├── audio/       os seus MP3
├── images/      fundos + logótipo
├── video/       um MP4 (restrições mais abaixo)
└── keybinds/    ícones SVG de teclas

Colocar um ficheiro

Ponha um ficheiro na pasta certa e ele aparece no seletor do Creator. Carregue em Rescan no editor e a lista atualiza-se — sem reiniciar.

A deteção junta duas fontes: um manifesto gerado ao compilar o recurso e uma varredura do diretório em direto. O manifesto garante que os assets incluídos são sempre encontrados, mesmo em alojamentos que impedem listar diretórios; a varredura em direto é o que apanha o ficheiro que acabou de colocar.

Se o seu alojamento bloquear a listagem, a consola di-lo uma vez no arranque:
[hz_loading] io.popen unavailable — live asset discovery off, manifest only.
Nesse caso, o Rescan não consegue ver ficheiros novos — indique-os à mão nos campos de lista do Creator.

Fundos

Quatro tipos:

Tipo	O que faz
images	Uma lista com transição cruzada. Defina o intervalo e a duração da transição.
video	Um único vídeo, em ecrã inteiro.
video + images	Vídeo com a lista de imagens como recurso.
generative	Um fundo animado gerado no browser — não é preciso ficheiro.

Sobre qualquer um deles: escurecimento, tons de cinzento, saturação, contraste e scanlines.

A lista automática vem ligada: são usadas todas as imagens encontradas em assets/images/. Desligue-a para escolher um subconjunto específico.

Restrições de vídeo

720p, menos de 5 MB, H.264. Um vídeo de loading screen é descodificado enquanto o jogo transmite os seus assets — numa máquina modesta, um ficheiro demasiado grande custa ao jogador imagens por segundo exatamente quando não tem nenhuma a perder. O editor mostra estes limites junto ao campo.

Um vídeo web incorporado é aceite como fonte de fundo. Exige que o jogador tenha internet nesse momento, e é desenhada uma superfície de recurso atrás do embed para que um carregamento lento ou bloqueado nunca mostre um vazio preto.

Música

Coloque MP3 em assets/audio/, ou cole um URL de áudio direto.

Os jogadores têm lista de reprodução, aleatório, saltar faixa, volume e silêncio, com tempo decorrido / duração e uma barra de posição. As escolhas de volume e silêncio mantêm-se entre ligações, e a reprodução pausa automaticamente no alt-tab.

Um vídeo web incorporado não é reproduzível como música. Só tocam ficheiros de áudio reais. Essas entradas numa lista musical são filtradas e, se uma lista acabar composta apenas por elas, o cartão de música esconde-se em vez de mostrar controlos mortos.

Logótipo

Ou um ficheiro em assets/images/, ou um URL https:// completo. Logo size define a altura base em píxeis; a pega de redimensionamento do editor de disposição multiplica-a por cima, de modo que um logótipo protagonista pode ocupar boa parte do ecrã.

Pode escrever logo.webp, images/logo.webp ou assets/images/logo.webp — o prefixo redundante é normalizado, por isso um caminho copiado do repositório resolve-se corretamente em vez de partir.

Ícones de teclas

assets/keybinds/ contém um SVG por tecla, com o nome da própria tecla — F1.svg, TAB.svg, M.svg. Vem incluído um conjunto por omissão.

Os ícones só são usados pelos estilos de teclas grid, list e compact. O estilo keyboard por omissão desenha o teclado físico e não os utiliza. Quando uma tecla não tem SVG correspondente, o nome da tecla é mostrado como etiqueta de texto.

Nomes de ficheiros

Os nomes são validados no servidor, com proteção contra travessia de diretórios. Fique por nomes simples e extensões normais. Espaços e acentos não são problema — a interface codifica-os corretamente — mas convém evitar um nome com #, ? ou &.