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 ?
- Telechargez la derniere version depuis le Keymaster
- Faites une sauvegarde de votre
config.lua - Remplacez tous les fichiers sauf
config.lua - Consultez le Changelog pour les nouveaux parametres de configuration
- Redemarrez le serveur
Installation
Le script ne demarre pas
Verifiez que :
- Le dossier est correctement nomme
HZ-CarControl(sensible a la casse) HZ-Bridgeest installe et demarre avant HZ-CarControl- Votre licence FiveM est valide sur le Keymaster
server.cfgcontientensure HZ-CarControl
Erreur "Framework not detected"
La detection du framework est geree par HZ-Bridge :
- Assurez-vous que
es_extendedouqb-coreestensureavantHZ-Bridge HZ-Bridgedoit etreensureavantHZ-CarControl- Verifiez la ligne console de HZ-Bridge pour le statut de detection
Le menu ne s'ouvre pas du tout
- Vous devez etre dans un vehicule — le menu ne s'ouvre pas a pied
- Essayez la commande
/carmenuau lieu du raccourci clavier - Verifiez si un autre script utilise la touche
H - Si
Config.Permissions.Enabled = true, assurez-vous d'avoir la permission ace correcte - Verifiez la console F8 pour les erreurs
Fonctionnalites
Le cruise control ne s'active pas
Causes courantes :- Votre vitesse est inferieure a
Config.CruiseControl.MinSpeed(par defaut : 20 km/h) Config.Features.CruiseControlest defini surfalseConfig.CruiseControl.Enabledest defini surfalse
Le verrouillage des portes ne fonctionne pas
Si vous utilisez une ressource vehicle keys :- Verifiez que
qbx_vehiclekeysouqb-vehiclekeysest installe et demarre - Le joueur doit posseder les cles du vehicule
- Definissez
Config.DoorLock.KeysResourcesur'native'pour contourner la verification des cles
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
- Activez
Config.Neons.SaveColor = true - Installez
oxmysqlet assurez-vous qu'il demarre avant HZ-CarControl - La table
hz_neon_colorsest creee automatiquement — verifiez la console serveur pour les erreurs SQL - 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 :
- Verifiez qu'aucun autre script ne force le moteur a rester allume
- 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.
