Configuration

All settings are managed in config.lua.

NUI Open Key

-- NUI 열기 키 (기본: ~ 키, Control ID 243)
Config.OpenKey = 243

See FiveM Control IDs for other key options.

Vehicle Lock Exclusions

Vehicles without doors cannot be locked:

Config.noLockVehicleClasses = {
    [8] = true,   -- Motorcycles
    [13] = true,  -- Cycles
    [14] = true,  -- Boats
    [15] = true,  -- Helicopters
    [16] = true,  -- Planes
}

Non-Fuel Vehicle Classes

Vehicles that don't use fuel (ignition disabled):

Config.nonFuelVehicleClasses = {
    [13] = true, -- Cycles
    [21] = true, -- Trains
}

Drive Modes

Three drive modes with power multiplier and optional speed limiting:

Config.DriveModes = {
    ECO = {
        powerMultiplier = 0.6,
        maxSpeed = 80.0,   -- km/h (0 = unlimited)
        label = 'ECO',
    },
    STANDARD = {
        powerMultiplier = 1.0,
        maxSpeed = 0,
        label = 'STANDARD',
    },
    SPORTS = {
        powerMultiplier = 1.3,
        maxSpeed = 0,
        label = 'SPORTS',
    },
}

Class Performance

Default performance per vehicle class:

Config.classPerformanceConfig = {
    [0]  = { maxGear = 5, power = 0.45 },  -- Compacts
    [1]  = { maxGear = 5, power = 0.45 },  -- Sedans
    [2]  = { maxGear = 5, power = 0.45 },  -- SUVs
    [3]  = { maxGear = 5, power = 0.45 },  -- Coupes
    [4]  = { maxGear = 5, power = 0.5 },   -- Muscle
    [5]  = { maxGear = 5, power = 0.55 },  -- Sports Classics
    [6]  = { maxGear = 6, power = 0.6 },   -- Sports
    [7]  = { maxGear = 6, power = 0.7 },   -- Super
    [8]  = { maxGear = 6, power = 0.7 },   -- Motorcycles
    [9]  = { maxGear = 5, power = 0.45 },  -- Off-road
    [10] = { maxGear = 4, power = 0.4 },   -- Industrial
    [11] = { maxGear = 4, power = 0.4 },   -- Utility
    [12] = { maxGear = 4, power = 0.4 },   -- Vans
}

Model Performance Override

Override class defaults for specific vehicle models:

Config.modelPerformanceConfig = {
    [GetHashKey('sultan')] = { maxGear = 6, power = 0.65 },
    -- Add more models...
}

Model overrides take priority over class config.

Premium Vehicles

Premium vehicles use push-button ignition instead of key cylinder:

Config.PremiumVehicles = {
    [GetHashKey('adder')] = true,
    [GetHashKey('zentorno')] = true,
    [GetHashKey('t20')] = true,
    -- ... add more model hashes
}

Premium Vehicle Classes

Apply push-button to entire vehicle classes:

Config.PremiumVehicleClasses = {
    [7] = true,   -- All Super class vehicles
}

Seatbelt System

Config.Seatbelt = {
    -- 'mst_seatbelt' = Use mst_seatbelt resource (exports)
    -- 'builtin'      = Use built-in seatbelt system
    system = 'mst_seatbelt',

    -- Built-in system settings (only when system = 'builtin')
    builtin = {
        ejectSpeed = 50.0,       -- Eject above this speed (km/h)
        ejectForce = 18.0,       -- Ejection force
        damageMultiplier = 0.5,  -- Crash damage multiplier without seatbelt
    },
}

Cruise Control Limits

Cruise control speed limits are defined in the NUI component:

These values auto-switch when the user toggles the unit.