HZ Scripts

Instalacao

Etapa 1 — Download

Apos sua compra no Tebex, baixe o script no seu FiveM Keymaster:

  1. Faca login em keymaster.fivem.net
  2. Va em Granted Assets
  3. Baixe o hz_carcontrol
Importante: utilize a mesma conta FiveM vinculada a sua licenca Tebex. O script e protegido por escrow e requer uma licenca valida.

Etapa 2 — Dependencias

Obrigatorias

  1. hz_lib (gratuito)
* Baixe na loja Hz-Scripts — asset gratuito * Veja Instalacao hz_lib para a configuracao * Deve iniciar antes do HZ-CarControl no server.cfg

Opcionais

  • oxmysql: necessario apenas se voce ativar a persistencia de cores neon (Config.Neons.SaveColor = true)
  • qbx\_vehiclekeys / qb-vehiclekeys: para integracao do trancamento de portas (deteccao automatica, ou usar o modo native como fallback)
hz_lib gerencia automaticamente toda a deteccao de framework e notificacoes. Voce so precisa configura-lo uma unica vez.

Etapa 3 — Arquivos

  1. Extraia o arquivo hz_carcontrol.zip
  2. Coloque a pasta hz_carcontrol no seu diretorio resources/
server/
├── resources/
│   ├── [hz]/
│   │   ├── hz_lib/
│   │   ├── hz_carcontrol/
│   │   │   ├── client/
│   │   │   ├── server/
│   │   │   ├── bridge/
│   │   │   ├── html/
│   │   │   ├── locales/
│   │   │   ├── shared/
│   │   │   ├── config.lua
│   │   │   └── fxmanifest.lua

Etapa 4 — Banco de dados (opcional)

Esta etapa e opcional. O banco de dados so e necessario se voce quiser salvar as cores neon por placa de veiculo.

Se voce ativar Config.Neons.SaveColor = true, a tabela hz_neon_colors sera criada automaticamente na primeira inicializacao (requer oxmysql).

Ou importe manualmente:

CREATE TABLE IF NOT EXISTS `hz_neon_colors` (
  `plate` VARCHAR(12) NOT NULL PRIMARY KEY,
  `r` TINYINT UNSIGNED NOT NULL DEFAULT 0,
  `g` TINYINT UNSIGNED NOT NULL DEFAULT 0,
  `b` TINYINT UNSIGNED NOT NULL DEFAULT 0
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

Etapa 5 — server.cfg

Adicione os recursos no seu server.cfg nesta ordem:

# Framework (se aplicavel)
ensure es_extended
# ensure qb-core

# Dependencia opcional
ensure oxmysql

# hz_lib (obrigatorio — asset gratuito, antes de todos os Hz-Scripts)
ensure hz_lib

# Hz-Scripts
ensure hz_carcontrol

A ordem de inicializacao e importante! Seu framework e o hz_lib devem iniciar antes do HZ-CarControl.

Etapa 6 — Configuracao

Abra o config.lua e adapte os parametros ao seu servidor. Consulte a pagina Configuracao para detalhes de cada opcao.

Parametros essenciais a verificar:
  • Config.Locale: Idioma (14 idiomas disponiveis)
  • Config.Menu.Keybind: Tecla para abrir o menu (padrao: H)
  • Config.Features: Ativar/desativar funcionalidades individualmente

Etapa 7 — Verificacao

  1. Inicie seu servidor
  2. Conecte-se ao jogo
  3. Entre em um veiculo
  4. Pressione H (padrao) ou digite /carmenu
  5. O painel de controle deve aparecer
  6. Verifique o console do servidor: HZ-CarControl v3.0.0 — HZ Script
Pronto! Se o menu abrir e voce puder ativar as funcionalidades, o script esta funcionando. Va para Configuracao para personalizar.

Solucao rapida de problemas

O script nao inicia

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
Erro "Framework not detected"

A deteccao do framework e gerenciada pelo hz_lib. Certifique-se de que:

  • es_extended ou qb-core esta corretamente com ensure antes do hz_lib
  • O hz_lib esta com ensure antes do hz_carcontrol
  • Verifique a linha do console do hz_lib para confirmar que a deteccao esta correta
O menu nao abre
  • Verifique se voce esta em um veiculo
  • Verifique se Config.Menu.Keybind nao conflita com outro script
  • Verifique o console F8 para erros
  • Tente o comando no chat: /carmenu
  • Se Config.Permissions.Enabled = true, verifique se voce tem a permissao ace necessaria
As cores neon nao sao salvas
  • Ative Config.Neons.SaveColor = true no config.lua
  • Certifique-se de que o oxmysql esta instalado e iniciado
  • Verifique o console do servidor para erros de banco de dados
  • A tabela hz_neon_colors e criada automaticamente — caso contrario, importe o SQL manualmente