Accueil › Documentation › Configuration · origen_vehiclehandling
Tous les paramètres se trouvent dans config.lua.
| 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).
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.
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 |
Contrôle qui peut ouvrir et utiliser le panneau de handling.
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.
Configure le fournisseur de notifications en jeu.
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 |
Utilisé uniquement lorsque Config.Notify.provider = 'custom'. Définis ta propre fonction :
Config.CustomNotify = function(message, msgType, duration, title)
-- message : string — notification body
-- msgType : string — 'success' | 'error' | 'info'
-- duration : number — milliseconds
-- title : string — notification title
endExemple — ox_lib :
Config.CustomNotify = function(message, msgType, duration, title)
if lib and lib.notify then
lib.notify({
title = title,
description = message,
type = msgType,
duration = duration,
})
end
endTraductions 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 :
Config.Locale = 'pt'
Config.Locales = {
-- ... existing locales ...
pt = {
confirm = 'Confirmar',
-- ... add all keys ...
}
}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).