Mechanic

This mechanic script is designed to elevate roleplay for both casual players and dedicated mechanics. Open and manage your own mechanic business, carry out in-depth vehicle diagnostics, perform realistic repairs and services, and interact with a highly detailed system using custom props, animations, and authentic tools. Every aspect—from inspections to part replacements—is crafted to simulate real-world automotive work, making this the go-to solution for servers seeking top-tier mechanic gameplay.

📘 Documentation
🎥 Showcase

Features

• Dynamic Shop Management – Admins can create, configure, sell, or remove mechanic shops entirely in-game, assign bosses, and customize markers without server restarts.

• Ownable Mechanic Shops – Players can operate fully interactive mechanic businesses with built-in markers for all mechanic functions, fully customizable to match different shop layouts.

• Realistic Component Structure – Vehicles are built from service parts and core parts, where service parts degrade over mileage and can damage core parts if not replaced on time.

• 1:1 Real-World Mileage Tracking – Vehicle mileage is tracked with near real-time accuracy and directly drives wear, degradation, and maintenance requirements based on vehicle class.

• Mechanical Servicing – Mechanics inspect vehicles and replace components using a workflow UI, supported by immersive props, animations, and visual effects.

• Core Part Malfunctions – Core parts progress through multiple health states that trigger real-time driving effects, with full failure disabling the engine unless temporarily patched.

• Service History – All mileage and part replacements are logged and accessible via a service book item or command for diagnostics, inspections, and resale checks.

• Body Repair System – Mechanics inspect body damage and repair individual parts such as doors, windows, hoods, and trunks using specific items with immersive props and effects.

• Repair Kits – Single-use repair kits provide configurable engine and body fixes, with basic kits available to all players and advanced kits restrictable by job.

• Car Lifts & Jacks – Adds realism through placeable shop lifts and portable jacks that raise vehicles or individual wheels using synced animations.

• Repair Stations – Map-based repair points allow vehicles to be repaired individually or fully, with configurable pricing, duration, access rules, and restrictions.

• Player Mechanic Menu – A configurable in-game menu provides mechanics with quick access to billing, towing, vehicle actions, and NPC missions.

• NPC Missions – Mechanics can earn income through NPC jobs such as towing broken-down vehicles, roadside repairs, or scrapping abandoned cars with randomized scenarios.

• Flatbed Towing – Vehicles can be attached and detached from supported flatbed trucks using clean logic and configurable placement offsets for precise positioning.

• Prop Emotes – Mechanics can place, move, and interact with props like cones and toolboxes using immersive animations to enhance roleplay scenes.

• Utility Vehicle Actions – Mechanics can push, flip, unlock, or impound vehicles through configurable job-based actions with realistic usage conditions.

• Billing System – Create detailed, itemized invoices with service notes that customers must confirm, with all transactions logged for transparency and shop records.

• Crafting Workbenches – Mechanics can craft tools, parts, and repair kits at workbenches using salvage materials and fully configurable recipes.

• Supplier System – Shops can order parts and repair items through a supplier menu, delivered to shop storage or player inventory with configurable pricing.

Dependencies

Frameworks: ESX (es_extended), QBCore, Qbox
Required: ox_lib, oxmysql/mysql, ox_target/qb-target
Inventories: ox_inventory, qb-inventory, qs-inventory, core_inventory, codem-inventory, origen_inventory, ak47_inventory, tgiann-inventory