Inicio › Documentación › Configuración · origen_vehiclehandling

Configuración · origen_vehiclehandling

Todos los ajustes están en config.lua.

General

Variable	Por defecto	Descripción
`Config.Debug`	`false`	Muestra mensajes de depuración en la consola del servidor y del cliente
`Config.CheckInterval`	`2000`	Milisegundos entre cada comprobación de sincronización del handling del vehículo en el cliente
`Config.Hotkey`	`'F4'`	Tecla por defecto para abrir el panel de handling estando dentro de un vehículo
`Config.FocusHotkey`	`'LMENU'`	Tecla por defecto para alternar el foco del ratón en la NUI
`Config.Locale`	`'en'`	Idioma activo de la interfaz — `'en'` o `'es'` integrados

Dentro de la NUI, el foco también se puede alternar con G (control interno fijo).

Config.Vehicles

Presets de handling cargados desde el fichero de configuración al arrancar el recurso. Estas entradas se combinan con la base de datos; para el mismo modelo, prevalecen los valores de la base de datos.

lua

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

La clave exterior es el nombre de la categoría; la clave interior es el nombre de spawn del vehículo. Todos los campos de handling son opcionales — cualquier valor omitido usa el de la base de datos o el de GTA por defecto.

Campos de handling compatibles:

Campo	Parámetro native	Por defecto
`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

Controla quién puede abrir y usar el panel de handling.

lua

Config.Permissions = {
    UseOrigenAdmin         = true,
    UseFrameworkFallback   = true,
    UseAceFallback         = true,
    EnableLicenseWhitelist = true,
    AllowedLicenses        = {
        -- 'license:1234567890abcdef1234567890abcdef12345678',
    }
}

Campo	Por defecto	Descripción
`UseOrigenAdmin`	`true`	Comprueba los permisos mediante `origen_admin:HasPermission` cuando el recurso está en marcha
`UseFrameworkFallback`	`true`	Permite los grupos `admin`/`god` de QBCore o `admin`/`superadmin` de ESX
`UseAceFallback`	`true`	Permite a los jugadores con los nodos ACE `origen.vehiclehandling`, `admin` o `command`
`EnableLicenseWhitelist`	`true`	Da acceso a los identificadores listados en `AllowedLicenses`
`AllowedLicenses`	`{}`	Lista de identificadores `license:` o `license2:` que siempre tienen acceso

La cadena de permisos se evalúa en este orden: lista blanca → origen_admin → ACE origen.vehiclehandling → grupo del framework → ACE admin/command.

Config.Notify

Configura el proveedor de notificaciones del juego.

lua

Config.Notify = {
    provider = 'origen_notify',
    title    = 'Vehicle Handling',
    duration = 5000
}

Campo	Por defecto	Descripción
`provider`	`'origen_notify'`	Sistema de notificaciones — `'origen_notify'` \| `'ox_lib'` \| `'qbcore'` \| `'esx'` \| `'chat'` \| `'custom'`
`title`	`'Vehicle Handling'`	Título mostrado en la notificación (cuando el proveedor lo admite)
`duration`	`5000`	Duración en milisegundos

Config.CustomNotify

Solo se usa cuando Config.Notify.provider = 'custom'. Define tu propia función:

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

Ejemplo — 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

Traducciones integradas. El recurso incluye dos idiomas (en y es). Para añadir un idioma propio, amplía la tabla y pon en Config.Locale su clave:

lua

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

Comandos

Los siguientes comandos de chat/consola se registran en el cliente:

Comando	Restringido	Descripción
`/vh`	No	Inicia Live Handling en el vehículo actual (hay que ser el conductor)
`/vhnew [model] [category]`	No	Abre Live Handling para un modelo concreto — hace aparecer el vehículo si hace falta
`/vhmenu`	No	Abre el panel principal de handling (categorías y lista de vehículos)
`/vhsave`	No	Guarda la sesión en vivo activa en la base de datos
`/vhdiscard`	No	Descarta la sesión en vivo activa sin guardar
`openHandlingV2`	Sí (ACE)	Abre el panel de handling — pensado para teclas de acceso de administradores
`toggleHandlingFocus`	Sí (ACE)	Alterna el foco del ratón en la NUI

/vh y /vhnew abren el editor de Live Handling directamente sobre un vehículo, sin pasar por el panel principal. Ambos exigen que el jugador tenga permiso de edición en vivo (origen.vehiclehandling.liveedit o acceso completo de gestión).