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.
General
| Clave | Por defecto | Descripción |
|---|
Config.Locale | 'en' | Idioma de la UI. en, fr, es incluidos; añade más en locales/. |
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 | false | 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.ServerName | "" | Texto junto al icono de Discord. Vacio = "Join the Discord" localizado. |
Config.DiscordURL | "…" | Invitacion de Discord que abre el botón. |
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" | Un acento, inyectado como variable CSS. Anulado en vivo por la cascada de tema de hz_lib cuando está presente. |
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.
