HZ Scripts

Instalación

Paso 1 — Descarga

Tras su compra en Tebex, descargue el script desde su FiveM Keymaster:

  1. Inicie sesión en keymaster.fivem.net
  2. Vaya a Granted Assets
  3. Descargue hz_carcontrol
Importante: utilice la misma cuenta FiveM vinculada a su licencia Tebex. El script esta protegido por escrow y requiere una licencia valida.

Paso 2 — Dependencias

Requeridas

  1. hz_lib (gratuito)
* Descargue desde la tienda Hz-Scripts — asset gratuito * Vea Instalación hz_lib para la configuración * Debe iniciarse antes de HZ-CarControl en server.cfg

Opcionales

  • oxmysql: necesario unicamente si activa la persistencia de colores neon (Config.Neons.SaveColor = true)
  • qbx\_vehiclekeys / qb-vehiclekeys: para la integración del bloqueo de puertas (detección automática, o utilice el modo native como alternativa)
hz_lib gestiona automáticamente toda la detección de framework y de notificaciones. Solo necesita configurarlo una vez.

Paso 3 — Archivos

  1. Extraiga el archivo hz_carcontrol.zip
  2. Coloque la carpeta hz_carcontrol en su directorio resources/
server/
├── resources/
│   ├── [hz]/
│   │   ├── hz_lib/
│   │   ├── hz_carcontrol/
│   │   │   ├── client/
│   │   │   ├── server/
│   │   │   ├── bridge/
│   │   │   ├── html/
│   │   │   ├── locales/
│   │   │   ├── shared/
│   │   │   ├── config.lua
│   │   │   └── fxmanifest.lua

Paso 4 — Base de datos (opcional)

Este paso es opcional. La base de datos solo es necesaria si desea guardar los colores neon por placa de vehículo.

Si activa Config.Neons.SaveColor = true, la tabla hz_neon_colors se creara automáticamente en el primer inicio (requiere oxmysql).

O 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;

Paso 5 — server.cfg

Agregue los recursos en su server.cfg en este orden:

# Framework (si corresponde)
ensure es_extended
# ensure qb-core

# Dependencia opcional
ensure oxmysql

# hz_lib (requerido — asset gratuito, antes de todos los Hz-Scripts)
ensure hz_lib

# Hz-Scripts
ensure hz_carcontrol

¡El orden de inicio es importante! Su framework y hz_lib deben iniciarse antes de HZ-CarControl.

Paso 6 — Configuración

Abra config.lua y adapte los parámetros a su servidor. Consulte la página de Configuración para los detalles de cada opción.

Parámetros esenciales a verificar:
  • Config.Locale: Idioma (14 idiomas disponibles)
  • Config.Menu.Keybind: Tecla para abrir el menú (por defecto: H)
  • Config.Features: Activar/desactivar las funcionalidades individualmente

Paso 7 — Verificación

  1. Inicie su servidor
  2. Conectese al juego
  3. Suba a un vehículo
  4. Presione H (por defecto) o escriba /carmenu
  5. El panel de control debería aparecer
  6. Verifique la consola del servidor: HZ-CarControl v3.0.0 — HZ Script
¡Listo! Si el menú se abre y puede activar las funcionalidades, el script funciona. Pase a la Configuración para personalizar.

Solución rápida de problemas

El script no se inicia

Verifique que:

  • La carpeta esta correctamente nombrada hz_carcontrol (sensible a mayúsculas)
  • hz_lib está instalado e iniciado antes de HZ-CarControl
  • Su licencia FiveM es valida en el Keymaster
  • El server.cfg contiene ensure hz_carcontrol
Error "Framework not detected"

La deteccion del framework se gestiona por hz_lib. Asegúrese de que:

  • es_extended o qb-core tiene correctamente ensure antes de hz_lib
  • hz_lib tiene ensure antes de hz_carcontrol
  • Verifique la línea de consola de hz_lib para confirmar que la detección es correcta
El menú no se abre
  • Verifique que está en un vehículo
  • Verifique que Config.Menu.Keybind no entra en conflicto con otro script
  • Verifique la consola F8 en busca de errores
  • Pruebe el comando de chat: /carmenu
  • Si Config.Permissions.Enabled = true, verifique que tiene el permiso ace requerido
Los colores neon no se guardan
  • Active Config.Neons.SaveColor = true en config.lua
  • Asegúrese de que oxmysql está instalado e iniciado
  • Verifique la consola del servidor en busca de errores de base de datos
  • La tabla hz_neon_colors se crea automáticamente — si no, importe el SQL manualmente