General Settings

📄 Config file: shared/general.lua

This is the main configuration file for Kartik-Mechanic. It controls core behaviour like debug mode, autosaving, interaction style, which parts are tracked, anti-lag, brake glow, and which vehicle classes are excluded.

Debug ModeCopy Anchor Link

Config.Debug = false

Set to true to enable debug prints in the console. Useful for troubleshooting during development, always keep this false on a live server to avoid console spam.

AutosaveCopy Anchor Link

Config.Autosave         = true
Config.AutosaveInterval = 30
Config.MinDiffToSave    = 100.0

Maintenance AlertsCopy Anchor Link

Config.ChangeWarnings            = true
Config.WarningsInterval          = 9999
Config.MaintenanceAlertThreshold = 20

Interaction TypeCopy Anchor Link

Config.InteractionType = 'radial'

Controls how players interact with mechanic zones:

• 'radial': Opens a radial menu when the player enters a zone. Best for controllers and immersive servers.
• 'button': Shows a TextUI prompt (e.g. "Press [E]") and waits for a key press. More traditional.

With 'button', the prompt stays on screen while you stand in the zone. It only hides while a mechanic menu or the pause menu is open, and comes back when you close them. Other scripts opening their own screens do not hide it.

HUD & InteractionCopy Anchor Link

Config.HUD = {
    Mileage     = true,     -- Global toggle for mileage counter
    Gears       = true,     -- Global toggle for manual transmission gears
    Nitro       = true,     -- Global toggle for nitro level counter
    Seatbelt    = true,     -- Global toggle for seatbelt indicator
    Electronics = true,     -- Global toggle for TCS/ESC indicator
}
Config.InteractionType = 'radial'
Config.InstallationCamera = true
Config.ReappearReceipt = true

Feature TogglesCopy Anchor Link

Config.Features = {
    VehicleConfigPhysics = true,
    TuningSystem         = true,
    NitroSystem          = true,
    StanceSystem         = true,
    DirtSystem           = true,
}

Master switches for whole systems. Set one to false and that system is completely turned off, not just hidden. Useful when another resource on your server already handles that feature.

For a full list of everything you can switch on or off, see Enable / Disable Reference.

Zone TypesCopy Anchor Link

Config.ZoneTypes = { ... }

Defines the types of zones that shop owners can create through the management UI. Each zone type has:

Built-in zone types:

Wear TrackingCopy Anchor Link

Config.WearTracking = {
    SparkPlugs     = true,
    Oil            = true,
    AirFilter      = true,
    Tires          = true,
    Brakes         = true,
    Suspension     = true,
    Clutch         = true,
    Gearbox        = true,
    Pistons        = true,
    Radiator       = true,
    FuelPump       = true,
    Alternator     = true,
    WheelBalancing = true,
    Turbo          = true,
    AntiLag        = true,
}

Each entry controls whether that specific part's wear is tracked and simulated. Set any part to false to completely disable its wear system, the part will never degrade, and players won't be able to inspect or repair it.

Anti-Lag SystemCopy Anchor Link

Config.AntiLag = {
    Enabled    = true,
    MinRPM     = 0.6,
    MinSpeed   = 10.0,
    FireChance = 0.8,
    Cooldown   = 500,
}

Controls the exhaust backfire/pop effect that triggers when the anti-lag part is installed and active.

Check Vehicle AnimationCopy Anchor Link

Config.CheckVehicle = {
    Animation = "base",
    AnimDict  = "amb@world_human_clipboard@male@base",
    Object    = "prop_notepad_01",
    Bone      = 60309
}

The animation played when a mechanic inspects a vehicle's condition. The player holds a clipboard prop while checking.

Disabled Vehicle ClassesCopy Anchor Link

Config.DisabledVehicleClasses = {
    [13] = true,    -- Cycles
    [14] = true,    -- Boats
    [15] = true,    -- Helicopters
    [16] = true,    -- Planes
    [19] = true,    -- Military vehicles
    [20] = true,    -- Commercial vehicles
    [21] = true,    -- Trains
    [22] = true,    -- Open Wheel
}

Vehicle classes listed here are completely excluded from the mechanic system, they won't have wear tracking, can't be customised, and won't trigger any mechanic interactions.

The numbers are GTA V vehicle class IDs. Common classes:

Brake Glow EffectCopy Anchor Link

Config.BrakeGlow = {
    Enabled        = true,
    HeatIncRate    = 10.0,
    CoolRate       = 4.0,
    GlowThreshold  = 80,
    MaxHeatFront   = 800,
    MaxHeatRear    = 400,
    UpdateInterval = 50,
    EnabledClasses = { ... }
}

A visual effect where brake discs glow red/orange when hot from heavy braking.