FAQ
General
Is the script compatible with my framework?
HZ-CarControl supports QBCore, QBX, ESX, and Standalone mode. The script automatically detects your framework via the HZ-Bridge system.
Does the script impact performance?
No. HZ-CarControl uses 0.00 ms idle on client side. The NUI is only active when the menu is open, and uses GPU-only CSS animations (no blur, no heavy filters) to maintain 60 FPS.
Can players rebind the keys?
Yes. All keybinds use FiveM's RegisterKeyMapping system, which means players can rebind them in Settings → Key Bindings → FiveM in-game.
How many languages are supported?
14 languages are included: English, French, Spanish, German, Portuguese, Italian, Dutch, Polish, Turkish, Russian, Chinese, Japanese, Korean, and Arabic. Set Config.Locale to the desired language code.
How do I update the script?
- Download the latest version from Keymaster
- Make a backup of your
config.lua - Replace all files except
config.lua - Check the Changelog for any new config parameters
- Restart the server
Installation
The script doesn't start
Check that:
- The folder is correctly named
HZ-CarControl(case sensitive) HZ-Bridgeis installed and started before HZ-CarControl- Your FiveM license is valid on the Keymaster
server.cfgcontainsensure HZ-CarControl
Error "Framework not detected"
Framework detection is handled by HZ-Bridge:
- Make sure
es_extendedorqb-coreisensured beforeHZ-Bridge HZ-Bridgemust beensured beforeHZ-CarControl- Check the HZ-Bridge console line for detection status
Menu doesn't open at all
- You must be in a vehicle — the menu won't open on foot
- Try the command
/carmenuinstead of the keybind - Check if another script overrides the
Hkey - If
Config.Permissions.Enabled = true, ensure you have the correct ace permission - Check the F8 console for errors
Features
Cruise control doesn't activate
Common causes:- Your speed is below
Config.CruiseControl.MinSpeed(default: 20 km/h) Config.Features.CruiseControlis set tofalseConfig.CruiseControl.Enabledis set tofalse
Door lock doesn't work
If using vehicle keys resource:- Check that
qbx_vehiclekeysorqb-vehiclekeysis installed and started - The player must have the vehicle keys
- Set
Config.DoorLock.KeysResourceto'native'to bypass key checks
Config.DoorLock.KeysResource = 'native'uses GTA native lock- Must be the driver to lock/unlock
Neon colors don't save between sessions
- Enable
Config.Neons.SaveColor = true - Install
oxmysqland ensure it starts before HZ-CarControl - The table
hz_neon_colorsis auto-created — check the server console for SQL errors - Colors are saved per vehicle plate — custom plates work best
Engine stays on when I exit the vehicle
This is normal GTA behavior when the engine state is forced via script. HZ-CarControl includes automatic engine-off detection when you exit the vehicle. If the issue persists:
- Check that no other script is forcing the engine on
- Make sure you're using the latest version of HZ-CarControl
Radio wheel still shows when pressing Q
Enable Config.Radio.DisableWheel = true to disable the native GTA V radio wheel. This forces players to use the CarControl radio panel instead.
Convertible roof option doesn't show
The convertible roof button only appears when the vehicle actually has a convertible roof. Non-convertible vehicles won't show this option.
Configuration
How do I disable a specific feature?
Set the feature to false in Config.Features:
Config.Features = {
Neons = false, -- Disable neon controls
CruiseControl = false, -- Disable cruise control
-- ... other features
}
The disabled feature will be hidden from the menu.
How do I change the menu position?
Change Config.Menu.Align:
Config.Menu = {
Align = 'bottom-center', -- Default
-- Options: 'top-left', 'top-center', 'top-right',
-- 'bottom-left', 'bottom-center', 'bottom-right'
}
How do I add custom neon color presets?
Add entries to Config.Neons.Presets:
Config.Neons = {
Presets = {
{ r = 255, g = 0, b = 0, label = 'Red' },
{ r = 0, g = 255, b = 0, label = 'Green' },
-- Add your own:
{ r = 255, g = 105, b = 180, label = 'Hot Pink' },
{ r = 0, g = 191, b = 255, label = 'Deep Sky Blue' },
},
}
How do I restrict the menu to admins only?
Enable the permission system:
Config.Permissions = {
Enabled = true,
AcePermission = 'hz.carcontrol',
}
Then add the ace in your server.cfg:
add_ace group.admin hz.carcontrol allow
How do I add custom speed limiter presets?
Modify Config.SpeedLimiter.Presets:
Config.SpeedLimiter = {
Presets = { 30, 50, 80, 110, 130 },
-- Change to your own values:
-- Presets = { 20, 40, 60, 90, 120 },
}
The limiter cycles through each preset, then turns off.
