Docs /Ultra HUD/Configuración
v1.0.0

Configuración — foltone_ultra_hud

Todos los ajustes están en config.lua. La mayoría de estos pueden ser modificados en tiempo real a través del panel de administración.

Idioma

Config.locale = "en" -- "en", "fr", etc.

Los archivos de traducción están en locales/en.lua, locales/fr.lua. Puedes agregar tu propio idioma creando un nuevo archivo (ej. locales/de.lua).

General

OpciónTipoPor defectoDescripción
disableMinimapbooleanfalseOcultar completamente el minimapa de GTA
disableMinimapHealtharmourbooleantrueOcultar las barras predeterminadas de salud/armadura de GTA en el minimapa
disableNoMoneybooleantrueOcultar campos de dinero cuando el saldo es 0
disableArmourbooleantrueOcultar automáticamente la barra de armadura cuando el valor es 0
disableApneabooleantrueOcultar automáticamente la barra de apnea cuando está llena (no bajo el agua)
disableStaminabooleantrueOcultar automáticamente la barra de resistencia cuando está llena (no corriendo)

Visibilidad

Cada elemento del HUD puede activarse o desactivarse individualmente. Estos sirven como valores predeterminados y pueden ser modificados a través del panel de administración.

OpciónTipoPor defectoDescripción
idbooleantrueMostrar ID del jugador en el servidor
jobbooleantrueMostrar nombre del trabajo y rango
job2booleanfalseMostrar segundo trabajo / banda (ESX: job2, QB: gang)
moneybooleantrueMostrar efectivo (ESX: money, QB: cash)
bankbooleantrueMostrar saldo bancario
black_moneybooleantrueMostrar dinero sucio (ESX: black_money, QB: crypto)
positionbooleantrueMostrar nombre de la calle
healthbooleantrueMostrar barra de salud
armourbooleantrueMostrar barra de armadura
hungerbooleantrueMostrar barra de hambre
thirstbooleantrueMostrar barra de sed
staminabooleantrueMostrar barra de resistencia
apneabooleantrueMostrar barra de apnea
speedometerbooleantrueMostrar velocímetro en vehículo

Pantalla

OpciónTipoPor defectoDescripción
type_needs_displaystring"bar"Modo de visualización de estado: "bar", "circle", "square", "hexagon", "text"
shape_fill_modestring"stroke"Estilo de relleno de forma: "stroke" (progreso de contorno) o "fill" (relleno sólido de abajo hacia arriba)
metricstring"kmh"Unidad de velocidad: "kmh" o "mph"

Colores Predeterminados

Los colores se definen como arrays RGBA {R, G, B, A} con valores de 0 a 255.

Config.colorText    = {255, 255, 255, 255}  -- Blanco
Config.healthColor  = {53, 154, 71, 255}    -- Verde
Config.armourColor  = {51, 131, 236, 255}   -- Azul
Config.hungerColor  = {245, 166, 35, 255}   -- Naranja
Config.thirstColor  = {0, 168, 255, 255}    -- Cian
Config.staminaColor = {245, 220, 63, 255}   -- Amarillo
Config.apneaColor   = {123, 153, 229, 255}  -- Azul claro
Config.fuelColor    = {255, 0, 0, 255}      -- Rojo

Todos los colores se pueden cambiar a través de los selectores de color del panel de administración.

Notificaciones

Estos sirven como valores predeterminados. Pueden ser modificados a través del panel de administración.

OpciónTipoPor defectoDescripción
notifPositionstring"top-center"Posición de las notificaciones en pantalla
notifWidthnumber25Ancho en unidades vw (ancho del viewport)
notifScalenumber1.0Multiplicador de escala (0.5 a 2.0)

Posiciones disponibles: "top-left", "top-center", "top-right", "bottom-left", "bottom-center", "bottom-right"

Cuando se establece en bottom-left, las notificaciones se posicionan automáticamente encima del minimapa de GTA y coinciden con su ancho (15vw).

Menú de Administración

OpciónTipoPor defectoDescripción
adminCommandstring"hudadmin"Comando de chat para abrir el panel de administración
adminGroupstable{"admin", "superadmin", "god"}Grupos del framework con acceso al panel

Para standalone, puedes definir una verificación de administrador personalizada:

Config.customAdminCheck = function(src)
    return IsPlayerAceAllowed(src, "admin")
end

El permiso de administrador se verifica en este orden:

  1. Verificación de grupo del framework (grupo ESX, permiso QBCore)
  2. Respaldo de permiso ACE (command.<adminCommand>)