HZ Scripts

Installation

Étape 1 — Téléchargement

Après votre achat sur Tebex, téléchargez le script depuis votre FiveM Keymaster :

  1. Connectez-vous sur keymaster.fivem.net
  2. Allez dans Granted Assets
  3. Téléchargez hz_carcontrol
Important : utilisez le même compte FiveM que celui lié à votre licence Tebex. Le script est protégé par escrow et nécessite une licence valide.

Étape 2 — Dépendances

Requises

  1. hz_lib (gratuit)
* Téléchargez depuis la boutique Hz-Scripts — asset gratuit * Voir Installation hz_lib pour la mise en place * Doit démarrer avant HZ-CarControl dans server.cfg

Optionnelles

  • oxmysql : nécessaire uniquement si vous activez la persistance des couleurs néon (Config.Neons.SaveColor = true)
  • qbx\_vehiclekeys / qb-vehiclekeys : pour l'intégration du verrouillage des portes (détection automatique, ou utiliser le mode native en secours)
hz_lib gère automatiquement toute la détection de framework et de notifications. Vous n'avez besoin de le configurer qu'une seule fois.

Étape 3 — Fichiers

  1. Extrayez l'archive hz_carcontrol.zip
  2. Placez le dossier hz_carcontrol dans votre répertoire resources/
server/
├── resources/
│   ├── [hz]/
│   │   ├── hz_lib/
│   │   ├── hz_carcontrol/
│   │   │   ├── client/
│   │   │   ├── server/
│   │   │   ├── bridge/
│   │   │   ├── html/
│   │   │   ├── locales/
│   │   │   ├── shared/
│   │   │   ├── config.lua
│   │   │   └── fxmanifest.lua

Étape 4 — Base de données (optionnel)

Cette étape est optionnelle. La base de données n'est nécessaire que si vous souhaitez sauvegarder les couleurs néon par plaque de véhicule.

Si vous activez Config.Neons.SaveColor = true, la table hz_neon_colors sera créée automatiquement au premier démarrage (nécessite oxmysql).

Ou importez manuellement :

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;

Étape 5 — server.cfg

Ajoutez les ressources dans votre server.cfg dans cet ordre :

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

# Dependance optionnelle
ensure oxmysql

# hz_lib (requis — asset gratuit, avant tous les Hz-Scripts)
ensure hz_lib

# Hz-Scripts
ensure hz_carcontrol

L'ordre de démarrage est important ! Votre framework et hz_lib doivent démarrer avant HZ-CarControl.

Étape 6 — Configuration

Ouvrez config.lua et adaptez les paramètres à votre serveur. Consultez la page Configuration pour les détails de chaque option.

Paramètres essentiels à vérifier :
  • Config.Locale : Langue (14 langues disponibles)
  • Config.Menu.Keybind : Touche pour ouvrir le menu (par défaut : H)
  • Config.Features : Activer/desactiver les fonctionnalités individuellement

Étape 7 — Vérification

  1. Démarrez votre serveur
  2. Connectez-vous en jeu
  3. Montez dans un véhicule
  4. Appuyez sur H (par défaut) ou tapez /carmenu
  5. Le panneau de contrôle devrait apparaître
  6. Vérifiez la console serveur : HZ-CarControl v3.0.0 — HZ Script
Termine ! Si le menu s'ouvre et que vous pouvez activer les fonctionnalités, le script fonctionne. Passez à la Configuration pour personnaliser.

Dépannage rapide

Le script ne démarre pas

Vérifiez que :

  • Le dossier est correctement nommé hz_carcontrol (sensible à la casse)
  • hz_lib est installé et démarre avant HZ-CarControl
  • Votre licence FiveM est valide sur le Keymaster
  • Le server.cfg contient ensure hz_carcontrol
Erreur "Framework not detected"

La detection du framework est gérée par hz_lib. Assurez-vous que :

  • es_extended ou qb-core est correctement ensure avant hz_lib
  • hz_lib est ensure avant hz_carcontrol
  • Vérifiez la ligne console de hz_lib pour confirmer que la détection est correcte
Le menu ne s'ouvre pas
  • Vérifiez que vous êtes dans un véhicule
  • Vérifiez que Config.Menu.Keybind n'entre pas en conflit avec un autre script
  • Vérifiez la console F8 pour les erreurs
  • Essayez la commande chat : /carmenu
  • Si Config.Permissions.Enabled = true, vérifiez que vous avez la permission ace requise
Les couleurs néon ne se sauvegardent pas
  • Activez Config.Neons.SaveColor = true dans config.lua
  • Assurez-vous que oxmysql est installé et démarre
  • Vérifiez la console serveur pour les erreurs de base de données
  • La table hz_neon_colors est créée automatiquement — sinon, importez le SQL manuellement