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?
- Descargue la última versión desde el Keymaster
- Haga una copia de seguridad de su
config.lua - Reemplace todos los archivos excepto
config.lua - Consulte el Changelog para los nuevos parámetros de configuración
- Reinicie el servidor
Instalación
El script no se inicia
Verifique que:
- La carpeta esta correctamente nombrada
hz_carcontrol(sensible a mayúsculas) hz_libestá instalado e iniciado antes de HZ-CarControl- Su licencia FiveM es valida en el Keymaster
server.cfgcontieneensure hz_carcontrol
Error "Framework not detected"
La deteccion del framework se gestiona por hz_lib:
- Asegúrese de que
es_extendedoqb-coretieneensureantes dehz_lib hz_libdebe tenerensureantes dehz_carcontrol- Verifique la línea de consola de hz_lib para el estado de detección
El menú no se abre en absoluto
- Debe estar en un vehículo — el menú no se abre a pie
- Pruebe el comando
/carmenuen lugar del atajo de teclado - Verifique si otro script utiliza la tecla
H - Si
Config.Permissions.Enabled = true, asegúrese de tener el permiso ace correcto - Verifique la consola F8 en busca de errores
Funcionalidades
El cruise control no se activa
Causas comunes:- Su velocidad es inferior a
Config.CruiseControl.MinSpeed(por defecto: 20 km/h) Config.Features.CruiseControlestá definido comofalseConfig.CruiseControl.Enabledestá definido comofalse
El bloqueo de puertas no funciona
Si utiliza un recurso vehicle keys:- Verifique que
qbx_vehiclekeysoqb-vehiclekeysestá instalado e iniciado - El jugador debe poseer las llaves del vehículo
- Establezca
Config.DoorLock.KeysResourceen'native'para omitir la verificación de llaves
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
- Active
Config.Neons.SaveColor = true - Instale
oxmysqly asegúrese de que se inicia antes de HZ-CarControl - La tabla
hz_neon_colorsse crea automáticamente — verifique la consola del servidor en busca de errores SQL - 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:
- Verifique que ningún otro script fuerza el motor a seguir encendido
- 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.
