Início › Documentação › Configuração · origen_vehiclehandling

Configuração · origen_vehiclehandling

Todas as definições estão em config.lua.

Geral

Variável	Por omissão	Descrição
`Config.Debug`	`false`	Mostra mensagens de depuração na consola do servidor e do cliente
`Config.CheckInterval`	`2000`	Milissegundos entre cada verificação de sincronização do handling do veículo no cliente
`Config.Hotkey`	`'F4'`	Tecla por omissão para abrir o painel de handling dentro de um veículo
`Config.FocusHotkey`	`'LMENU'`	Tecla por omissão para alternar o foco do rato na NUI
`Config.Locale`	`'en'`	Idioma ativo da interface — `'en'` ou `'es'` integrados

Dentro da NUI, o foco também pode ser alternado com G (controlo interno fixo).

Config.Vehicles

Presets de handling carregados a partir do ficheiro de configuração no arranque do recurso. Estas entradas são combinadas com a base de dados; para o mesmo modelo, prevalecem os valores da base de dados.

lua

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

A chave exterior é o nome da categoria; a chave interior é o nome de spawn do veículo. Todos os campos de handling são opcionais — qualquer valor omitido usa o da base de dados ou o do GTA por omissão.

Campos de handling suportados:

Campo	Parâmetro native	Por omissão
`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 quem pode abrir e usar o painel de handling.

lua

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

Campo	Por omissão	Descrição
`UseOrigenAdmin`	`true`	Verifica as permissões através de `origen_admin:HasPermission` quando o recurso está a correr
`UseFrameworkFallback`	`true`	Permite os grupos `admin`/`god` do QBCore ou `admin`/`superadmin` do ESX
`UseAceFallback`	`true`	Permite os jogadores com os nós ACE `origen.vehiclehandling`, `admin` ou `command`
`EnableLicenseWhitelist`	`true`	Dá acesso aos identificadores listados em `AllowedLicenses`
`AllowedLicenses`	`{}`	Lista de identificadores `license:` ou `license2:` que têm sempre acesso

A cadeia de permissões é avaliada por esta ordem: lista branca → origen_admin → ACE origen.vehiclehandling → grupo da framework → ACE admin/command.

Config.Notify

Configura o fornecedor de notificações do jogo.

lua

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

Campo	Por omissão	Descrição
`provider`	`'origen_notify'`	Sistema de notificações — `'origen_notify'` \| `'ox_lib'` \| `'qbcore'` \| `'esx'` \| `'chat'` \| `'custom'`
`title`	`'Vehicle Handling'`	Título mostrado na notificação (quando o fornecedor o suporta)
`duration`	`5000`	Duração em milissegundos

Config.CustomNotify

Só é usado quando Config.Notify.provider = 'custom'. Define a tua própria função:

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

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

Traduções integradas. O recurso inclui dois idiomas (en e es). Para adicionar um idioma próprio, amplia a tabela e define em Config.Locale a respetiva chave:

lua

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

Comandos

Os seguintes comandos de chat/consola são registados no cliente:

Comando	Restrito	Descrição
`/vh`	Não	Inicia o Live Handling no veículo atual (tens de ser o condutor)
`/vhnew [model] [category]`	Não	Abre o Live Handling para um modelo concreto — faz aparecer o veículo se for preciso
`/vhmenu`	Não	Abre o painel principal de handling (categorias e lista de veículos)
`/vhsave`	Não	Guarda a sessão em direto ativa na base de dados
`/vhdiscard`	Não	Descarta a sessão em direto ativa sem guardar
`openHandlingV2`	Sim (ACE)	Abre o painel de handling — pensado para teclas de atalho de administradores
`toggleHandlingFocus`	Sim (ACE)	Alterna o foco do rato na NUI

/vh e /vhnew abrem o editor de Live Handling diretamente sobre um veículo, sem passar pelo painel principal. Ambos exigem que o jogador tenha permissão de edição em direto (origen.vehiclehandling.liveedit ou acesso total de gestão).