Drag System
Configuration
Configuration
Configuration is split across 6 files in config/, all unencrypted and freely editable.
| File | Owns |
|---|---|
config/main.lua |
Framework, locale, debug |
config/nitro.lua |
Nitro kit, control key, safe-use count, engine-blow risk |
config/tablet.lua |
ECU tablet job restriction, scan duration, integrations |
config/vehicles.lua |
Vehicle whitelist (which cars are "drag cars") |
config/effects.lua |
Visual effects (boost particles, exhaust flames) |
config/ui.lua |
Tablet UI styling, themes, accent colors |
main.lua — globals
Config.Framework = 'qbx' -- 'auto' | 'qbx' | 'qb' | 'esx'
Config.Locale = 'es' -- 'es' | 'en'
Config.Debug = false -- F8 console debug spam
nitro.lua — kit + risk
Config.Nitro = {
enabled = true,
itemName = 'drag_nitro', -- ox_inventory item
integration = {
useJGMechanic = false, -- jg-mechanic native detection
controlKey = 21, -- 21 = LSHIFT
},
installation = {
installTime = 10000, -- ms to install
installDistance = 2.0, -- meters from vehicle
checkOwnership = false, -- require vehicle keys to install
},
safeUses = 10, -- uses before damage risk starts
checkInterval = 100, -- ms between active-use checks
}
After safeUses, every additional firing rolls a damage chance — push too hard and you blow the engine.
tablet.lua — ECU scanner
Config.Tablet = {
jobRestriction = {
job = 'mechanic', -- false = anyone
minGrade = 3, -- 0 = any grade
},
scanDuration = 25, -- seconds (5-120 range)
}
The tablet is its own ox_inventory item — its name is also configurable in tablet.lua. When used, the player aims at a vehicle and a scan animation runs for the duration above, then the tuning UI opens.
vehicles.lua — allowed cars
A whitelist of vehicle models that the resource treats as drag cars. The nitro kit refuses to install on vehicles outside this list (so players can't put nitro on a city bus).
effects.lua — visuals
Boost cloud, exhaust flame, screen-shake intensity. Each effect is toggleable individually.
ui.lua — tablet styling
CSS-variable equivalents for the tablet's NUI — accent color, font, layout density.
