Car Boosting & Vinscratch

Advanced Car Boosting & VIN Scratch System for QBCore

Transform your FiveM server into a high-stakes vehicle theft operation with this comprehensive car boosting system. Built from the ground up for QBCore servers, this script delivers an immersive criminal career path where players queue for contracts, steal high-value vehicles, evade police trackers, and ultimately scratch VINs to claim permanent ownership. With a sophisticated reputation system, class-based progression, and genuine team-based gameplay mechanics, this represents one of the most complete implementations of the popular car boosting mechanic.

What's Included

You're getting a production-ready system with queue management, contract distribution, tracker mechanics, police integration, and a complete VIN scratching workflow. The script handles everything from initial laptop use through final vehicle ownership, with extensive logging and debugging built in. Over 100 pre-configured spawn locations and 55 drop-off points mean you can deploy this immediately without spending hours on configuration. The included boosting laptop item, tracker disabler tool, and all necessary database modifications create a turnkey solution for servers wanting to add this popular criminal activity.

How the System Works

Players purchase or acquire a boosting laptop, then use it to join the server-wide queue. Periodically, the first person in queue receives a random contract based on their current boosting class (D, C, B, A, S, or S+). Higher reputation unlocks access to better contracts with more valuable vehicles. Once a contract is accepted, players locate the target vehicle, which spawns with random neon lights and performance upgrades matching its class tier. The real challenge begins when they enter the vehicle - tracker blips broadcast to all police units every 20 seconds until disabled.

This is where teamwork becomes essential. While one player drives the stolen vehicle above a minimum speed threshold, front-seat passengers can access hacking minigames every minute to disable individual trackers. The hack sync system means multiple players can participate - swap drivers, rotate hackers, or coordinate across different vehicles. Once all trackers are disabled and police are evaded, players deliver the vehicle to one of the randomly selected drop-off locations to complete the contract and earn their payout.

The VIN scratch mechanic adds permanent consequence and reward. Successfully boosted vehicles can have their VIN numbers scratched, adding them directly to the player_vehicles database table with a special flag. These vehicles become the player's property but are permanently marked as VIN scratched - something police can check during traffic stops, creating ongoing roleplay opportunities.

Key Features & Capabilities

• Queue-Based Contract System - Fair distribution with first-in-first-out contract assignment and admin commands to force contracts or check queue status
• Six-Tier Class Progression - Start with Class D vehicles and work up through C, B, A, S, and S+ as reputation increases with each successful contract
• Reputation Saved Per Character - Each character maintains independent boosting rep and class, stored in player metadata for persistence across sessions
• Contract Transfer System - Trade or sell active contracts to other players, enabling a secondary market for high-tier jobs
• Dynamic Vehicle Customization - Contracts spawn with random neon colors and performance upgrades scaled to contract class for visual variety
• Synced Hacking Mechanics - All players in a vehicle see the same hack progress; supports driver swaps and multiple hackers working together
• Police Tracker Integration - Automatic blips to all police units every 20 seconds until trackers disabled; configurable intervals and detection range
• VIN Scratch Database Integration - Permanently adds vehicles to player_vehicles table with vinscratched flag for police RP checks
• Flexible Payout Options - Configure rewards as cash, bank deposits, or cryptocurrency to match your server's economy
• Phone Notification System - Real-time task updates via compatible phone scripts; keeps players informed without UI clutter
• Extensive Location Library - 100+ spawn locations and 55+ drop-off points pre-configured across the entire map
• Performance Optimized - Runs at 0.00ms resmon when idle; efficient event handling and thread management
• Comprehensive Logging - Discord webhook integration for carboosting events plus detailed server console debug output
• ox_inventory Support - Full compatibility with ox_inventory including item definitions for laptop and disabler
• Multiple Phone Script Support - Works with popular phone resources for notifications and alerts

Perfect For

• Criminal Economy Servers - Add a high-risk, high-reward illegal activity that creates natural police interaction
• Gang RP Communities - Give criminal organizations a teamwork-focused income source with progression mechanics
• Competitive Servers - The class system and reputation tracking create goals for dedicated players to chase
• Police RP Servers - Generate organic police pursuits with the tracker system and VIN scratch checks
• Economy-Focused Servers - Introduce a money sink (boosting laptops, disablers) and income source that scales with player skill

Technical Implementation

Config file

