PC-Mechanic

PC MECHANIC

The Ultimate Mechanic Business & Vehicle Customization System

Preview

Version: v1.3.1 | Author: PixelCraft Development

🔧 OVERVIEW

PC Mechanic is a comprehensive mechanic script that transforms vehicle customization and mechanic roleplay into a fully-featured business experience. Built with Vue.js and modern web technologies, this script offers everything from complete business management to advanced vehicle physics modifications and realistic maintenance systems.

Perfect for economy-focused RP servers looking for an immersive mechanic experience with extensive customization options and role-based permissions.

✨ KEY FEATURES

🏢 Complete Business Management

• Multiple workshop locations with independent operations
• Role-based permission system (Owner, Manager, Mechanic, Novice, Admin)
• On/off duty system with shift tracking
• Society funds management with separate business accounts
• Dashboard analytics with revenue tracking and customer ratings
• Employee commission system with automatic payments
• Customizable commission rates and pricing

🔧 Advanced Vehicle Customization & Tuning

Performance Upgrades:

• Engine upgrade options
• Drivetrain conversions (AWD, RWD, FWD)
• Anti Roll bars for better cornering
• Brake upgrades and specialized tire systems
• Launch control system for better traction
• 50+ handling parameters

Cosmetic Modifications:

• 50+ cosmetic parts (spoilers, bumpers, wings, exhausts)
• Advanced paint system with 160+ colors and multiple finishes
• RGB underglow and xenon headlights
• Window tinting and horn customization (40+ sounds)
• Livery system and license plate styles
• Wheel customization with 50+ types

Stance & Suspension:

• Adjustable suspension height
• Individual wheel camber control
• Track width adjustment and wheel offset
• Real-time preview with easy rollback

🛠️ Realistic Vehicle Servicing & Maintenance

Mileage-Based Degradation:

• Automatic mileage tracking with configurable HUD position, scale, and accumulation multiplier
• Service reminder system
• Component health tracking (suspension, tires, brakes, oil, clutch, filters, spark plugs)
• Progressive wear over time
• Damage-Based Degradation:
• Collision tracking with severity levels
• Oil leak system and engine seizure detection on low oil levels with advanced animations
• Configurable servicing part degradation based on damage

Advanced Inspection System:

• Detailed diagnostic systems for detection of servicing parts health using tools including:
• OBD Device, Tread depth tester, Pressure gauge for compression test, Multimeter etc. with custom props
• Per-tool variant and difficulty settings for external minigames

🔶 Dyno Testing with props (NEW)

• Realistic dyno test with custom animated props
• Custom DUI based screen
• View history, test, Maximize performance

🔶 Repair Zones (NEW)

• Define polygon-based work areas inside your shops — control exactly where employees can perform repairs and installations
• Per-zone mod category whitelisting (e.g. paint booth only allows resprays, main bay allows everything)
• Zones flash red when a mechanic tries to work outside the designated area
• Auto ground/ceiling snapping for proper zone height in MLOs and interiors
• Zone info HUD shows zone name and allowed mods when employees enter or leave
• Admin /viewzones command to visualize all zones with debug outlines in-game
• Full config control: enabled, autoAdjust, fallbackThickness, showZoneInfo, flashZoneOnRestriction, flashDuration, flashColor

🔶 Installation Modes (NEW)

• Choose how work order mods get installed on vehicles:
• - Individual — per-category minigame installation (classic behavior)
• - Sequential — "Install All" button, categories install one by one with a progress overlay
• - Bulk — single minigame installs everything at once

🔶 Admin Panel (FREE) - Pixelcraft · PC Configurator 

• Full web-based admin configuration panel for your mechanic script — edit every config value without touching a single file
• In-game Repair Zone creator: walk around and place polygon points with live ox_lib zone preview, no coordinate guessing
• Repair Zone management cards per shop with mod category chip selectors

💨 Nitrous Oxide (NOS) System

• Multiple bottle installation
• Customizable bottle sizes
• Speed multiplier with visual effects
• Bottle management and refill system (partial or full refill)

📋 Employee Work Order System

• Customer service requests with detailed specifications
• Order status tracking (Pending, In Progress, Completed)
• Dynamic pricing based on vehicle value
• Commission payments for completed orders

🏪 Parts Shop & Inventory

• Parts shop for mechanics to purchase parts
• Integration with Ox, QB, Quasar, Codem and Tgiann inventories
• Server-side shared stock management with low stock warnings
• 30+ parts categories including engines, tires, brakes and more
• Dynamic pricing and shipping system

🎮 Interactive Minigames

• Skill-based challenges (Easy, Medium, Hard)
• Visual guides and progress tracking
• Custom prop interactions (spanner, wheel animations, respray booth, engine hoist)

💰 Invoicing & Billing

• Detailed customer invoicing with itemization
• Payment tracking
• Invoice history and custom notes
• Multiple payment methods supported

🔌 COMPATIBILITY

Frameworks:

• QBCore, Qbox, ESX
• Interaction Systems:
• ox_target, qb-target
• Inventory Systems:
• ox_inventory, qb-inventory, qs-inventory, codem-inventory, tgiann-inventory, ak47-inventory, origen inventory,jaksam_inventory,l2s_inventory

UI Systems:

• ox_lib, okokNotify, okokTextUI, ps-ui, nox_notify, lation_ui, framework notifications
• Banking/Society Systems:
• qb-management, qb-banking, Renewed-Banking, okokBanking, fd_banking, esx_addonaccount, esx_society, wasabi banking,prism_banking, RXBanking,tgg_banking,crm_banking,p_banking

Skill / Progress Systems:

• ox_lib, lation_ui, qb-skillbar
• Damage systems:
• All default framework like vehiclehandler, Vehicle Deformation

Languages:

English, Spanish, Arabic, German, French, Italian, Japanese, Korean, Dutch, Polish, Portuguese, Russian, Turkish, Chinese

📦 DEPENDENCIES

Required:

• oxmysql
• ox_lib
• pc-mechanic-props
• ox_target (recommended)
• OneSync enabled

🚀 INSTALLATION

• Download and extract to resources folder
• Import SQL or let auto-adder run
• Add to server.cfg
• Configure config.lua
• Add inventory items
• Restart and use admin panel to create first shop