Mechanics Run

[Qb-Core] Mechanics Run - Vehicle Delivery Job System for QBCore Servers

The QbCore Mechanics Run script creates a comprehensive vehicle delivery and transport job system designed specifically for automotive mechanics and tow truck operators. This employment system sends mechanics on delivery runs to transport repaired vehicles back to customers, move impounded cars to storage lots, or shuttle dealership inventory between locations. Instead of mechanics standing idle at repair shops waiting for customers, this script generates continuous income opportunities through NPC delivery contracts and player-requested vehicle transport services. The system integrates seamlessly with QBCore's existing mechanic job framework while adding a new revenue stream that rewards efficient route completion and careful vehicle handling.

What's Included in This Job System

You're getting a complete vehicle delivery framework with NPC contract generation, GPS routing, damage penalties, and payment calculation systems. The script spawns delivery vehicles at mechanic shop locations and provides destination coordinates for drop-off points across the map. Mechanics can accept contracts through interaction points at garages or via phone-based job notifications.

The payment system factors in delivery distance, vehicle condition on arrival, and completion time bonuses for fast service. Damage detection tracks vehicle health during transport - dents, scratches, and mechanical damage reduce final payouts, encouraging careful driving. The script includes reputation tracking where successful deliveries build mechanic standing, unlocking higher-paying contracts and rare vehicle transport opportunities.

Key Features That Create Engaging Mechanic Work

• Dynamic Contract Generation - Automatically spawns delivery jobs with varied destinations, vehicle types, and payout amounts
• Distance-Based Payment - Longer delivery routes pay more, creating risk/reward decisions for mechanics choosing contracts
• Damage Penalty System - Vehicle condition tracking reduces payment for damaged deliveries, rewarding careful driving
• Time Bonuses - Fast completion times earn bonus pay, balancing speed against safety
• Reputation Progression - Successful deliveries increase mechanic standing, unlocking premium contracts
• Multiple Vehicle Types - Contracts include economy cars, luxury vehicles, motorcycles, and commercial trucks with varied payouts
• GPS Integration - Automatic route generation shows optimal paths to delivery destinations
• QBCore Job Integration - Works with existing qb-mechanicjob for seamless employment experience

How the Delivery System Works

Mechanics on duty access delivery contracts through interaction points at registered mechanic shops or garages. The job menu displays available contracts showing vehicle type, delivery distance, estimated payout, and difficulty rating. Upon accepting a contract, the script spawns the delivery vehicle at the mechanic's current location (or nearby parking area) and marks the destination on GPS.

During transport, the script continuously monitors vehicle health. Major damage events (collisions, rollovers) trigger significant payment penalties, while minor wear has minimal impact. Mechanics must balance speed (for time bonuses) against careful driving (to avoid damage penalties). Upon arriving at the destination marker, the delivery confirmation process checks final vehicle condition and calculates payment based on distance, damage, and completion time.

Perfect For These Server Applications

• Mechanic employment providing income between customer repair jobs
• Tow truck operators transporting impounded or abandoned vehicles
• Auto dealership employees shuttling inventory between showroom locations
• New player starter jobs teaching driving skills while earning money
• Criminal recovery operations (stealing and delivering hot vehicles to chop shops)
• Fleet management companies moving commercial vehicle inventory
• VIP transport services delivering luxury/exotic vehicles to wealthy clients

Technical Specifications

• File Size: ~4 MB (includes job logic, vehicle spawn configurations, and UI elements)
• Performance Impact: 0.01-0.02ms resmon (minimal resource usage during active deliveries)
• Framework Requirements: QBCore framework (qb-core) and qb-target for interaction points
• Database Integration: Stores mechanic reputation, delivery history, and earnings statistics
• Vehicle Spawn System: Configurable spawn points at mechanic shops with collision prevention
• Payment Range: Fully customizable ($50-$500+ per delivery based on configuration)

Installation and Setup

1. Extract the qb-mechanics-run resource to your resources/[qb] directory
2. Add ensure qb-mechanics-run to your server.cfg file
3. Import the included SQL file to create reputation and statistics tables
4. Configure job locations in config.lua (mechanic shop spawn points, delivery destinations)
5. Set payment rates, damage penalty multipliers, and time bonus thresholds
6. Configure vehicle spawn lists per contract difficulty tier (economy, standard, luxury, exotic)
7. Integrate with qb-target or your existing interaction system for job access points
8. Restart server and verify contract generation and payment systems function correctly

QBCore Framework Integration

• ✅ qb-core: Uses QBCore player job detection, ensures only mechanics can access delivery contracts
• ✅ qb-target: Creates interaction points at mechanic shops for job menu access (can use other interaction systems)
• ✅ qb-banking: Payments deposited to bank accounts or paid as cash based on configuration
• ✅ qb-phone: Optional phone app integration for remote contract browsing and acceptance
• ✅ qb-management: Boss menu integration allows garage owners to see employee delivery statistics

Reputation System and Progression

