Configuración

Todo está en config.lua. Los ajustes de cara al jugador (gráficos, mira) los elige cada jugador en juego y se almacenan del lado del cliente; las claves de abajo son solo los valores por defecto de la primera ejecución y las opciones de nivel admin.

config.lua es un script compartido — se carga tanto en la VM Lua del servidor como en la del cliente. Las claves que rigen el comportamiento del cliente se aplican en el cliente; con hz_lib, las anulaciones de admin se envían al cliente en vivo.

14 claves también están en /hzpanel. Config.Locale, Config.LowPerformanceMode, Config.Brand, Config.ServerName, Config.DiscordURL, Config.ShopURL, Config.Accent y las claves de Config.Hud salvo Custom también se ajustan en el panel de hz_lib, sección Menu Pausa. config.lua se aplica mientras no se guarde un valor en el panel. Un valor guardado en el panel gana sobre config.lua y se aplica en vivo, y su botón de restablecer devuelve la clave a config.lua (con hz_lib 1.2.1 o posterior). Antes de HZ-PauseMenu 1.2.1, los valores por defecto del panel ganaban sobre config.lua para estas claves aunque no hubiera nada guardado, así que actualiza tanto hz_pausemenu como hz_lib a la 1.2.1. Con hz_lib, Config.Locale debe ser en, fr o es, los tres idiomas que ofrece el panel: cualquier otro valor vuelve a en.

General

Clave	Por defecto	Descripción
`Config.Locale`	`'en'`	Idioma de la UI. `en`, `fr`, `es` incluidos; añade más en `locales/`. Con hz_lib, usa `en`, `fr` o `es`.
`Config.Debug`	`false`	Muestra en la consola los errores al cargar los archivos de idioma.
`Config.Framework`	`'auto'`	`auto` detecta es_extended → qbx_core → qb-core → ox_core → vRP → standalone. Fuerza un nombre solo si dos cores se ejecutan a la vez.
`Config.LowPerformanceMode`	`false`	Desactiva transiciones/desenfoque de la UI para clientes muy modestos.
`Config.ClientWait`	`300000`	ms que un cliente reutiliza una consulta de info del servidor. El número de jugadores siempre se lee al momento.

Perfil

Clave	Por defecto	Descripción
`Config.Mugshot.Enabled`	`true`	Muestra la cara del jugador (pedheadshot por GPU → base64) en lugar de una inicial. Autónomo, cacheado, regenerado solo al cambiar de ped.
`Config.Mugshot.Transparent`	`true`	`true` = cara recortada sobre el degradado del circulo; `false` = fondo de estudio recortado al circulo.
`Config.Mugshot.PollSeconds`	`4`	Con que frecuencia comprobar un cambio de atuendo/modelo.
`Config.DefaultNationality`	`'USA'`	Se muestra cuando el framework no la trae (ESX base). Pon `""` para mantener `--`.
`Config.LogoutCommand`	`'logout'`	Comando que ejecuta la tarjeta de personaje cuando el servidor tiene multichar. Deja `""` sin multichar → la tarjeta abre la pestaña PROFILE en su lugar (sin botón muerto).
`Config.CharacterImage`	`'images/character.webp'`	Imagen en la tarjeta de personaje de la pestaña GAME (bajo `web/public/`). `""` recurre al logotipo VICE.

Marca y tienda

Clave	Por defecto	Descripción
`Config.Brand`	`"No\\|Trace"`	Texto del logo arriba en el centro. La parte antes de `\\|` toma el color del tema. `""` lo oculta.
`Config.ServerName`	`""`	Texto junto al icono de Discord. Vacio = "Join the Discord" localizado.
`Config.DiscordURL`	`"https://discord.me/hzscript"`	Invitación de Discord que abre el botón. Pon la tuya.
`Config.ShopURL`	`""`	La pestaña SHOP abre esta URL en el navegador del jugador (debe ser `http(s)://`). Vacío = la pestaña SHOP se oculta.

Acento y tema

Clave	Por defecto	Descripción
`Config.Accent`	`"#FF6EC7"`	Tinte de respaldo del menú de Ajustes nativo de GTA V, usado solo mientras no se ha recibido ningún tema de hz_lib. El menú toma sus colores del tema de hz_lib, y el tinte nativo también en cuanto el tema se carga.
`Config.NativeMenuAccent`	(tabla)	Tinta el menú de Ajustes nativo de GTA V con tu acento. Consulta Tema.

Ajustes del jugador (por defecto)

Clave	Por defecto	Descripción
`Config.Graphics.Enabled`	`true`	`false` oculta todo el panel de FPS.
`Config.Graphics.Timecycles`	`{}`	Nombres de timecycle ofrecidos en el desplegable. Vacío a propósito — GTA tiene una sola ranura de timecycle y los scripts de clima la controlan. Rellena solo en un servidor donde nada más la maneje.
`Config.CrosshairEnabled`	`true`	`false` oculta todo el panel de la mira.
`Config.KeybindsEnabled`	`true`	`false` oculta el subpanel de teclas.
`Config.KeybindLayout`	`'qwerty'`	`qwerty` o `azerty` — las filas de letras físicas en el tablero.
`Config.Keybinds`	(lista)	Lista de teclas standalone, `"KEY\\|LABEL\\|icon\\|DESC"`. Si HZ-Loading se ejecuta, se usan sus teclas compartidas en su lugar.

Consulta Ajustes del jugador para ver como se muestran en juego.

Integración de HUD

Config.Hud oculta tu HUD mientras el menú (o el mapa/ajustes nativos) está abierto, y luego lo restaura. Funciona con cualquier resource de HUD. Referencia completa: Integración de HUD.