# Dependencies
* [QBCore Framework](https://github.com/qbcore-framework)
* [ox_lib by overextended](https://github.com/overextended/ox_lib)
* [boostinghack](https://github.com/Lionh34rt/boostinghack)

# Shared.lua items
```lua
-- Carboosting
[boostinglaptop] 	 	 	 = {[name] = boostinglaptop,           		[label] = Boosting Laptop,	 		[weight] = 1000, 		[type] = item, 		[image] = boostinglaptop.png, 		[unique] = false, 	[useable] = true, 	[shouldClose] = true,   	[combinable] = nil,   [description] = A laptop used for boosting contracts.},
[boostingdisabler] 	 	 = {[name] = boostingdisabler,           	[label] = Tracking Disabler,	 	[weight] = 1000, 		[type] = item, 		[image] = boostingdisabler.png, 	[unique] = false, 	[useable] = true, 	[shouldClose] = true,   	[combinable] = nil,   [description] = This small tool can disable these pesky trackers.},
```

# qb-core > server > player: Add to meta data
```lua
PlayerData.metadata['boostingrep'] = PlayerData.metadata['boostingrep'] or 0
PlayerData.metadata['boostingclass'] = PlayerData.metadata['boostingclass'] or 1
```

# Database
```sql
ALTER TABLE `player_vehicles`
ADD COLUMN `vinscratched` INT(11) NOT NULL DEFAULT 0;
```

# Make a log webhook for the 'carboosting' in qb-smallresources > server > logs.lua:
['carboosting'] = 'discord webhook'

# Useable commands:
'makeboost' - --> requires ace perms, gives a random boost to first in queue (forces queue)
'boosting_queue' - --> requires ace perms, prints position and player name of players in queue
'setboostingrep' - --> set the boosting rep of a given playerId (Shared.Permission)

Installation Overview

1. Install Dependencies - Ensure QBCore Framework, ox_lib, and boostinghack are installed and running
2. Add Items to Shared - Copy the boostinglaptop and boostingdisabler item definitions to qb-core/shared/items.lua
3. Update Player Metadata - Add boostingrep and boostingclass fields to qb-core/server/player.lua metadata initialization
4. Run Database Migration - Execute the ALTER TABLE command to add vinscratched column to player_vehicles
5. Configure Webhook - Add your Discord webhook URL to qb-smallresources/server/logs.lua for carboosting events
6. Install Resource - Extract to your resources folder and add to server.cfg
7. Configure Settings - Adjust money type (cash/bank/crypto), spawn locations, payout amounts, and class progression in config
8. Test Queue System - Join queue as player, use admin commands to verify contract distribution and logging

Framework Compatibility

• ✅ QBCore - Specifically designed for QBCore with metadata integration and item system support
• ✅ ox_lib - Required dependency for UI elements and utility functions
• ✅ ox_inventory - Full support with item images and metadata
• ✅ Multiple Phone Scripts - Compatible with popular phone resources for notifications
• ❌ ESX - Not compatible; built specifically for QBCore framework

What Makes It Stand Out

Unlike basic car theft scripts, this system creates a complete criminal career path with genuine progression mechanics. The synced hacking system is particularly innovative - players can actually work together in real-time, swapping roles during active pursuits. The VIN scratch integration adds permanent consequences that extend beyond the initial theft, creating ongoing roleplay scenarios when police check vehicle history. With 155+ pre-configured locations and extensive admin tools, you get a production-ready system that rivals what you see on major NoPixel-style servers, but with the flexibility to customize every aspect to your server's needs.

Admin & Management Tools

• makeboost Command - Force a contract to the first player in queue (requires ace permissions)
• boosting_queue Command - View current queue with player names and positions
• setboostingrep Command - Manually adjust player boosting reputation (configurable permission level)
• Discord Logging - Automatic webhook notifications for all boosting activities
• Console Debug Prints - Extensive server-side logging for troubleshooting and monitoring

Requirements

• QBCore Framework (latest version)
• ox_lib by overextended
• boostinghack resource
• MySQL database access for player_vehicles table modification
• Compatible phone script (optional, for notifications)
• ox_inventory (optional, but recommended)

Server Impact: 0.00ms idle, minimal impact during active contracts. Tested on servers with 200+ concurrent players.

Related QBCore Scripts

• 3CORE - GARAGES / PARKING
• CopNet MDT (ESX/QB)
• FiveM Torture System
• Origen Radio