Configuration

Most options are in config.lua. Handling field definitions live in shared/handling_config.lua.

General

Option	Default	Description
`Config.Debug`	`false`	Extra debug logging
`Config.Locale`	`'en'`	Locale file from `locales/`
`Config.Brand.logo`	`'logo.png'`	Logo file in `web/build/`
`Config.Brand.name`	`'Nexra Handling'`	Brand name shown in the UI

Editor access

Option	Default	Description
`Config.HandlingEditor.Command`	`'handling'`	Command used to open the editor
`Config.HandlingEditor.AllowedLicenses`	example license	License allowlist for staff access

Example:

Config.HandlingEditor.AllowedLicenses = {
    'license:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX',
    'license:YYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYY',
}

If the allowlist is empty, every player can open the editor.

Layout

Option	Default	Description
`Config.HandlingEditor.DefaultLayout.panel`	`false`	Open with the panel layout
`Config.HandlingEditor.DefaultLayout.sideMenu`	`true`	Open with the side menu layout
`Config.HandlingEditor.CompactLayout.*`	side menu enabled	Compact layout defaults

Players can also save local UI preferences from the editor settings menu.

Engine sounds

Option	Default	Description
`Config.HandlingEditor.VehicleSoundPresets`	sample values	Preset sound names shown in the sound selector
`Config.HandlingEditor.EngineSounds.enabled`	`true`	Enable saved engine sound application
`Config.HandlingEditor.EngineSounds.mode`	`'poolScan'`	`poolScan` or `onEnter`
`Config.HandlingEditor.EngineSounds.scanIntervalMs`	`3000`	Pool scan interval in ms
`Config.HandlingEditor.EngineSounds.batchSize`	`48`	Vehicles processed per scan batch

Use poolScan to keep nearby spawned vehicles updated, but keep in mind it is more resource intensive because it checks the vehicle pool on an interval. Use onEnter if you want a lighter option that only applies sounds when a player enters a vehicle.

Vehicle classes

Option	Default	Description
`Config.HandlingEditor.Classes.C`	`300`	C class rating threshold
`Config.HandlingEditor.Classes.B`	`500`	B class rating threshold
`Config.HandlingEditor.Classes.A`	`600`	A class rating threshold
`Config.HandlingEditor.Classes.Aplus`	`750`	A+ class rating threshold
`Config.HandlingEditor.Classes.S`	`800`	S class rating threshold
`Config.HandlingEditor.Classes.Splus`	`900`	S+ class rating threshold
`Config.HandlingEditor.Classes.X`	`1000`	X class rating threshold

Rating balance

Option	Default	Description
`Config.HandlingEditor.Balance.acceleration`	`4`	Acceleration weight
`Config.HandlingEditor.Balance.speed`	`3`	Top speed weight
`Config.HandlingEditor.Balance.handling`	`2`	Handling weight
`Config.HandlingEditor.Balance.braking`	`1`	Braking weight
`Config.HandlingEditor.Balance.ratingMultiplier`	`12`	Final rating multiplier

Vehicle maintenance

Option	Default	Description
`Config.VehicleMaintenance.Fix.enabled`	`true`	Enable repair / clean tools
`Config.VehicleMaintenance.Fix.useCustomEvent`	`false`	Use your own repair event
`Config.VehicleMaintenance.Fix.customEvent`	`nil`	Custom repair event name
`Config.VehicleMaintenance.Fix.engine`	`true`	Repair engine health
`Config.VehicleMaintenance.Fix.body`	`true`	Repair body health
`Config.VehicleMaintenance.Fix.tank`	`true`	Repair fuel tank health
`Config.VehicleMaintenance.Fix.deformation`	`true`	Fix vehicle deformation
`Config.VehicleMaintenance.Fix.dirt`	`true`	Enable clean vehicle tool
`Config.VehicleMaintenance.Fix.undriveable`	`true`	Make vehicle driveable again
`Config.VehicleMaintenance.Upgrades.enabled`	`true`	Enable upgrade tools
`Config.VehicleMaintenance.Upgrades.useCustomEvent`	`false`	Use your own upgrade event
`Config.VehicleMaintenance.Upgrades.customEvent`	`nil`	Custom upgrade event name
`Config.VehicleMaintenance.Upgrades.categories.*`	varies	Upgrade categories available in the UI

Default upgrade categories: engine, brakes, transmission, suspension, and turbo enabled. Armor is disabled by default.

Handling fields

shared/handling_config.lua controls which handling fields appear and how values are read / written.

Option	Description
`Config.HandlingPrecision`	Number precision used when reading values
`Config.HandlingFieldOrder`	Order fields appear in the UI
`Config.HandlingSubFields`	Fields written to `CCarHandlingData`
`Config.HandlingFields`	Supported field definitions and value types
`Config.HandlingTypes`	Getter / setter logic for floats, integers, and vectors

Only edit this file if you understand FiveM handling fields and want to add, remove, or reorder supported fields.

Providers

Integrations auto-detect from started resources. To force a provider, set it in config.lua:

Config.Providers = {
    framework = 'qb-core', -- or qbx_core / es_extended / custom
    notifications = 'ox_lib',
}

Configuration

On this page