FAQ

HZ-CarControl suporta QBCore, QBX, ESX e o modo Standalone. O script detecta automaticamente seu framework atraves do sistema hz_lib.

Nao. HZ-CarControl utiliza 0.00 ms em repouso no lado do cliente. A NUI so e ativa quando o menu esta aberto, e usa animacoes CSS somente GPU (sem blur, sem filtros pesados) para manter 60 FPS.

Sim. Todos os atalhos usam o sistema RegisterKeyMapping do FiveM, o que significa que os jogadores podem reatribui-los em Configuracoes → Atalhos → FiveM no jogo.

14 idiomas estao inclusos: ingles, frances, espanhol, alemao, portugues, italiano, holandes, polones, turco, russo, chines, japones, coreano e arabe. Defina Config.Locale com o codigo de idioma desejado.

1. Baixe a versao mais recente no Keymaster
2. Faca um backup do seu config.lua
3. Substitua todos os arquivos exceto config.lua
4. Consulte o Changelog para novos parametros de configuracao
5. Reinicie o servidor

Verifique que:

• A pasta esta corretamente nomeada hz_carcontrol (sensivel a maiusculas/minusculas)
• O hz_lib esta instalado e iniciado antes do HZ-CarControl
• Sua licenca FiveM e valida no Keymaster
• O server.cfg contem ensure hz_carcontrol

A deteccao do framework e gerenciada pelo hz_lib:

• Certifique-se de que es_extended ou qb-core esta com ensure antes do hz_lib
• O hz_lib deve estar com ensure antes do hz_carcontrol
• Verifique a linha do console do hz_lib para o status de deteccao

1. Voce deve estar em um veiculo — o menu nao abre a pe
2. Tente o comando /carmenu em vez do atalho de teclado
3. Verifique se outro script esta usando a tecla H
4. Se Config.Permissions.Enabled = true, certifique-se de ter a permissao ace correta
5. Verifique o console F8 para erros

1. Sua velocidade esta abaixo de Config.CruiseControl.MinSpeed (padrao: 20 km/h)
2. Config.Features.CruiseControl esta definido como false
3. Config.CruiseControl.Enabled esta definido como false

• Verifique se qbx_vehiclekeys ou qb-vehiclekeys esta instalado e iniciado
• O jogador deve possuir as chaves do veiculo
• Defina Config.DoorLock.KeysResource como 'native' para contornar a verificacao de chaves

• Config.DoorLock.KeysResource = 'native' usa o trancamento nativo do GTA
• Voce deve ser o motorista para trancar/destrancar

1. Ative Config.Neons.SaveColor = true
2. Instale o oxmysql e certifique-se de que inicia antes do HZ-CarControl
3. A tabela hz_neon_colors e criada automaticamente — verifique o console do servidor para erros SQL
4. As cores sao salvas por placa de veiculo — placas personalizadas funcionam melhor

Esse e o comportamento normal do GTA quando o estado do motor e forcado via script. HZ-CarControl inclui deteccao automatica de desligamento do motor quando voce sai do veiculo. Se o problema persistir:

1. Verifique se nenhum outro script esta forcando o motor a ficar ligado
2. Certifique-se de usar a versao mais recente do HZ-CarControl

Ative Config.Radio.DisableWheel = true para desativar a roda do radio nativa do GTA V. Isso forca os jogadores a usar o painel de radio do CarControl.

O botao de teto conversivel so aparece quando o veiculo realmente possui um teto conversivel. Veiculos nao conversiveis nao exibem esta opcao.

Defina a funcionalidade como false em Config.Features:

Config.Features = {
    Neons = false,        -- Desativar controles neon
    CruiseControl = false, -- Desativar cruise control
    -- ... outras funcionalidades
}

A funcionalidade desativada sera ocultada do menu.

Modifique Config.Menu.Align:

Config.Menu = {
    Align = 'bottom-center',  -- Padrao
    -- Opcoes: 'top-left', 'top-center', 'top-right',
    --          'bottom-left', 'bottom-center', 'bottom-right'
}

Adicione entradas em Config.Neons.Presets:

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

Ative o sistema de permissoes:

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

Depois adicione o ace no seu server.cfg:

add_ace group.admin hz.carcontrol allow

Modifique Config.SpeedLimiter.Presets:

Config.SpeedLimiter = {
    Presets = { 30, 50, 80, 110, 130 },
    -- Altere com seus proprios valores:
    -- Presets = { 20, 40, 60, 90, 120 },
}

O limitador alterna entre cada preset e depois desativa.