Configuration

Tous les parametres se trouvent dans config.lua. Ce guide explique chaque section en detail.

General

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

Parametre	Type	Defaut	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 detailles dans la console (serveur + client)

Menú

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

Parametre	Type	Defaut	Description
`Command`	string	`'carmenu'`	Commande chat pour ouvrir/fermer le menú
`Keybind`	string	`'H'`	Touche par defaut (FiveM key mapper — les joueurs peuvent la reassigner)
`Description`	string	`'Open vehicle...'`	Description affichee dans les parametres de raccourcis FiveM
`Align`	string	`'bottom-center'`	Position a l'ecran : `top-left`, `top-center`, `top-right`, `bottom-left`, `bottom-center`, `bottom-right`
`Scale`	float	`1.0`	Multiplicateur d'echelle de l'interface (0.8 – 1.2)

Activation des fonctionnalites

Activez ou desactivez chaque fonctionnalite individuellement. Les fonctionnalites desactivees sont masquees du menú.

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,
}

Fonctionnalite	Description
`Windows`	Controles de vitres haut/bas
`Doors`	Ouverture/fermeture des portes (conducteur uniquement)
`Seats`	Changement de siege
`Engine`	Moteur on/off (conducteur uniquement)
`Lights`	Cycle des phares (eteint → croisement → plein phares)
`InteriorLight`	Eclairage interieur
`Indicators`	Clignotants gauche/droit
`Alarm`	Feux de detresse
`Convertible`	Toit decapotable
`Neons`	Neon
`CruiseControl`	Cruise control
`SpeedLimiter`	Limiteur de vitesse
`DoorLock`	Verrouillage/deverrouillage des portes de l'interieur
`Radio`	Controle radio GTA V (changement de station, arret)

Neon

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' },
    },
}

Parametre	Type	Defaut	Description
`AllowColorChange`	boolean	`true`	Permettre aux joueurs de choisir la couleur RGB neon depuis le menú
`SaveColor`	boolean	`true`	Sauvegarder la couleur choisie par plaque de vehicule (necessite oxmysql)
`Presets`	table	9 couleurs	Presets de couleurs affiches dans le selecteur

Les joueurs peuvent egalement utiliser un selecteur de couleur personnalise (input HTML) en plus des presets.

Radio

Config.Radio = {
    DisableWheel = true,
}

Parametre	Type	Defaut	Description
`DisableWheel`	boolean	`true`	Desactiver la roue radio native de GTA V pour que les joueurs utilisent le panneau radio de CarControl a la place

Cruise Control

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

Parametre	Type	Defaut	Description
`Enabled`	boolean	`true`	Activer la fonctionnalite cruise control
`Keybind`	string	`'K'`	Raccourci direct (sans ouvrir le menú)
`MinSpeed`	integer	`20`	Vitesse minimale requise pour activer (km/h)
`SpeedStep`	integer	`5`	Pas d'ajustement de vitesse avec +/- (km/h)
`DisableOnBrake`	boolean	`true`	Desactivation automatique quand le joueur freine
`DisableOnCollision`	boolean	`true`	Desactivation automatique en cas de collision
`ShowHUD`	boolean	`true`	Afficher l'indicateur de vitesse cruise dans l'en-tete NUI

Le raccourci cruise control peut etre modifie par les joueurs dans les parametres de raccourcis FiveM.

Limiteur de vitesse

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

Parametre	Type	Defaut	Description
`Enabled`	boolean	`true`	Activer la fonctionnalite limiteur de vitesse
`Presets`	table	`{ 30, 50, 80, 110, 130 }`	Vitesses predefnies a cycler (km/h). Le limiteur cycle : preset1 → preset2 → ... → desactive

Verrouillage des portes

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

Parametre	Type	Defaut	Description
`Enabled`	boolean	`true`	Activer la fonctionnalite de verrouillage des portes
`Keybind`	string	`'U'`	Raccourci direct (sans ouvrir le menú)
`KeysResource`	string	`'auto'`	Ressource vehicle keys : `'auto'` (detection), `'qbx_vehiclekeys'`, `'qb-vehiclekeys'`, `'native'`
`SyncToPlayers`	boolean	`true`	Synchroniser l'etat de verrouillage aux joueurs proches vía StateBag (uniquement en mode `'native'`)

En mode 'auto', le script detecte 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 menú. Mettez une touche a '' (chaine vide) pour la desactiver.

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

Parametre	Type	Defaut	Description
`IndicatorLeft`	string	`'LEFT'`	Clignotant gauche
`IndicatorRight`	string	`'RIGHT'`	Clignotant droit
`HazardLights`	string	`''`	Feux de detresse (desactive par defaut)

Fermeture automatique

Config.AutoClose = true

Ferme le menú automatiquement quand le joueur quitte le vehicule.

Sons

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

Parametre	Type	Defaut	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',
}

Parametre	Type	Defaut	Description
`Enabled`	boolean	`true`	Interrupteur principal pour toutes les notifications
`Type`	string	`'framework'`	Systeme de notification : `'framework'` (QBCore/ESX), `'chat'` (chat FiveM), `'native'` (GTA V)

Permissions

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

Parametre	Type	Defaut	Description
`Enabled`	boolean	`false`	Activer les verifications de permissions cote serveur
`AcePermission`	string	`''`	Permission ace requise pour utiliser le menú. Laissez vide pour autoriser tout le monde quand `Enabled = true`

Quand Enabled = false (par defaut), tous les joueurs peuvent utiliser le menú. Activez cette option uniquement si vous souhaitez restreindre l'acces vía les permissions ace FiveM.

Apres avoir modifie config.lua, redemarrez le script avec ensure hz_carcontrol ou redemarrez le serveur.