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)

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

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 menu
`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 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`	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 menu)
`KeysResource`	string	`'auto'`	Ressource vehicle keys : `'auto'` (detection), `'qbx_vehiclekeys'`, `'qb-vehiclekeys'`, `'native'`
`SyncToPlayers`	boolean	`true`	Synchroniser l'etat de verrouillage aux joueurs proches via 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 menu. 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 menu 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 menu. Laissez vide pour autoriser tout le monde quand `Enabled = true`

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

Apres avoir modifie config.lua, redemarrez le script avec ensure HZ-CarControl ou redemarrez le serveur.