HZ Scripts

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?
  1. Download the latest version from Keymaster
  2. Make a backup of your config.lua
  3. Replace all files except config.lua
  4. Check the Changelog for any new config parameters
  5. Restart the server

Installation

The script doesn't start

Check that:

  • The folder is correctly named HZ-CarControl (case sensitive)
  • HZ-Bridge is installed and started before HZ-CarControl
  • Your FiveM license is valid on the Keymaster
  • server.cfg contains ensure HZ-CarControl
Error "Framework not detected"

Framework detection is handled by HZ-Bridge:

  • Make sure es_extended or qb-core is ensured before HZ-Bridge
  • HZ-Bridge must be ensured before HZ-CarControl
  • Check the HZ-Bridge console line for detection status
Menu doesn't open at all
  1. You must be in a vehicle — the menu won't open on foot
  2. Try the command /carmenu instead of the keybind
  3. Check if another script overrides the H key
  4. If Config.Permissions.Enabled = true, ensure you have the correct ace permission
  5. Check the F8 console for errors

Features

Cruise control doesn't activate Common causes:
  1. Your speed is below Config.CruiseControl.MinSpeed (default: 20 km/h)
  2. Config.Features.CruiseControl is set to false
  3. Config.CruiseControl.Enabled is set to false
Solution: Speed up above 20 km/h and try again.
Door lock doesn't work If using vehicle keys resource:
  • Check that qbx_vehiclekeys or qb-vehiclekeys is installed and started
  • The player must have the vehicle keys
  • Set Config.DoorLock.KeysResource to 'native' to bypass key checks
If using native mode:
  • Config.DoorLock.KeysResource = 'native' uses GTA native lock
  • Must be the driver to lock/unlock
Neon colors don't save between sessions
  1. Enable Config.Neons.SaveColor = true
  2. Install oxmysql and ensure it starts before HZ-CarControl
  3. The table hz_neon_colors is auto-created — check the server console for SQL errors
  4. 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:

  1. Check that no other script is forcing the engine on
  2. 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.


Can't find your answer? Join our Discord and open a ticket in #support!