FAQ

Général

Le script est-il compatible avec mon framework ?

HZ-CarControl supporte QBCore, QBX, ESX et le mode Standalone. Le script détecté automatiquement votre framework via le système hz_lib.

Le script impacte-t-il les performances ?

Non. HZ-CarControl utilise 0.00 ms au repos côté 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 réassigner les touches ?

Oui. Tous les raccourcis utilisent le système RegisterKeyMapping de FiveM, ce qui signifie que les joueurs peuvent les réassigner dans Paramètres → Raccourcis → FiveM en jeu.

Combien de langues sont supportées ?

14 langues sont incluses : anglais, français, espagnol, allemand, portugais, italien, néerlandais, polonais, turc, russe, chinois, japonais, coréen et arabe. Définissez Config.Locale avec le code de langue souhaite.

Comment mettre à jour le script ?
  1. Téléchargez la dernière 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 paramètres de configuration
  5. Redémarrez le serveur

Installation

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
  • 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 ensure avant hz_lib
  • hz_lib doit être ensure avant hz_carcontrol
  • Vérifiez la ligne console de hz_lib pour le statut de détection
Le menu ne s'ouvre pas du tout
  1. Vous devez être dans un véhicule — le menu ne s'ouvre pas à pied
  2. Essayez la commande /carmenu au lieu du raccourci clavier
  3. Vérifiez si un autre script utilise la touche H
  4. Si Config.Permissions.Enabled = true, assurez-vous d'avoir la permission ace correcte
  5. Vérifiez la console F8 pour les erreurs

Fonctionnalités

Le cruise control ne s'active pas Causes courantes :
  1. Votre vitesse est inférieure à Config.CruiseControl.MinSpeed (par défaut : 20 km/h)
  2. Config.Features.CruiseControl est défini sur false
  3. Config.CruiseControl.Enabled est défini sur false
Solution : accélérez au-dessus de 20 km/h et réessayez.
Le verrouillage des portes ne fonctionne pas Si vous utilisez une ressource vehicle keys :
  • Vérifiez que qbx_vehiclekeys ou qb-vehiclekeys est installé et démarre
  • Le joueur doit posséder les clés du véhicule
  • Définissez Config.DoorLock.KeysResource sur 'native' pour contourner la vérification des clés
Si vous utilisez le mode native :
  • Config.DoorLock.KeysResource = 'native' utilise le verrouillage natif GTA
  • Vous devez être le conducteur pour verrouiller/deverrouiller
Les couleurs néon ne se sauvegardent pas entre les sessions
  1. Activez Config.Neons.SaveColor = true
  2. Installez oxmysql et assurez-vous qu'il démarre avant HZ-CarControl
  3. La table hz_neon_colors est créée automatiquement — vérifiez la console serveur pour les erreurs SQL
  4. Les couleurs sont sauvegardées par plaque de véhicule — les plaques personnalisées fonctionnent le mieux
Le moteur reste allume quand je quitte le véhicule

C'est le comportement normal de GTA lorsque l'état du moteur est force via script. HZ-CarControl inclut une détection automatique d'extinction du moteur quand vous quittez le véhicule. Si le problème persiste :

  1. Vérifiez qu'aucun autre script ne force le moteur à rester allume
  2. Assurez-vous d'utiliser la dernière version de HZ-CarControl
La roue radio apparaît toujours quand j'appuie sur Q

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

L'option toit décapotable n'apparaît pas

Le bouton toit décapotable n'apparaît que lorsque le véhicule possède effectivement un toit décapotable. Les véhicules non décapotables n'affichent pas cette option.


Configuration

Comment désactiver une fonctionnalité spécifique ?

Mettez la fonctionnalité à false dans Config.Features :

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

La fonctionnalité désactivée sera masquée 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 néon personnalises ?

Ajoutez des entrées 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 système 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 à travers chaque preset, puis se desactive.


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