Configuración

Toda la configuración vive en un único archivo: config.lua.
No modifiques ningún otro archivo — los cambios en client/main.lua o html/app.js se perderán en las actualizaciones.

Framework

Config.Framework = 'auto'
-- 'auto'       → detecta ESX, QBCore, qbx_core o standalone automáticamente
-- 'esx'        → fuerza ESX
-- 'qbcore'     → fuerza QBCore
-- 'qbox'       → fuerza qbx_core
-- 'standalone' → desactiva todos los bridges de framework

Usa 'auto' salvo que tengas más de un framework instalado (poco común) o quieras forzar standalone por compatibilidad.

Anillos de stats

Config.Stats = {
  health  = true,   -- Vida (nativo GTA)
  armor   = true,   -- Armadura (nativo GTA)
  hunger  = true,   -- Hambre (ESX / QBCore / QBox — se oculta en standalone)
  thirst  = true,   -- Sed (ESX / QBCore / QBox — se oculta en standalone)
  stress  = true,   -- Estrés (QBCore / QBox — se oculta en ESX/standalone)
  stamina = true,   -- Stamina (nativo GTA)
  oxygen  = true,   -- Oxígeno (nativo GTA, solo visible bajo agua)
  voice   = true,   -- Voz (requiere pma-voice)
}

Cambia cualquier valor a false para desactivar ese anillo permanentemente en el servidor. Los jugadores también pueden ocultarlos individualmente desde /hub.

Velocímetro

Config.Vehicle = {
  enabled    = true,
  units      = 'kmh',        -- 'kmh' | 'mph'
  showFuel   = true,
  showGear   = true,
  showSeatbelt = true,

  -- Limitador de velocidad
  speedLimiterEnabled = true,
  speedLimiterKey     = 'LSHIFT',   -- tecla RegisterKeyMapping (rebindeable en FiveM Settings)
  speedLimiterMin     = 10,         -- km/h mínimos para activar
}

Limitador de velocidad

Pulsa la tecla configurada (LSHIFT por defecto) mientras conduces para bloquear la velocidad actual como máximo. Pulsa de nuevo para liberar. El limitador se desactiva automáticamente si:

Sales del vehículo.
Cambias de vehículo.
Dejas de ser el conductor.

El jugador puede re-asignar la tecla en: FiveM → Settings → Key Bindings → FiveM.

Script de combustible

Config.FuelScript = 'auto'
-- 'auto'        → detecta automáticamente
-- 'ps-fuel'
-- 'LegacyFuel'
-- 'ox_fuel'
-- 'qs-fuel'
-- 'cdn-fuel'
-- 'hfuel'
-- 'native'      → usa el combustible nativo de GTA (siempre al 100 %)

Si la detección automática falla (combustible siempre a 0 o a 100), pon el nombre exacto de tu script de combustible.

Aviso de reserva: cuando el nivel baja al ≤20%, se muestra un LED naranja en el velocímetro y suena una campanilla de aviso estilo dashboard.

Cinto de seguridad

Config.Seatbelt = {
  warnSpeed  = 30,   -- km/h a partir del cual suena el aviso si no llevas cinto
  ejectSpeed = 35,   -- delta de deceleración (km/h) para eyectar sin cinto
}

El sistema usa delta de deceleración: mide la diferencia de velocidad entre ticks. Si la reducción es ≥ ejectSpeed km/h en 100ms y el jugador no tiene cinto, se eyecta con fuerza y duración proporcionales a la severidad.

Tecla: B por defecto (configurable via RegisterKeyMapping → rebindeable en Settings).

Para desactivar la eyección pero mantener el aviso sonoro, pon ejectSpeed = 9999.

Refresh rates

Config.Tick = {
  player  = 250,   -- ms entre actualizaciones de stats
  vehicle = 50,    -- ms entre actualizaciones del velocímetro
}

Comando de toggle

Config.ToggleCommand = 'hud'   -- escribe /hud en el chat para ocultar/mostrar el HUD

Cambia el nombre del comando si ya tienes otro recurso usando /hud.

Branding

Config.ShowLogo  = true
Config.LogoPath  = 'assets/logo.svg'  -- ruta relativa a html/
Config.LogoLabel = 'FiveRank'         -- texto bajo el logo ('' para ocultar)

Formatos de logo soportados: SVG, PNG, WEBP.
Coloca el archivo en html/assets/ y actualiza Config.LogoPath.

Idioma

Config.Locale = 'es'   -- es | en | pt | fr | de

El jugador puede cambiar su idioma personal desde el panel /hub — se guarda por KVP.

→ Ver Idiomas para más detalles.

Resumen de todas las opciones

Clave	Por defecto	Descripción
`Config.Framework`	`'auto'`	Framework a usar
`Config.Stats.health`	`true`	Anillo de vida
`Config.Stats.armor`	`true`	Anillo de armadura
`Config.Stats.hunger`	`true`	Anillo de hambre
`Config.Stats.thirst`	`true`	Anillo de sed
`Config.Stats.stress`	`true`	Anillo de estrés
`Config.Stats.stamina`	`true`	Anillo de stamina
`Config.Stats.oxygen`	`true`	Anillo de oxígeno
`Config.Stats.voice`	`true`	Anillo de voz
`Config.Vehicle.enabled`	`true`	Velocímetro flotante
`Config.Vehicle.units`	`'kmh'`	Unidades de velocidad
`Config.Vehicle.showFuel`	`true`	Mostrar combustible
`Config.Vehicle.showGear`	`true`	Mostrar marcha
`Config.Vehicle.showSeatbelt`	`true`	Mostrar cinturón
`Config.Vehicle.speedLimiterEnabled`	`true`	Limitador de velocidad
`Config.Vehicle.speedLimiterKey`	`'LSHIFT'`	Tecla del limitador
`Config.Vehicle.speedLimiterMin`	`10`	km/h mínimos para activar
`Config.FuelScript`	`'auto'`	Script de combustible
`Config.Seatbelt.warnSpeed`	`30`	Velocidad de aviso (km/h)
`Config.Seatbelt.ejectSpeed`	`35`	Delta de deceleración para eyección
`Config.Tick.player`	`250`	Refresh stats (ms)
`Config.Tick.vehicle`	`50`	Refresh velocímetro (ms)
`Config.ToggleCommand`	`'hud'`	Comando para ocultar/mostrar
`Config.ShowLogo`	`true`	Mostrar logo en pantalla
`Config.LogoPath`	`'assets/logo.svg'`	Ruta al logo
`Config.LogoLabel`	`'FiveRank'`	Etiqueta del servidor
`Config.Locale`	`'es'`	Idioma del HUD

Siguiente paso

→ Idiomas

Framework​

Anillos de stats​

Velocímetro​

Limitador de velocidad​

Script de combustible​

Cinto de seguridad​

Refresh rates​

Comando de toggle​

Branding​

Idioma​

Resumen de todas las opciones​

Siguiente paso​