Accueil › Documentation › Configuration · origen_vehiclehandling

Configuration · origen_vehiclehandling

Tous les paramètres se trouvent dans config.lua.


Général

Variable Par défaut Description
Config.Debug false Affiche des messages de débogage dans la console du serveur et du client
Config.CheckInterval 2000 Millisecondes entre chaque vérification de synchronisation du handling du véhicule côté client
Config.Hotkey 'F4' Touche par défaut pour ouvrir le panneau de handling à l’intérieur d’un véhicule
Config.FocusHotkey 'LMENU' Touche par défaut pour basculer le focus de la souris dans la NUI
Config.Locale 'en' Langue active de l’interface — 'en' ou 'es' intégrées

Dans la NUI, le focus peut aussi être basculé avec G (contrôle interne fixe).


Config.Vehicles

Presets de handling chargés depuis le fichier de configuration au démarrage de la ressource. Ces entrées sont fusionnées avec la base de données ; pour un même modèle, les valeurs de la base de données l’emportent.

lua
Config.Vehicles = {
    ['Police'] = {
        ['hvaleutian'] = {
            maxSpeed  = 220.0,
            driveForce = 0.35,
            gears      = 6,
            shiftSpeed = 1.2,
        },
    },
}

La clé extérieure est le nom de la catégorie ; la clé intérieure est le nom de spawn du véhicule. Tous les champs de handling sont facultatifs — toute valeur omise utilise celle de la base de données ou celle de GTA par défaut.

Champs de handling pris en charge :

Champ Paramètre native Par défaut
maxSpeed fInitialDriveMaxFlatVel 150.0
driveForce fInitialDriveForce 0.2
gears nInitialDriveGears 6
shiftSpeed fClutchChangeRateScaleUpShift 1.0
brakeForce fBrakeForce 0.5
brakeBias fBrakeBiasFront 0.5
steeringLock fSteeringLock 40.0
tractionMax fTractionCurveMax 2.5
tractionMin fTractionCurveMin 2.0
tractionBias fTractionBiasFront 0.5
tractionLoss fTractionLossMult 1.0
suspensionForce fSuspensionForce 2.0
suspensionHeight fSuspensionUpperLimit 0.0
suspensionLowerLimit fSuspensionLowerLimit -0.1
suspensionComp fSuspensionCompDamp 1.0
suspensionRebound fSuspensionReboundDamp 1.0
mass fMass 1500.0
dragCoeff fInitialDragCoeff 10.0
driveBias fDriveBiasFront 0.5
inertia fDriveInertia 1.0
antiRollBar fAntiRollBarForce 0.5
rollCentreFront fRollCentreHeightFront 0.0
rollCentreRear fRollCentreHeightRear 0.0
collisionMult fCollisionDamageMult 1.0
engineMult fEngineDamageMult 1.0
deformationMult fDeformationDamageMult 1.0

Config.Permissions

Contrôle qui peut ouvrir et utiliser le panneau de handling.

lua
Config.Permissions = {
    UseOrigenAdmin         = true,
    UseFrameworkFallback   = true,
    UseAceFallback         = true,
    EnableLicenseWhitelist = true,
    AllowedLicenses        = {
        -- 'license:1234567890abcdef1234567890abcdef12345678',
    }
}
Champ Par défaut Description
UseOrigenAdmin true Vérifie les permissions via origen_admin:HasPermission lorsque la ressource est lancée
UseFrameworkFallback true Autorise les groupes admin/god de QBCore ou admin/superadmin d’ESX
UseAceFallback true Autorise les joueurs ayant les nœuds ACE origen.vehiclehandling, admin ou command
EnableLicenseWhitelist true Donne accès aux identifiants listés dans AllowedLicenses
AllowedLicenses {} Liste d’identifiants license: ou license2: qui ont toujours accès

La chaîne de permissions est évaluée dans cet ordre : liste blanche → origen_admin → ACE origen.vehiclehandling → groupe du framework → ACE admin/command.


Config.Notify

Configure le fournisseur de notifications en jeu.

lua
Config.Notify = {
    provider = 'origen_notify',
    title    = 'Vehicle Handling',
    duration = 5000
}
Champ Par défaut Description
provider 'origen_notify' Système de notifications — 'origen_notify' | 'ox_lib' | 'qbcore' | 'esx' | 'chat' | 'custom'
title 'Vehicle Handling' Titre affiché dans la notification (lorsque le fournisseur le permet)
duration 5000 Durée en millisecondes

Config.CustomNotify

Utilisé uniquement lorsque Config.Notify.provider = 'custom'. Définis ta propre fonction :

lua
Config.CustomNotify = function(message, msgType, duration, title)
    -- message  : string  — notification body
    -- msgType  : string  — 'success' | 'error' | 'info'
    -- duration : number  — milliseconds
    -- title    : string  — notification title
end

Exemple — ox_lib :

lua
Config.CustomNotify = function(message, msgType, duration, title)
    if lib and lib.notify then
        lib.notify({
            title       = title,
            description = message,
            type        = msgType,
            duration    = duration,
        })
    end
end

Config.Locales

Traductions intégrées. La ressource inclut deux langues (en et es). Pour ajouter une langue personnalisée, étends la table et mets sa clé dans Config.Locale :

lua
Config.Locale = 'pt'
 
Config.Locales = {
    -- ... existing locales ...
    pt = {
        confirm = 'Confirmar',
        -- ... add all keys ...
    }
}

Commandes

Les commandes de chat/console suivantes sont enregistrées côté client :

Commande Restreinte Description
/vh Non Lance le Live Handling sur le véhicule actuel (il faut être le conducteur)
/vhnew [model] [category] Non Ouvre le Live Handling pour un modèle précis — fait apparaître le véhicule si nécessaire
/vhmenu Non Ouvre le panneau principal de handling (catégories et liste de véhicules)
/vhsave Non Enregistre la session en direct active dans la base de données
/vhdiscard Non Abandonne la session en direct active sans enregistrer
openHandlingV2 Oui (ACE) Ouvre le panneau de handling — prévue pour les raccourcis clavier des administrateurs
toggleHandlingFocus Oui (ACE) Bascule le focus de la souris dans la NUI

/vh et /vhnew ouvrent l’éditeur de Live Handling directement sur un véhicule, sans passer par le panneau principal. Les deux exigent que le joueur ait la permission d’édition en direct (origen.vehiclehandling.liveedit ou accès de gestion complet).