Configuración

Configuración (config.lua)

Referencia completa de cada opción Config.* del config.lua de PSTUDIOS-HUD, con su propósito, valores admitidos y default real.

Todo lo ajustable en PSTUDIOS-HUD vive en un solo archivo: config.lua. Estos valores se envían a la NUI al arrancar y se traducen a variables CSS, de modo que cambiarlos se refleja directamente en pantalla. Esta página documenta cada opción tal y como viene, con su tipo, valores admitidos y default real.

💡config.lua queda abierto y totalmente editable pese al escrow. La protección del lado servidor (escrow) bloquea la lógica compilada de cliente/servidor, pero config.lua se deja a propósito en texto plano para que ajustes colores, escala, módulos y teclas sin restricciones.

General

Config.Framework

Integración con el framework. 'auto' detecta es_extended / qb-core / qbx_core automáticamente, o fuérzalo a uno concreto. Valores admitidos: 'auto' | 'esx' | 'qbcore' | 'qbox' | 'standalone'. Default: 'auto' (string). Consulta la página de Frameworks para saber cómo funciona la detección.

Config.Units

Unidad de velocidad terrestre. Los barcos usan siempre knots y los aviones siempre airspeed, independientemente de este ajuste. Valores admitidos: 'kmh' | 'mph'. Default: 'kmh' (string).

Config.Locale

Idioma del HUD (textos de NUI + descripciones de teclas). Disponibles de fábrica: 'es' | 'en' | 'fr' | 'de' | 'pt'. Añade más en locales/ — consulta la página de Idiomas. Default: 'es' (string).

Config.Brand

Texto de marca opcional en la esquina. Pon '' (cadena vacía) para ocultarlo. Default: 'PONEGLYPH' (string).

Config.Framework = 'auto'   -- 'auto' | 'esx' | 'qbcore' | 'qbox' | 'standalone'
Config.Units = 'kmh'        -- 'kmh' | 'mph'
Config.Locale = 'es'        -- 'es' | 'en' | 'fr' | 'de' | 'pt'
Config.Brand = 'PONEGLYPH'  -- '' to hide

Bloque general tal y como viene

Colocación y aspecto

Config.Scale

Escala global del HUD, donde 1.0 = 100%. Número. Default: 1.0.

Config.Opacity

Opacidad global del HUD. Número de 0.0 a 1.0. Default: 1.0.

Config.Position

Esquina del cluster de vehículo. Valores admitidos: 'br' (abajo-derecha) | 'bl' (abajo-izquierda). Default: 'br' (string).

Config.StatsPos

Posición personalizada de los anillos de estado, fijada por el menú /hud al arrastrarlos. nil = anclados abajo-izquierda. Formato: tabla { x = %, y = % }. Default: nil. Consulta la página Anillos de estado movibles.

Config.Scale    = 1.0       -- escala global (1.0 = 100%)
Config.Opacity  = 1.0       -- 0.0 - 1.0
Config.Position = 'br'      -- esquina del cluster: 'br' | 'bl'

-- nil = anclados abajo-izquierda. Formato { x = %, y = % }.
Config.StatsPos = nil

Defaults de colocación

Tecla y rendimiento

Config.Keybind

Tecla para mostrar/ocultar todo el HUD. Default: 'F7' (string). Consulta Controles por defecto y asignación de teclas para ver todas las teclas y cómo reasignarlas.

Config.HudRefresh

Refresco del HUD en vehículo, en milisegundos. A pie el hilo duerme mucho más. 75 ms (~13 fps) mantiene resmon en ~0.03 ms en vehículo y ~0.00 ms a pie; el velocímetro es digital + arco segmentado, así que a 75 ms se ve igual de fluido. Número. Default: 75. Consulta la página de Rendimiento para el desglose completo.

Config.Keybind = 'F7'

-- Refresco del HUD en vehículo (ms). A pie el hilo duerme mucho más.
Config.HudRefresh = 75

Tecla y refresco

Velocímetro

Config.Speedo configura los rangos del velocímetro analógico. Todos los valores son números.

maxKmh — valor a fondo de escala en km/h. Default: 240.
maxMph — valor a fondo de escala en mph. Default: 160.
maxKnots — valor a fondo de escala en knots (barcos). Default: 90.
redlineRpm — % de RPM a partir del cual el aro se pone rojo. Default: 85.

Config.Speedo = {
    maxKmh = 240,
    maxMph = 160,
    maxKnots = 90,
    redlineRpm = 85,        -- % de RPM a partir del cual el aro se pone rojo
}

Bloque del velocímetro

Módulos

Config.Modules activa o desactiva cada módulo del HUD (true/false). Se respetan por perfil de vehículo. Fíjate en los dos defaults en false: rpm y temp, porque el cluster Modern Pro no dibuja aguja de RPM ni temperatura, lo que ahorra un nativo por tick en cada caso.

