Car Boosting & Vinscratch

Car Boosting & Vinscratch (resource qb-carboosting, version 4.0) adds boosting contracts to your QBCore server. Players join a queue and the server periodically gives the first person in line a random contract based on their boosting class (D, C, B, A, S, S+). A higher class means better chances for higher class contracts.

Players work together: one drives the vehicle while the other disables the trackers to escape the police.

Features

• Queueing system that hands out new contracts on a configurable interval
• Reputation and class saved per character (player metadata)
• Transfer contracts to other players (optionally blocked for players without the required class)
• Configurable money type for starting a contract (cash, bank, crypto)
• Contract vehicles get random neon and upgrades based on the contract class
• VIN scratched vehicles are added to the player_vehicles table and marked as VIN scratched, so police can check whether a vehicle is VIN scratched
• Hacks are synced across the vehicle, so different players can do the contract together and swap hackers. Only the front-seat passenger can hack, once per minute, while the vehicle drives above a minimum speed (60 MPH by default)
• By default, contract vehicles send a tracker blip to all police units every 20 seconds until the trackers are disabled
• Options to block police jobs from using the laptop and to require a minimum number of cops online
• Phone notifications show the current task (QBCore, GKS, Qs or lb-phone, other phones via the utils files)
• Around 100 pre-configured vehicle locations and around 55 drop-off locations; you can add your own
• Choice of ox_lib or QBCore notifications, ox_inventory or qb inventory, ox or qb target
• English and Dutch locale files
• Extensive logging and server console debug prints

Requirements

• QBCore Framework
• ox_lib
• oxmysql
• boostinghack (Lionh34rt) for the hacking minigame

Installation

• Place qb-carboosting in your resources folder and add ensure qb-carboosting to your server.cfg after its dependencies.
• Add the items boostinglaptop (Boosting Laptop) and boostingdisabler (Tracking Disabler) to your QBCore shared items and copy the included item images.
• In qb-core > server > player, add the metadata: PlayerData.metadata['boostingrep'] = PlayerData.metadata['boostingrep'] or 0 and PlayerData.metadata['boostingclass'] = PlayerData.metadata['boostingclass'] or 1
• Run the SQL: ALTER TABLE `player_vehicles` ADD COLUMN `vinscratched` INT(11) NOT NULL DEFAULT 0;
• Add a ['carboosting'] = 'discord webhook' log entry in qb-smallresources > server > logs.lua.
• Adjust shared/sh_config.lua (framework names, notify, phone, inventory, target, fuel script, intervals, ranks and contracts).

Commands

• makeboost: requires ace perms, gives a random boost to the first player in the queue
• boosting_queue: requires ace perms, prints the position and name of players in the queue
• setboostingrep: sets the boosting rep of a given player ID (Shared.Permission)