Configuration

Tous les paramètres se trouvent dans config.lua. Ce guide explique chaque section en détail.

Général

Config.Locale = 'en'
Config.Debug = false

Paramètre	Type	Défaut	Description
`Locale`	string	`'en'`	Fichier de langue dans `locales/`. Supportes : `en`, `fr`, `es`, `de`, `pt`, `it`, `nl`, `pl`, `tr`, `ru`, `zh`, `ja`, `ko`, `ar`
`Debug`	boolean	`false`	Activer les logs détaillés dans la console (serveur + client)

Config.Menu = {
    Command     = 'carmenu',
    Keybind     = 'H',
    Description = 'Open vehicle control panel',
    Align       = 'bottom-center',
    Scale       = 1.0,
}

Paramètre	Type	Défaut	Description
`Command`	string	`'carmenu'`	Commande chat pour ouvrir/fermer le menu
`Keybind`	string	`'H'`	Touche par défaut (FiveM key mapper — les joueurs peuvent la réassigner)
`Description`	string	`'Open vehicle...'`	Description affichée dans les paramètres de raccourcis FiveM
`Align`	string	`'bottom-center'`	Position à l'écran : `top-left`, `top-center`, `top-right`, `bottom-left`, `bottom-center`, `bottom-right`
`Scale`	float	`1.0`	Multiplicateur d'échelle de l'interface (0.8 – 1.2)

Activation des fonctionnalités

Activez ou désactivez chaque fonctionnalité individuellement. Les fonctionnalités désactivées sont masquées du menu.

Config.Features = {
    Windows       = true,
    Doors         = true,
    Seats         = true,
    Engine        = true,
    Lights        = true,
    InteriorLight = true,
    Indicators    = true,
    Alarm         = true,
    Convertible   = true,
    Neons         = true,
    CruiseControl = true,
    SpeedLimiter  = true,
    DoorLock      = true,
    Radio         = true,
}

Fonctionnalité	Description
`Windows`	Contrôles de vitres haut/bas
`Doors`	Ouverture/fermeture des portes (conducteur uniquement)
`Seats`	Changement de siège
`Engine`	Moteur on/off (conducteur uniquement)
`Lights`	Cycle des phares (éteint → croisement → plein phares)
`InteriorLight`	Eclairage intérieur
`Indicators`	Clignotants gauche/droit
`Alarm`	Feux de détresse
`Convertible`	Toit décapotable
`Neons`	Néon
`CruiseControl`	Cruise control
`SpeedLimiter`	Limiteur de vitesse
`DoorLock`	Verrouillage/deverrouillage des portes de l'intérieur
`Radio`	Contrôle radio GTA V (changement de station, arrêt)

Néon

Config.Neons = {
    AllowColorChange = true,
    SaveColor = true,
    Presets = {
        { r = 255, g = 0,   b = 0,   label = 'Red' },
        { r = 0,   g = 0,   b = 255, label = 'Blue' },
        { r = 0,   g = 255, b = 0,   label = 'Green' },
        { r = 255, g = 255, b = 255, label = 'White' },
        { r = 128, g = 0,   b = 255, label = 'Purple' },
        { r = 255, g = 255, b = 0,   label = 'Yellow' },
        { r = 0,   g = 255, b = 255, label = 'Cyan' },
        { r = 255, g = 128, b = 0,   label = 'Orange' },
        { r = 255, g = 0,   b = 128, label = 'Pink' },
    },
}

Paramètre	Type	Défaut	Description
`AllowColorChange`	boolean	`true`	Permettre aux joueurs de choisir la couleur RGB néon depuis le menu
`SaveColor`	boolean	`true`	Sauvegarder la couleur choisie par plaque de véhicule (nécessite oxmysql)
`Presets`	table	9 couleurs	Presets de couleurs affiches dans le sélecteur

Les joueurs peuvent également utiliser un sélecteur de couleur personnalise (input HTML) en plus des presets.

Radio

Config.Radio = {
    DisableWheel = true,
}

Paramètre	Type	Défaut	Description
`DisableWheel`	boolean	`true`	Désactiver la roue radio native de GTA V pour que les joueurs utilisent le panneau radio de CarControl à la place

Cruise Control

Config.CruiseControl = {
    Enabled            = true,
    Keybind            = 'K',
    MinSpeed           = 20,
    SpeedStep          = 5,
    DisableOnBrake     = true,
    DisableOnCollision = true,
    ShowHUD            = true,
}

