Enable / Disable Reference
Everything in Kartik-Mechanic can be turned off. This page is the shortcut: every on/off switch in one place, with the file to open and the line to change.
All config files live in the shared/ folder of the resource. After changing any of them, restart the resource (or the server) for the change to take effect.
Major Systems
The big ones. Turn these off if another resource on your server already handles that feature.
| System | Setting | File | Default |
|---|---|---|---|
| Tuning chip / ECU | Config.Features.TuningSystem | general.lua | ✅ On |
| Nitrous | Config.Features.NitroSystem | general.lua | ✅ On |
| Stance & camber | Config.Features.StanceSystem | general.lua | ✅ On |
| Vehicle dirt | Config.Features.DirtSystem | general.lua | ✅ On |
| Custom physics & torque | Config.Features.VehicleConfigPhysics | general.lua | ✅ On |
| Damage system | Config.DamageSystem.enabled | damage_config.lua | ✅ On |
| Seatbelt & harness | Config.EnableSeatbelt | seatbelt_config.lua | ✅ On |
| Electronics (TCS & ESC) | Config.Electronics.Enable | electronics_config.lua | ✅ On |
| Flatbed towing | Config.Flatbed.Enabled | flatbed_config.lua | ✅ On |
| Handling editor | Config.HandlingEditor.Disabled | handling/handling_cfg.lua | ✅ On (set Disabled = true to remove) |
| Anti-lag | Config.AntiLag.Enabled | general.lua | ✅ On |
| Brake glow | Config.BrakeGlow.Enabled | general.lua | ✅ On |
| Repair minigames | Config.Minigames.enabled | repair_config.lua | ✅ On |
| Laptop app integration | Config.UseLaptopApp | general.lua | ✅ On |
Config.HandlingEditor.Disabled is the odd one out: it is a disable flag, not an enable flag. false means the editor is available.
Already run a car wash script? Set Config.Features.DirtSystem = false. Kartik-Mechanic will then never touch vehicle dirt, so the two scripts stop fighting over the same value.
Part Wear
Each part's wear can be switched off individually. A part set to false never degrades, and players cannot inspect or repair it.
📄 general.lua → Config.WearTracking
| Part | Setting |
|---|---|
| Spark plugs | SparkPlugs |
| Engine oil | Oil |
| Air filter | AirFilter |
| Tires | Tires |
| Brakes | Brakes |
| Suspension | Suspension |
| Clutch | Clutch |
| Gearbox | Gearbox |
| Pistons | Pistons |
| Radiator | Radiator |
| Fuel pump | FuelPump |
| Alternator | Alternator |
| Wheel balancing | WheelBalancing |
| Turbo | Turbo |
| Anti-lag | AntiLag |
All are on by default. For a lightweight setup, set everything to false except Tires and Brakes.
HUD Elements
📄 general.lua → Config.HUD
| Element | Setting | Also requires |
|---|---|---|
| Mileage / odometer | Mileage | - |
| Gear indicator | Gears | - |
| Nitro gauge | Nitro | - |
| Seatbelt indicator | Seatbelt | Config.EnableSeatbelt |
| TCS / ESC indicator | Electronics | Config.Electronics.Enable |
Turning one off removes it for everyone, players cannot bring it back from the HUD editor. For positions, colours, and per-player customization, see HUD Customization.
Visual Effects & Immersion
| Feature | Setting | File | Default |
|---|---|---|---|
| Camera zoom during installation | Config.InstallationCamera | general.lua | ❌ Off |
| Camera movement while previewing mods | Config.PreviewCameraFocus | general.lua | ✅ On |
| Spray/smoke effect when respraying | Config.VehicleSprayEffect | general.lua | ✅ On |
| Auto-change engine sound with upgrade stage | Config.AutomaticEngineSounds | general.lua | ❌ Off |
| Seatbelt sound effects | Config.SeatbeltSound | seatbelt_config.lua | ✅ On |
| Gear shift hand animation | Config.ShiftAnimation | transmission_config.lua | ✅ On |
| Shift completion sound | Config.ShiftEndSound | transmission_config.lua | ✅ On |
Manual Transmission Options
📄 transmission_config.lua
| Feature | Setting | Default |
|---|---|---|
| Require clutch to change gear | Config.ManualClutch | ✅ On |
| Gear indicator UI | Config.ShowUI | ✅ On |
| Rev limiter | Config.EnableRevLimiter | ✅ On |
| RPM bounce while clutch held | Config.RpmCut | ✅ On |
| Block auto-reverse when braking | Config.PreventAutoReverse | ✅ On |
| Correct top gear speed to handling data | Config.TopGearSpeedCorrection | ✅ On |
| Penalty for releasing clutch mid-shift | Config.PenaliseEarlyRelease | ❌ Off |
Keybinds
| Keybind | Setting | File | Default |
|---|---|---|---|
| Register the seatbelt key | Config.EnableRegisterKeyMapping | seatbelt_config.lua | ✅ On |
Set this to false if another resource already owns your seatbelt key. See Commands & Keybinds for the full list of keys and where to change each one.
Access & Permissions
| Rule | Setting | File | Default |
|---|---|---|---|
| Only mechanics can use parts on vehicles | Config.RestrictPartUsageToMechanics | general.lua | ✅ On |
| Civilians can inspect a vehicle's condition | Config.AllowCiviliansToInspect | check_vehicle_config.lua | ✅ On |
| Shops can adjust their own prices | Config.AllowPriceAdjustment | general.lua | ✅ On |
| Mechanic must be on duty to repair | Config.MechanicDutyCheck.enabled | repair_config.lua | ✅ On |
| Flatbed restricted to mechanics | Config.Flatbed.JobRequired | flatbed_config.lua | ✅ On |
| Handling editor restricted to admins | Config.HandlingEditor.AdminOnly | handling/handling_cfg.lua | ✅ On |
| Jobs allowed in the Extras/Livery menu | Config.ExtrasMenuJobs | general.lua | police, ambulance |
Billing & Shop Behaviour
📄 general.lua
| Feature | Setting | Default |
|---|---|---|
| Hide prices in owned shops, bill later | Config.DeferredBilling | ❌ Off |
| Charge the customer when a receipt is generated | Config.PayOnGeneration | ❌ Off |
| Reopen the receipt after installation | Config.ReappearReceipt | ✅ On |
| New upgrade UI in the customs menu | Config.EnableNewUpgradeUI | ✅ On |
| Pull items from business stash automatically | Config.AutoStashConsumption.enabled | ✅ On |
Config.PayOnGeneration only does anything when Config.DeferredBilling is on.
Tuning Chip Categories
📄 tuning_config.lua → Config.Tuning.Categories
Turn off individual tabs in the tuning tablet without disabling the whole system.
| Category | Setting |
|---|---|
| Engine | Engine |
| Handling | Handling |
| Nitro | Nitro |
| Lighting | Lighting |
Vehicle Eligibility
📄 general.lua → Config.DisabledVehicleClasses
Vehicle classes listed here are excluded from the mechanic system entirely, no wear tracking, no customs, no interactions. Ships with cycles, boats, helicopters, planes, trains, military, commercial, and open-wheel disabled.
See General Settings for the full class ID list.
Maintenance Alerts & Saving
📄 general.lua
| Feature | Setting | Default |
|---|---|---|
| Warn players about worn parts | Config.ChangeWarnings | ✅ On |
| Automatic saving of mileage and wear | Config.Autosave | ✅ On |
| Debug prints in console | Config.Debug | ❌ Off, keep it off on a live server |