FAQ

General

¿El script es compatible con mi framework?

HZ-CarControl soporta QBCore, QBX, ESX y el modo Standalone. El script detecta automáticamente su framework mediante el sistema hz_lib.

¿El script impacta en el rendimiento?

No. HZ-CarControl utiliza 0.00 ms en reposo del lado del cliente. El NUI solo está activo cuando el menú está abierto, y utiliza animaciones CSS solo GPU (sin blur, sin filtros pesados) para mantener 60 FPS.

¿Los jugadores pueden reasignar las teclas?

Sí. Todos los atajos utilizan el sistema RegisterKeyMapping de FiveM, lo que significa que los jugadores pueden reasignarlos en Ajustes → Atajos → FiveM en el juego.

¿Cuántos idiomas están soportados?

14 idiomas están incluidos: inglés, francés, español, alemán, portugués, italiano, neerlandés, polaco, turco, ruso, chino, japones, coreano y árabe. Establezca Config.Locale con el código de idioma deseado.

¿Cómo actualizar el script?
  1. Descargue la última versión desde el Keymaster
  2. Haga una copia de seguridad de su config.lua
  3. Reemplace todos los archivos excepto config.lua
  4. Consulte el Changelog para los nuevos parámetros de configuración
  5. Reinicie el servidor

Instalación

El script no se inicia

Verifique que:

  • La carpeta esta correctamente nombrada hz_carcontrol (sensible a mayúsculas)
  • hz_lib está instalado e iniciado antes de HZ-CarControl
  • Su licencia FiveM es valida en el Keymaster
  • server.cfg contiene ensure hz_carcontrol
Error "Framework not detected"

La deteccion del framework se gestiona por hz_lib:

  • Asegúrese de que es_extended o qb-core tiene ensure antes de hz_lib
  • hz_lib debe tener ensure antes de hz_carcontrol
  • Verifique la línea de consola de hz_lib para el estado de detección
El menú no se abre en absoluto
  1. Debe estar en un vehículo — el menú no se abre a pie
  2. Pruebe el comando /carmenu en lugar del atajo de teclado
  3. Verifique si otro script utiliza la tecla H
  4. Si Config.Permissions.Enabled = true, asegúrese de tener el permiso ace correcto
  5. Verifique la consola F8 en busca de errores

Funcionalidades

El cruise control no se activa Causas comunes:
  1. Su velocidad es inferior a Config.CruiseControl.MinSpeed (por defecto: 20 km/h)
  2. Config.Features.CruiseControl está definido como false
  3. Config.CruiseControl.Enabled está definido como false
Solución: acelere por encima de 20 km/h y reintente.
El bloqueo de puertas no funciona Si utiliza un recurso vehicle keys:
  • Verifique que qbx_vehiclekeys o qb-vehiclekeys está instalado e iniciado
  • El jugador debe poseer las llaves del vehículo
  • Establezca Config.DoorLock.KeysResource en 'native' para omitir la verificación de llaves
Si utiliza el modo native:
  • Config.DoorLock.KeysResource = 'native' utiliza el bloqueo nativo de GTA
  • Debe ser el conductor para bloquear/desbloquear
Los colores neon no se guardan entre sesiones
  1. Active Config.Neons.SaveColor = true
  2. Instale oxmysql y asegúrese de que se inicia antes de HZ-CarControl
  3. La tabla hz_neon_colors se crea automáticamente — verifique la consola del servidor en busca de errores SQL
  4. Los colores se guardan por placa de vehículo — las placas personalizadas funcionan mejor
El motor sigue encendido cuando salgo del vehículo

Es el comportamiento normal de GTA cuando el estado del motor se fuerza mediante script. HZ-CarControl incluye una detección automática de apagado del motor al salir del vehículo. Si el problema persiste:

  1. Verifique que ningún otro script fuerza el motor a seguir encendido
  2. Asegúrese de utilizar la última versión de HZ-CarControl
La rueda de radio sigue apareciendo cuando presiono Q

Active Config.Radio.DisableWheel = true para desactivar la rueda de radio nativa de GTA V. Esto obliga a los jugadores a utilizar el panel de radio de CarControl en su lugar.

La opción de techo descapotable no aparece

El botón de techo descapotable solo aparece cuando el vehículo posee efectivamente un techo descapotable. Los vehículos no descapotables no muestran esta opción.


Configuración

¿Cómo desactivar una funcionalidad especifica?

Establezca la funcionalidad en false en Config.Features:

Config.Features = {
    Neons = false,        -- Desactivar los controles neon
    CruiseControl = false, -- Desactivar el cruise control
    -- ... otras funcionalidades
}

La funcionalidad desactivada se ocultara del menú.

¿Cómo cambiar la posición del menú?

Modifique Config.Menu.Align:

Config.Menu = {
    Align = 'bottom-center',  -- Por defecto
    -- Opciones: 'top-left', 'top-center', 'top-right',
    --          'bottom-left', 'bottom-center', 'bottom-right'
}

¿Cómo agregar presets de colores neon personalizados?

Agregue entradas en Config.Neons.Presets:

Config.Neons = {
    Presets = {
        { r = 255, g = 0,   b = 0,   label = 'Red' },
        { r = 0,   g = 255, b = 0,   label = 'Green' },
        -- Agregue los suyos:
        { r = 255, g = 105, b = 180, label = 'Hot Pink' },
        { r = 0,   g = 191, b = 255, label = 'Deep Sky Blue' },
    },
}

¿Cómo restringir el menú solo a admins?

Active el sistema de permisos:

Config.Permissions = {
    Enabled = true,
    AcePermission = 'hz.carcontrol',
}

Luego agregue el ace en su server.cfg:

add_ace group.admin hz.carcontrol allow

¿Cómo agregar presets de limitador de velocidad personalizados?

Modifique Config.SpeedLimiter.Presets:

Config.SpeedLimiter = {
    Presets = { 30, 50, 80, 110, 130 },
    -- Cambie con sus propios valores:
    -- Presets = { 20, 40, 60, 90, 120 },
}

El limitador cicla a través de cada preset, luego se desactiva.


¿No encuentra su respuesta? Únase a nuestro Discord y abra un ticket en #support.