Paramètre	Type	Défaut	Description
`Enabled`	boolean	`true`	Activer la fonctionnalité cruise control
`Keybind`	string	`'K'`	Raccourci direct (sans ouvrir le menu)
`MinSpeed`	integer	`20`	Vitesse minimale requise pour activer (km/h)
`SpeedStep`	integer	`5`	Pas d'ajustement de vitesse avec +/- (km/h)
`DisableOnBrake`	boolean	`true`	Désactivation automatique quand le joueur freine
`DisableOnCollision`	boolean	`true`	Désactivation automatique en cas de collision
`ShowHUD`	boolean	`true`	Afficher l'indicateur de vitesse cruise dans l'en-tete NUI

Le raccourci cruise control peut être modifié par les joueurs dans les paramètres de raccourcis FiveM.

Limiteur de vitesse

Config.SpeedLimiter = {
    Enabled = true,
    Presets = { 30, 50, 80, 110, 130 },
}

Paramètre	Type	Défaut	Description
`Enabled`	boolean	`true`	Activer la fonctionnalité limiteur de vitesse
`Presets`	table	`{ 30, 50, 80, 110, 130 }`	Vitesses predefnies à cycler (km/h). Le limiteur cycle : preset1 → preset2 → ... → desactive

Verrouillage des portes

Config.DoorLock = {
    Enabled       = true,
    Keybind       = 'U',
    KeysResource  = 'auto',
    SyncToPlayers = true,
}

Paramètre	Type	Défaut	Description
`Enabled`	boolean	`true`	Activer la fonctionnalité de verrouillage des portes
`Keybind`	string	`'U'`	Raccourci direct (sans ouvrir le menu)
`KeysResource`	string	`'auto'`	Ressource vehicle keys : `'auto'` (détection), `'qbx_vehiclekeys'`, `'qb-vehiclekeys'`, `'native'`
`SyncToPlayers`	boolean	`true`	Synchroniser l'état de verrouillage aux joueurs proches via StateBag (uniquement en mode `'native'`)

En mode 'auto', le script détecté automatiquement qbx_vehiclekeys ou qb-vehiclekeys. Si aucun n'est trouve, il revient au verrouillage natif GTA.

Raccourcis clavier

Raccourcis directs qui fonctionnent sans ouvrir le menu. Mettez une touche à '' (chaîne vide) pour la désactiver.

Config.Keybinds = {
    IndicatorLeft  = 'LEFT',
    IndicatorRight = 'RIGHT',
    HazardLights   = '',
}

Paramètre	Type	Défaut	Description
`IndicatorLeft`	string	`'LEFT'`	Clignotant gauche
`IndicatorRight`	string	`'RIGHT'`	Clignotant droit
`HazardLights`	string	`''`	Feux de détresse (desactive par défaut)

Fermeture automatique

Config.AutoClose = true

Ferme le menu automatiquement quand le joueur quitte le véhicule.

Sons

Config.Sounds = {
    Enabled         = true,
    UseCustomSounds = true,
    Volume          = 0.5,
}

Paramètre	Type	Défaut	Description
`Enabled`	boolean	`true`	Interrupteur principal pour tous les sons
`UseCustomSounds`	boolean	`true`	Utiliser des fichiers `.ogg` personnalises dans `html/sounds/` au lieu des sons natifs GTA
`Volume`	float	`0.5`	Volume des sons personnalises (0.0 – 1.0)

Notifications

Config.Notifications = {
    Enabled = true,
    Type    = 'framework',
}

Paramètre	Type	Défaut	Description
`Enabled`	boolean	`true`	Interrupteur principal pour toutes les notifications
`Type`	string	`'framework'`	Système de notification : `'framework'` (QBCore/ESX), `'chat'` (chat FiveM), `'native'` (GTA V)

Permissions

Config.Permissions = {
    Enabled       = false,
    AcePermission = '',
}

Paramètre	Type	Défaut	Description
`Enabled`	boolean	`false`	Activer les vérifications de permissions côté serveur
`AcePermission`	string	`''`	Permission ace requise pour utiliser le menu. Laissez vide pour autoriser tout le monde quand `Enabled = true`

Quand Enabled = false (par défaut), tous les joueurs peuvent utiliser le menu. Activez cette option uniquement si vous souhaitez restreindre l'accès via les permissions ace FiveM.

Après avoir modifie config.lua, redémarrez le script avec ensure hz_carcontrol ou redémarrez le serveur.