The reputation system tracks delivery success rates, average damage percentages, and on-time completion records. Mechanics start at Trainee rank with access to basic economy vehicle deliveries. As reputation increases through successful jobs, mechanics unlock Experienced, Professional, and Master tiers that offer higher-paying contracts involving luxury and exotic vehicles.

Failed deliveries (vehicle destroyed, excessive damage, abandoned contracts) reduce reputation and can result in temporary suspensions from premium contracts. This progression system creates long-term goals for mechanic players while naturally restricting new players from accessing the most profitable (and risky) delivery opportunities until they've proven their competence.

What Makes This Mechanic Job Stand Out

Traditional FiveM mechanic jobs focus exclusively on customer repairs, creating feast-or-famine income where mechanics earn nothing between service calls. Mechanics Run solves this problem by providing on-demand contract work that mechanics control. When customer traffic is slow, mechanics can fill downtime with delivery runs for consistent income. When customer demand surges, mechanics can ignore NPC contracts and focus on higher-paying player services.

The damage and time bonus systems create engaging gameplay that rewards skilled driving. Unlike simple point-A-to-B delivery scripts where players just drive while watching YouTube, this system demands attention. Mechanics must choose efficient routes, avoid traffic incidents, and manage speed carefully to maximize earnings. The vehicle variety keeps contracts interesting - delivering a rusted sedan to a impound lot feels different than transporting a Lamborghini to a luxury penthouse.

Configuration and Customization

Server owners have extensive control over economic balance and difficulty scaling. Payment rates can be configured per vehicle tier and distance bracket, allowing fine-tuning of income rates to match your server's economy. Damage penalty multipliers determine how punishing vehicle damage is - strict settings (high penalties) create challenging gameplay, lenient settings (low penalties) offer more forgiving income opportunities.

The contract generation system supports custom destination lists. Servers can create themed delivery routes - dealership inventory moves between showrooms, impound contracts target storage facilities, luxury deliveries go to mansion districts. Vehicle spawn lists are fully customizable, allowing servers to restrict certain vehicles to specific contract types or reputation tiers.

Roleplay Enhancement Tips

Mechanic shops can implement delivery quotas where employees must complete a certain number of runs per shift to maintain good standing. Create dispatcher roles where one mechanic manages contract distribution, assigning specific deliveries to drivers based on skill level and current location. Racing-oriented mechanics might bet on delivery times, competing to see who can complete routes fastest without damage penalties.

Criminal adaptations offer alternative gameplay. Corrupt mechanics might accidentally deliver vehicles to chop shop locations instead of legitimate destinations, splitting profits with criminal organizations. Police investigations could track suspicious delivery patterns, creating cat-and-mouse dynamics. Luxury vehicle deliveries could become robbery targets - criminals intercept high-value transports and steal vehicles en route.

Multi-Garage Operations

For servers with multiple mechanic shop locations, the script supports multi-garage configurations. Mechanics can work from any registered garage, with delivery contracts spawning vehicles at their current location. This allows garage owners to operate competing businesses - one shop might offer higher base pay to attract mechanics, another focuses on premium luxury contracts for experienced drivers.

The boss menu integration shows garage-specific statistics - total deliveries completed, average damage rates, top-earning mechanics. Garage owners can use this data for employee bonuses, performance reviews, or competitive leaderboards between shop locations. This business management layer adds depth for players interested in owning and operating mechanic services beyond just wrench-turning.

Income Balancing Guidelines

Delivery payments should be balanced against other mechanic income sources and server economy standards. A typical configuration might pay $75-$150 for short-distance economy deliveries (5-10 minutes), $150-$300 for medium-distance standard vehicles (10-15 minutes), and $300-$500+ for long-distance luxury deliveries (15-20 minutes). Time bonuses can add 10-25% for fast completion, while damage penalties might reduce payments by 5-50% depending on severity.

This structure makes deliveries profitable enough to be worth doing but not so lucrative that mechanics ignore player customers. The time investment should roughly match similar legal jobs (trucking, delivery services) while offering variety through the driving challenge and reputation progression. Test your payment rates against actual completion times to ensure mechanics earn reasonable hourly rates.

Performance and Optimization

The script uses efficient event-driven architecture that only processes active deliveries. When no mechanics are on duty or contracts are in progress, resource usage drops to near zero. Vehicle damage tracking uses optimized health monitoring that checks condition only during significant events (collisions, impacts) rather than constant polling.

GPS routing leverages native pathfinding without custom navigation systems, minimizing overhead. Contract generation occurs on-demand rather than pre-spawning hundreds of vehicles, keeping entity counts low. The database queries for reputation and statistics are batched and cached, preventing excessive database load from frequent lookups.

Support and Documentation

Purchase includes complete installation guides, configuration documentation, and QBCore integration examples. Support covers setup assistance, payment balancing recommendations, and troubleshooting. The well-commented codebase allows server owners with basic Lua knowledge to customize contract types, add new vehicle categories, or modify reputation requirements to match their server's progression systems.

Related QBCore Scripts

• OT Skill System
• 0r Animation Menu | 7000 Animaton Pack
• 0R HUD V3
• Trash Can Hide Emotes