HZ Scripts

FAQ

General

Le script est-il compatible avec mon framework ?

HZ-CarControl supporte QBCore, QBX, ESX et le mode Standalone. Le script detecte automatiquement votre framework via le systeme HZ-Bridge.

Le script impacte-t-il les performances ?

Non. HZ-CarControl utilise 0.00 ms au repos cote client. Le NUI n'est actif que lorsque le menu est ouvert, et utilise des animations CSS GPU uniquement (pas de blur, pas de filtres lourds) pour maintenir 60 FPS.

Les joueurs peuvent-ils reassigner les touches ?

Oui. Tous les raccourcis utilisent le systeme RegisterKeyMapping de FiveM, ce qui signifie que les joueurs peuvent les reassigner dans Parametres → Raccourcis → FiveM en jeu.

Combien de langues sont supportees ?

14 langues sont incluses : anglais, francais, espagnol, allemand, portugais, italien, neerlandais, polonais, turc, russe, chinois, japonais, coreen et arabe. Definissez Config.Locale avec le code de langue souhaite.

Comment mettre a jour le script ?
  1. Telechargez la derniere version depuis le Keymaster
  2. Faites une sauvegarde de votre config.lua
  3. Remplacez tous les fichiers sauf config.lua
  4. Consultez le Changelog pour les nouveaux parametres de configuration
  5. Redemarrez le serveur

Installation

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
  • 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 ensure avant HZ-Bridge
  • HZ-Bridge doit etre ensure avant HZ-CarControl
  • Verifiez la ligne console de HZ-Bridge pour le statut de detection
Le menu ne s'ouvre pas du tout
  1. Vous devez etre dans un vehicule — le menu ne s'ouvre pas a pied
  2. Essayez la commande /carmenu au lieu du raccourci clavier
  3. Verifiez si un autre script utilise la touche H
  4. Si Config.Permissions.Enabled = true, assurez-vous d'avoir la permission ace correcte
  5. Verifiez la console F8 pour les erreurs

Fonctionnalites

Le cruise control ne s'active pas Causes courantes :
  1. Votre vitesse est inferieure a Config.CruiseControl.MinSpeed (par defaut : 20 km/h)
  2. Config.Features.CruiseControl est defini sur false
  3. Config.CruiseControl.Enabled est defini sur false
Solution : accelerez au-dessus de 20 km/h et reessayez.
Le verrouillage des portes ne fonctionne pas Si vous utilisez une ressource vehicle keys :
  • Verifiez que qbx_vehiclekeys ou qb-vehiclekeys est installe et demarre
  • Le joueur doit posseder les cles du vehicule
  • Definissez Config.DoorLock.KeysResource sur 'native' pour contourner la verification des cles
Si vous utilisez le mode native :
  • Config.DoorLock.KeysResource = 'native' utilise le verrouillage natif GTA
  • Vous devez etre le conducteur pour verrouiller/deverrouiller
Les couleurs neon ne se sauvegardent pas entre les sessions
  1. Activez Config.Neons.SaveColor = true
  2. Installez oxmysql et assurez-vous qu'il demarre avant HZ-CarControl
  3. La table hz_neon_colors est creee automatiquement — verifiez la console serveur pour les erreurs SQL
  4. Les couleurs sont sauvegardees par plaque de vehicule — les plaques personnalisees fonctionnent le mieux
Le moteur reste allume quand je quitte le vehicule

C'est le comportement normal de GTA lorsque l'etat du moteur est force via script. HZ-CarControl inclut une detection automatique d'extinction du moteur quand vous quittez le vehicule. Si le probleme persiste :

  1. Verifiez qu'aucun autre script ne force le moteur a rester allume
  2. Assurez-vous d'utiliser la derniere version de HZ-CarControl
La roue radio apparait toujours quand j'appuie sur Q

Activez Config.Radio.DisableWheel = true pour desactiver la roue radio native de GTA V. Cela force les joueurs a utiliser le panneau radio de CarControl a la place.

L'option toit decapotable n'apparait pas

Le bouton toit decapotable n'apparait que lorsque le vehicule possede effectivement un toit decapotable. Les vehicules non decapotables n'affichent pas cette option.


Configuration

Comment desactiver une fonctionnalite specifique ?

Mettez la fonctionnalite a false dans Config.Features :

Config.Features = {
    Neons = false,        -- Desactiver les controles neon
    CruiseControl = false, -- Desactiver le cruise control
    -- ... autres fonctionnalites
}

La fonctionnalite desactivee sera masquee du menu.

Comment changer la position du menu ?

Modifiez Config.Menu.Align :

Config.Menu = {
    Align = 'bottom-center',  -- Par defaut
    -- Options: 'top-left', 'top-center', 'top-right',
    --          'bottom-left', 'bottom-center', 'bottom-right'
}
Comment ajouter des presets de couleurs neon personnalises ?

Ajoutez des entrees dans Config.Neons.Presets :

Config.Neons = {
    Presets = {
        { r = 255, g = 0,   b = 0,   label = 'Red' },
        { r = 0,   g = 255, b = 0,   label = 'Green' },
        -- Ajoutez les votres :
        { r = 255, g = 105, b = 180, label = 'Hot Pink' },
        { r = 0,   g = 191, b = 255, label = 'Deep Sky Blue' },
    },
}
Comment restreindre le menu aux admins uniquement ?

Activez le systeme de permissions :

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

Puis ajoutez l'ace dans votre server.cfg :

add_ace group.admin hz.carcontrol allow
Comment ajouter des presets de limiteur de vitesse personnalises ?

Modifiez Config.SpeedLimiter.Presets :

Config.SpeedLimiter = {
    Presets = { 30, 50, 80, 110, 130 },
    -- Changez avec vos propres valeurs :
    -- Presets = { 20, 40, 60, 90, 120 },
}

Le limiteur cycle a travers chaque preset, puis se desactive.


Vous ne trouvez pas votre reponse ? Rejoignez notre Discord et ouvrez un ticket dans #support !