HZ Scripts

Installation

Etape 1 — Telechargement

Apres votre achat sur Tebex, telechargez le script depuis votre FiveM Keymaster :

  1. Connectez-vous sur keymaster.fivem.net
  2. Allez dans Granted Assets
  3. Telechargez HZ-CarControl
Important : utilisez le meme compte FiveM que celui lie a votre licence Tebex. Le script est protege par escrow et necessite une licence valide.

Etape 2 — Dependances

Requises

  1. HZ-Bridge (gratuit)
* Telechargez depuis la boutique Hz-Scripts — asset gratuit * Voir Installation HZ-Bridge pour la mise en place * Doit demarrer avant HZ-CarControl dans server.cfg

Optionnelles

  • oxmysql : necessaire uniquement si vous activez la persistance des couleurs neon (Config.Neons.SaveColor = true)
  • qbx\_vehiclekeys / qb-vehiclekeys : pour l'integration du verrouillage des portes (detection automatique, ou utiliser le mode native en secours)
HZ-Bridge gere automatiquement toute la detection de framework et de notifications. Vous n'avez besoin de le configurer qu'une seule fois.

Etape 3 — Fichiers

  1. Extrayez l'archive HZ-CarControl.zip
  2. Placez le dossier HZ-CarControl dans votre repertoire resources/
server/
├── resources/
│   ├── [hz]/
│   │   ├── HZ-Bridge/
│   │   ├── HZ-CarControl/
│   │   │   ├── client/
│   │   │   ├── server/
│   │   │   ├── bridge/
│   │   │   ├── html/
│   │   │   ├── locales/
│   │   │   ├── shared/
│   │   │   ├── config.lua
│   │   │   └── fxmanifest.lua

Etape 4 — Base de donnees (optionnel)

Cette etape est optionnelle. La base de donnees n'est necessaire que si vous souhaitez sauvegarder les couleurs neon par plaque de vehicule.

Si vous activez Config.Neons.SaveColor = true, la table hz_neon_colors sera creee automatiquement au premier demarrage (necessite 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;

Etape 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-Bridge (requis — asset gratuit, avant tous les Hz-Scripts)

ensure HZ-Bridge


Hz-Scripts

ensure HZ-CarControl
L'ordre de demarrage est important ! Votre framework et HZ-Bridge doivent demarrer avant HZ-CarControl.

Etape 6 — Configuration

Ouvrez config.lua et adaptez les parametres a votre serveur. Consultez la page Configuration pour les details de chaque option.

Parametres essentiels a verifier :
  • Config.Locale : Langue (14 langues disponibles)
  • Config.Menu.Keybind : Touche pour ouvrir le menu (par defaut : H)
  • Config.Features : Activer/desactiver les fonctionnalites individuellement

Etape 7 — Verification

  1. Demarrez votre serveur
  2. Connectez-vous en jeu
  3. Montez dans un vehicule
  4. Appuyez sur H (par defaut) ou tapez /carmenu
  5. Le panneau de controle devrait apparaitre
  6. Verifiez la console serveur : HZ-CarControl v3.0.0 — HZ Script
Termine ! Si le menu s'ouvre et que vous pouvez activer les fonctionnalites, le script fonctionne. Passez a la Configuration pour personnaliser.

Depannage rapide

Le script ne demarre pas

Verifiez que :

  • Le dossier est correctement nomme HZ-CarControl (sensible a la casse)
  • HZ-Bridge est installe et demarre 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 geree par HZ-Bridge. Assurez-vous que :

  • es_extended ou qb-core est correctement ensure avant HZ-Bridge
  • HZ-Bridge est ensure avant HZ-CarControl
  • Verifiez la ligne console de HZ-Bridge pour confirmer que la detection est correcte
Le menu ne s'ouvre pas
  • Verifiez que vous etes dans un vehicule
  • Verifiez que Config.Menu.Keybind n'entre pas en conflit avec un autre script
  • Verifiez la console F8 pour les erreurs
  • Essayez la commande chat : /carmenu
  • Si Config.Permissions.Enabled = true, verifiez que vous avez la permission ace requise
Les couleurs neon ne se sauvegardent pas
  • Activez Config.Neons.SaveColor = true dans config.lua
  • Assurez-vous que oxmysql est installe et demarre
  • Verifiez la console serveur pour les erreurs de base de donnees
  • La table hz_neon_colors est creee automatiquement — sinon, importez le SQL manuellement