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 ?
- Téléchargez la dernière version depuis le Keymaster
- Faites une sauvegarde de votre
config.lua - Remplacez tous les fichiers sauf
config.lua - Consultez le Changelog pour les nouveaux paramètres de configuration
- 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_libest installé et démarre avant HZ-CarControl- Votre licence FiveM est valide sur le Keymaster
server.cfgcontientensure hz_carcontrol
Erreur "Framework not detected"
La detection du framework est gérée par hz_lib :
- Assurez-vous que
es_extendedouqb-coreestensureavanthz_lib hz_libdoit êtreensureavanthz_carcontrol- Vérifiez la ligne console de hz_lib pour le statut de détection
Le menu ne s'ouvre pas du tout
- Vous devez être dans un véhicule — le menu ne s'ouvre pas à pied
- Essayez la commande
/carmenuau lieu du raccourci clavier - Vérifiez si un autre script utilise la touche
H - Si
Config.Permissions.Enabled = true, assurez-vous d'avoir la permission ace correcte - Vérifiez la console F8 pour les erreurs
Fonctionnalités
Le cruise control ne s'active pas
Causes courantes :- Votre vitesse est inférieure à
Config.CruiseControl.MinSpeed(par défaut : 20 km/h) Config.Features.CruiseControlest défini surfalseConfig.CruiseControl.Enabledest défini surfalse
Le verrouillage des portes ne fonctionne pas
Si vous utilisez une ressource vehicle keys :- Vérifiez que
qbx_vehiclekeysouqb-vehiclekeysest installé et démarre - Le joueur doit posséder les clés du véhicule
- Définissez
Config.DoorLock.KeysResourcesur'native'pour contourner la vérification des clés
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
- Activez
Config.Neons.SaveColor = true - Installez
oxmysqlet assurez-vous qu'il démarre avant HZ-CarControl - La table
hz_neon_colorsest créée automatiquement — vérifiez la console serveur pour les erreurs SQL - 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 :
- Vérifiez qu'aucun autre script ne force le moteur à rester allume
- 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.
