Instalación

Dependencias

Dependencia	Obligatoria	Para qué
hz_lib	Sí	Panel de administración, permisos de rol, cascada de apariencia
Framework (ESX / QBCore / QBox)	No	HZ-Loading es standalone

hz_lib es una dependencia dura declarada en el manifest. Si falta, HZ-Loading se niega a arrancar en lugar de iniciarse en un estado roto.

Pasos

Suelta la carpeta hz_loading en tu directorio resources.
En tu server.cfg, asegúrate de que hz_lib arranca primero:

ensure hz_lib
ensure hz_loading

Reinicia el servidor (un recurso de loading screen no se puede arrancar en caliente de forma útil — solo funciona mientras un jugador se conecta).
Reconéctate.

Eso es todo. No hay paso de compilación — la interfaz se entrega ya compilada, así que ni Node.js ni npm install.

Lo que deberías ver

Un loading screen completo en inglés: imágenes de fondo, una pista musical, una barra de progreso real, un contador de jugadores en vivo y el contenido de ejemplo de Novedades / Normas / consejos en tu idioma.

Ese valor por defecto es deliberadamente publicable tal cual. Puedes dejarlo así y luego abrir el Loading Creator para hacerlo tuyo.

Confirmar que funciona

El loading screen es por naturaleza difícil de inspeccionar — ha desaparecido para cuando puedes escribir un comando. Dos comprobaciones fiables:

Mira la consola del servidor al arrancar. HZ-Loading imprime los assets detectados, por ejemplo

[hz_loading] assets : 3 audio, 7 images (manifest 3/7 + scan 3/7).

Ejecuta /hzloading:diag una vez en el juego (admin). Informa de la configuración efectiva y de los tiempos de arranque de las sesiones recientes.

«Your Server» y un contador 0 / – significan que el payload de arranque nunca llegó — no que tu configuración esté mal. Es un problema de entrega (hz_lib ausente, o arrancado después de HZ-Loading), no de ajustes. Comprueba primero el orden en tu server.cfg.

Permisos

El acceso al panel y el derecho a publicar se gestionan con los roles de hz_lib. Publicar el loading screen exige el permiso config sobre HZ-Loading, distinto del acceso general al panel — así puedes dejar que un moderador edite el loading screen sin convertirlo en administrador global. Consulta Comandos y permisos.