Comandos e permissões

Comandos

Os quatro exigem direitos de administrador e também podem ser executados a partir da consola do servidor.

Comando	O que faz
`/hzloading:diag`	Relata a configuração efetiva e os tempos de arranque recentes. A primeira coisa a executar quando algo não bate certo.
`/hzloading:rescan`	Volta a varrer `assets/audio` e `assets/images` e atualiza os seletores do Creator, sem reiniciar.
`/hzloading:scenes`	Lista as cenas declaradas, qual está ativa e porquê.
`/hzloading:resetdoc`	Apaga o documento do Creator. O loading screen volta à configuração do painel mais os valores por omissão. Saída de emergência após uma má publicação.

Permissões

Duas portas distintas, ambas geridas pelas funções do hz_lib:

Acesso de painel ao HZ-Loading — permite abrir o módulo e o editor, e ler o documento atual.
A permissão config — necessária para publicar. Verificada no servidor no momento da publicação, não apenas na interface.

É esse precisamente o objetivo da separação: pode deixar um moderador abrir o editor, ver os assets e executar um rescan sem lhe dar o poder de reescrever o loading screen de todos os jogadores — nem de mudar o webhook do Discord.

Ler o documento é sempre apenas leitura. Uma tentativa de publicação sem a permissão é recusada e registada na consola do servidor com o ID de origem.

Eventos

O HZ-Loading não expõe exports públicos — é um ecrã autocontido, não uma biblioteca. Emite e escuta, no entanto, um pequeno conjunto de eventos:

Escutados (servidor, conduzidos pelo painel, em lista branca da vista do módulo):

hz_loading:admin:requestDocument — ler o documento atual do Creator
hz_loading:admin:publishDocument — guardar e difundir (sujeito a permissão)
hz_loading:admin:rescanAssets — atualizar os assets detetados

Enviados ao loading screen (cliente):

HZ-Loading:boot — o payload inicial
HZ-Loading:configUpdate — uma edição ao vivo durante a ligação de um jogador
HZ-Loading:themeUpdate — uma alteração de aparência vinda do hz_lib
HZ-Loading:serverInfo — a atualização periódica da contagem de jogadores

Diagnosticar um loading screen que não se consegue ver

O loading screen é destruído no momento em que entra no jogo, o que torna a depuração incómoda. Dois sintomas que vale a pena reconhecer:

«Your Server» mais uma contagem 0 / – = o payload de arranque nunca chegou. É uma falha de entrega, não de configuração. Verifique se o hz_lib arranca antes do HZ-Loading no server.cfg. Voltar a publicar não vai ajudar.

A sua alteração não aparece — volte a ligar-se primeiro. O seu próprio loading screen já tinha desaparecido muito antes de ter guardado. E não julgue pela pré-visualização do editor: é alimentada por um canal diferente e pode parecer correta enquanto o ecrã real não está.

Para tudo o resto, /hzloading:diag mostra o que o servidor realmente resolveu, o que costuma bastar para distinguir uma definição errada de uma entrega falhada.