Comandos y permisos

Comandos

Los cuatro requieren derechos de administrador y también se pueden ejecutar desde la consola del servidor.

Comando	Qué hace
`/hzloading:diag`	Informa de la configuración efectiva y de los tiempos de arranque recientes. Lo primero que hay que ejecutar cuando algo no cuadra.
`/hzloading:rescan`	Vuelve a escanear `assets/audio` y `assets/images` y actualiza los selectores del Creator, sin reiniciar.
`/hzloading:scenes`	Lista las escenas declaradas, cuál está activa y por qué.
`/hzloading:resetdoc`	Borra el documento del Creator. El loading screen vuelve a la configuración del panel más los valores por defecto. Salida de emergencia tras una mala publicación.

Permisos

Dos puertas distintas, ambas gestionadas por los roles de hz_lib:

Acceso de panel a HZ-Loading — permite abrir el módulo y el editor, y leer el documento actual.
El permiso config — necesario para publicar. Comprobado en el servidor en el momento de publicar, no solo en la interfaz.

Esa separación es justamente el objetivo: puedes dejar que un moderador abra el editor, revise los assets y ejecute un rescan sin darle el poder de reescribir el loading screen de todos los jugadores — ni de cambiar el webhook de Discord.

Leer el documento es siempre de solo lectura. Un intento de publicación sin el permiso se rechaza y queda registrado en la consola del servidor con el ID de origen.

Eventos

HZ-Loading no expone exports públicos — es una pantalla autocontenida, no una biblioteca. Sí emite y escucha un pequeño conjunto de eventos:

Escuchados (servidor, dirigidos por el panel, en lista blanca de la vista del módulo):

hz_loading:admin:requestDocument — leer el documento actual del Creator
hz_loading:admin:publishDocument — persistir y difundir (sujeto a permiso)
hz_loading:admin:rescanAssets — refrescar los assets detectados

Enviados al loading screen (cliente):

HZ-Loading:boot — el payload inicial
HZ-Loading:configUpdate — una edición en vivo durante la conexión de un jugador
HZ-Loading:themeUpdate — un cambio de apariencia procedente de hz_lib
HZ-Loading:serverInfo — la actualización periódica del contador de jugadores

Diagnosticar un loading screen que no puedes ver

El loading screen se destruye en el momento en que apareces en el juego, lo que complica la depuración. Dos síntomas que conviene reconocer:

«Your Server» más un contador 0 / – = el payload de arranque nunca llegó. Es un fallo de entrega, no de configuración. Comprueba que hz_lib arranca antes que HZ-Loading en server.cfg. Volver a publicar no servirá de nada.

Tu cambio no aparece — reconéctate primero. Tu propio loading screen ya había desaparecido mucho antes de que guardaras. Y no juzgues por la vista previa del editor: se alimenta por un canal distinto y puede verse correcta mientras la pantalla real no lo está.

Para todo lo demás, /hzloading:diag muestra lo que el servidor resolvió realmente, lo que suele bastar para distinguir un ajuste equivocado de una entrega fallida.