status — anillos de vida/armadura/hambre/sed/oxígeno. Default: true.
mic — indicador de voz. Default: true.
speedo — velocímetro. Default: true.
rpm — aguja de RPM. Default: false (el cluster Modern Pro no la dibuja).
gear — marcha actual. Default: true.
fuel — nivel de combustible. Default: true.
temp — temperatura. Default: false (el cluster Modern Pro no la dibuja).
engine — estado del motor. Default: true.
odometer — odómetro. Default: true.
compass — brújula. Default: true.
gps — GPS. Default: true.
controls — intermitentes, cinturón, luces, crucero… Default: true.

Config.Modules = {
    status   = true,   -- anillos de vida/armadura/hambre/sed/oxígeno
    mic      = true,   -- indicador de voz
    speedo   = true,
    rpm      = false,  -- el cluster Modern Pro no dibuja aguja de RPM
    gear     = true,
    fuel     = true,
    temp     = false,  -- el cluster Modern Pro no dibuja temperatura
    engine   = true,
    odometer = true,
    compass  = true,
    gps      = true,
    controls = true,   -- intermitentes, cinturón, luces, crucero…
}

Bloque de módulos (rpm y temp vienen en false)

Estado del jugador extra

Config.Status

Indicadores de estado extra del jugador. stress muestra el anillo de estrés y requiere un framework que lo aporte. Default: stress = false (boolean).

Config.Status = {
    stress = false,    -- requiere framework que lo aporte
}

Cinturón

Config.Seatbelt configura el sistema de cinturón.

enabled — activa/desactiva el cinturón (boolean). Default: true.
key — tecla para abrochar/desabrochar el cinturón (string). Default: 'B'.
ejectOnCrash — expulsa al jugador por el parabrisas en un choque (boolean). Default: false.
crashSpeedKmh — umbral de velocidad (km/h) que cuenta como choque (número). Default: 110.0.

Config.Seatbelt = {
    enabled      = true,
    key          = 'B',
    ejectOnCrash = false,
    crashSpeedKmh= 110.0,
}

Bloque de cinturón

Brújula / mundo

Config.Compass controla la brújula y la barra de información del mundo.

enabled — activa/desactiva la brújula (boolean). Default: true.
showStreet — muestra el nombre de la calle actual (boolean). Default: true.
showZone — muestra la zona actual (boolean). Default: true.
showTime — muestra la hora del juego (boolean). Default: true.
tick — intervalo de actualización en ms (con dirty-check, casi gratis) (número). Default: 150.

Config.Compass = {
    enabled    = true,
    showStreet = true,
    showZone   = true,
    showTime   = true,
    tick       = 150,  -- ms (con dirty-check, casi gratis)
}

Bloque de brújula

Minimapa / radar

Config.Minimap controla la visibilidad del minimapa/radar de GTA.

showOnFoot — ver el mapa a pie (boolean). Default: true.
showInVehicle — ver el mapa conduciendo (boolean). Default: true.

Config.Minimap = {
    showOnFoot    = true,   -- ver el mapa a pie
    showInVehicle = true,   -- ver el mapa conduciendo
}

Bloque de minimapa

Modo daltónico

Config.ColorblindMode

Activa la paleta alternativa (Config.ColorsCB) en lugar de la Config.Colors por defecto. Boolean. Default: false. Al ponerlo en true, el HUD usa los colores amigables para deuteranopía/protanopía.

Config.ColorblindMode = false

Colores

Config.Colors se vuelca a variables CSS :root y es cambiable en caliente. Cada valor es un string de color hex. Estos son los defaults que vienen.

health — '#f43f5e'
armor — '#2dd4bf'
hunger — '#eab308'
thirst — '#3b82f6'
oxygen — '#06b6d4'
stress — '#a855f7'
stamina — '#f59e0b'
accent — '#e0a94a' (dorado de marca Poneglyph)

Config.Colors = {
    health  = '#f43f5e',
    armor   = '#2dd4bf',
    hunger  = '#eab308',
    thirst  = '#3b82f6',
    oxygen  = '#06b6d4',
    stress  = '#a855f7',
    stamina = '#f59e0b',
    accent  = '#e0a94a',  -- dorado de marca Poneglyph
}

Paleta de colores por defecto

Paleta daltónica

Config.ColorsCB es la paleta alternativa usada cuando Config.ColorblindMode = true (amigable con deuteranopía/protanopía). Cada valor es un string de color hex.

health — '#ff7f0e'
armor — '#1f77b4'
hunger — '#f0e442'
thirst — '#56b4e9'
oxygen — '#009e9e'
stress — '#cc79a7'
stamina — '#e69f00'
accent — '#e69f00'

Config.ColorsCB = {
    health  = '#ff7f0e',
    armor   = '#1f77b4',
    hunger  = '#f0e442',
    thirst  = '#56b4e9',
    oxygen  = '#009e9e',
    stress  = '#cc79a7',
    stamina = '#e69f00',
    accent  = '#e69f00',
}

Paleta daltónica

💡La mayoría de estas opciones también pueden cambiarse en caliente dentro del juego sin editar config.lua — consulta la página Menú de ajustes en juego (/hud).