Features
Kartik-Mechanic is a fully-featured, realistic mechanic system built from the ground up. Here's an overview of everything included.
🔧 Customs Menu
A full vehicle customs menu with categories for performance upgrades (engine, brakes, transmission, suspension, turbo), cosmetic mods (spoilers, bumpers, liveries, and more), respray with color picker, and wheel customization. All modifications require the mechanic to have the correct parts in their inventory.
🛠️ Realistic Part Wear & Maintenance
Every vehicle tracks wear on 15 individual components — spark plugs, engine oil, oil filter, air filter, tires, brakes, suspension, clutch, gearbox, pistons, radiator, fuel pump, alternator, turbo, and wheel balancing. Each part degrades over distance driven and produces realistic side effects when worn (e.g. reduced braking power, steering vibration, engine smoke, tire blowouts).
🔩 Repair & Replace System
Mechanics can either repair a worn part (partially restoring its condition) or replace it entirely with a new part item. Each action has its own required item, animation, and duration — fully configurable.
🎮 Centralized Minigames & Failure
A unified minigame system for all repair and installation actions.
Dynamic Job Check: Mechanics (defined in registered shops) can bypass minigames entirely or face easier challenges.
Non-Mechanic Usage: Allows civilian players to use repair kits, but requires completing a minigame.
Failure Consequences: Failing a minigame can result in vehicle damage (decreased engine/body health) and loss of the repair item.
🧰 Tiered Repair Kits
A multi-tier repair kit system (Standard, Advanced, Helicopter) that allows for customizable repair rules. Each kit can be configured to repair or replace specific categories of parts (e.g. body, engine, mechanical wear) with different efficiency levels and vehicle class restrictions.
🧽 Vehicle Wax & Protection
Vechicles can be protected with different tiers of wax (Basic, Advanced, Premium). Wax layers slow down dirt accumulation over time based on a protection factor and last for a defined distance driven.
🧼 Cleaning Kit
A dedicated cleaning kit for washing vehicles. Features a realistic washing animation using a sponge prop and water/soap particle effects. Successfully washing a vehicle is a prerequisite for applying wax.
🏎️ Engine Stages (1–3)
A tiered engine upgrade system. Mechanics open Engine Boxes (loot crates) to obtain crafting materials (pistons, crankshafts, valves, turbo/supercharger parts), then craft performance engines that increase power output but also increase wear rate.
💨 Turbo System (4 Stages)
Four turbocharger tiers from a street 27mm to a racing 52mm turbo. Each stage offers greater boost but wears faster and requires more maintenance. Turbos degrade dynamically based on RPM and can blow at very high wear levels.
🔥 Anti-Lag System
When enabled and the turbo/anti-lag part is installed, vehicles produce exhaust backfire pops at high RPM. Configurable RPM threshold, speed threshold, fire chance, and cooldown.
🔴 Glowing Brake Discs
Visual brake disc glow effect that responds to heat buildup. Heat increases when braking and dissipates when not braking. The glow only appears after a configurable heat threshold is reached. Configurable per vehicle class.
⚙️ Manual Transmission
A full manual gearbox system with configurable keybinds for shift up, shift down, and clutch. Includes RPM limiter warnings, engine stalling at low speed in high gears, engine lugging, and gear grinding when the gearbox is worn. Supports multiple gearbox types per vehicle: automatic, manual, and semi-automatic.
🎛️ Tuning Chip
An in-car tuning system that allows fine adjustments to boost, gear shift speed, rev limiter, and traction.
Parameters: Each parameter has a configurable min/max range and scale. Requires a tuning chip item and tuning tablet to access.
🛡️ Vehicle Electronics (TCS & ESC)
Advanced physical simulations of Traction Control (TCS) and Electronic Stability Control (ESC).
TCS: Detects wheel slip during acceleration and dynamically cuts engine power to regain traction.
ESC: Detects loss of steering control (yaw rate) and selectively applies braking to individual wheels to stabilize the vehicle.
Both systems can be toggled via keybinds and feature status indicators on the mechanic HUD. Fully configurable per vehicle class.
🏗️ Vehicle Stancing & Window Tint
Stancing: A stancing bay where mechanics can adjust the vehicle's suspension height and camber using a visual interface. Requires suspension parts.
Window Tint: A range of window tint options available in the customs menu, dynamically calculated based on the specific vehicle model's supported tints.
🏋️ Car Lifts
Physical car lift props that raise and lower vehicles for underside work. Each lift has configurable up/down speeds, height limits, and slow zones near the top and bottom.
📊 Dyno Testing
A fully dynamic dyno system that allows mechanics to run performance tests on vehicles.
Dynamic Placement: Dyno rollers are no longer hardcoded into config files. They are placed dynamically per-shop using the Object Gizmo tool.
Testing Zones: Define exact physical areas where testing is permitted to ensure realism.
Visualization: Includes real-time HP/Torque visualization in the Handling Editor preview mode.
📏 Mileage & Exports
Mileage Tracking: Realistic distance tracking per vehicle, persisting across restarts.
Developer Exports: Includes a
GetMileageexport for external script integration (e.g. for car dealerships or insurance systems).
🔨 Crafting System
A workbench crafting system with categories for performance engines, mechanical parts, and miscellaneous items. Each recipe has a required level and ingredient list. Crafted items go into a shop stash for claiming.
🏪 NPC Parts Store
Configurable NPC merchants that sell mechanic parts. Each store has its own item list, pricing, location, ped model, and map blip.
💼 Shop Management
A fully dynamic, database-driven management system. Unlike other scripts, you do not need to restart the server or edit config files to add new mechanic jobs.
In-Game Creation: Register, rename, and delete mechanic shops entirely in-game.
Spatial Protocol: Create and move zones (customs, stash, duty, crafting, billing, stancing, garage, dynos) using visual tools.
Employee Management: Manage employees, ranks, and permissions in real-time.
Financials: Set custom pricing for services and view detailed shop financials.
🎨 Handling Editor
An in-game handling editor (admin command) with both detailed mode (edit individual handling values like mass, drive force, traction curves, suspension settings) and simplified presets (one-click acceleration, traction, brake, and drivetrain profiles).
Improved UI: Features a scrollable category bar and real-time dyno data overlay during live preview.
Persistence: Changes persist to the database per vehicle.
💳 Billing System
Mechanics can bill nearby players for services. Integrates with your banking system through configurable bridge files.
🚗 Job Garage
A dedicated job garage system where mechanics can spawn work vehicles (like flatbeds). Features configurable spawn offsets, blips, and markers.
🏗️ Flatbed Loading System
A realistic flatbed towing system that allows mechanics to load and unload vehicles onto flatbed trucks. Features bone-based attachment, configurable offsets, and job restrictions. Supports add-on flatbed vehicles via configuration.
🌍 Bridge System
Kartik-Mechanic uses a bridge architecture for easy integration with different frameworks, inventories, fuel systems, target systems, vehicle keys, and banking scripts — all swappable without touching core code.
Last updated