FiveM boosting script: how car boosting works
On a FiveM server, a boosting script turns car theft into a job. Players take contracts from a boosting tablet, find and lockpick the car, hack its police tracker and deliver it for money, credits and XP. It’s a crime system for roleplay servers, not an FPS boost pack or a Discord server boost.
Our Vehicle Boosting runs it on ESX, Qbox and QBCore. Every number in this guide comes from its shipped config, and you can change all of them.
How a contract runs
- A player with the
boosting_tabletitem opens the tablet and joins the queue. A new contract arrives every 30 to 60 seconds, with up to five waiting at once. - They accept one, and the car’s area shows as a circle on the map. Accepting gives them a group ID, so up to four players can work the contract together.
- They lockpick the car with the
boosting_lockpick, which opens the boostinghack minigame. The lockpick breaks on 25% of successes and 50% of fails. On Qbox and QBCore, the group gets the keys through qb-vehiclekeys. - In the higher classes, armed NPCs guard the car. They spawn when the lockpicking starts.
- The car carries a police tracker. While driving, they hack it with the
boosting_gpsitem, as many times as the class needs. Each successful hack makes the tracker update less often. - Once the tracker is off, they get a delivery point. If police are close, delivery stops with “Can’t deliver vehicle, there are cops nearby”. The money goes to the bank, with credits and XP on top, and a damaged engine cuts the reward.
The eight classes
Contracts run from D to S+, and XP from finished contracts unlocks the next class. The plus classes are more likely to spawn modified cars with guards. The higher the class, the more police it needs online and the more often police see the tracker:
| Class | Police online | Tracker hacks | Police see the tracker | Per player per restart |
|---|---|---|---|---|
| D | 0 | 0 to 1 | 0% | No limit |
| C | 0 | 1 to 3 | 10% | No limit |
| B | 1 | 2 to 5 | 50% | No limit |
| B+ | 2 | 3 to 7 | 100% | No limit |
| A | 2 | 2 | 100% | No limit |
| A+ | 2 | 5 to 8 | 100% | 3 |
| S | 3 | 8 to 13 | 100% | 2 |
| S+ | 3 | 13 to 15 | 100% | 1 |
Only jobs in Config count as police, and it lists police as shipped. Add your sheriff job there too, or sheriffs on duty won’t count. A contract that needs more police than are online is skipped, and starting one shows “Not enough police online”.
Credits, the shop and the auction
Contracts pay credits as well as money. Players spend them in the boosting shop and pick the order up from an NPC. As shipped, the shop sells a lockpick, the tablet, the boosting lockpick, the GPS device and a pistol for 15,000 money and 500 credits. If you don’t want guns coming out of boosting, remove the WEAPON_PISTOL line from Config.
Players can also put a contract up for auction. Others bid credits on contracts at their own level or lower, and the seller gets the winning bid.
XP and credits are saved in the resource’s own key-value storage, not in your database tables. The functions that read and add them are in server/, so you can move them elsewhere. Admins change them with addboostingcredits <id> <amount> and addboostingxp <id> <amount> in the server console. In game, they need the command and command aces (commands).
VIN scratching
VIN scratch contracts are off as shipped. A class gets them once you set its vinScratchPrice, and they cost extra money and credits. After the tracker is off, the player scratches the VIN at an LS Customs. On Qbox and QBCore, the car is then theirs to keep. On ESX, add your vehicle shop’s ownership event to VehicleVinScratched in client/.
A failed tracker hack resets the progress on a VIN contract. On a normal contract it doesn’t.
What it connects to
- Required: boostinghack, a free minigame resource on GitHub, and oxmysql or mysql-async.
- Inventory: ox_inventory or qb-inventory. The
boosting_tablet,boosting_lockpickandboosting_gpsitems must exist in it. How to add items to ox_inventory shows where they go. - Dispatch: set
Configto.Dispatch 'tk'for our Dispatch System or'cd'for cd_dispatch. Every successful lockpick then sends a “Vehicle Boosting” call to the police job. It’s off as shipped. - Keys: qb-vehiclekeys as shipped.
GroupVehicleLockpickedinserver/has a ready qbx_vehiclekeys line to uncomment, and that’s where another key script’s export goes too.main_editable.lua - Advanced Laptop: the tablet can also open as the Boosting app on our laptop script.
What to check before you choose
- Officers on duty. With no officer on, players only get D and C contracts. B needs one officer, B+ to A+ need two, and S and S+ need three. If your server is often short of police, lower
policeNeededfor the classes you want available. - Rewards and prices. Each class sets its rewards, contract price, XP and NPCs in
Config. The config docs cover classes, rewards and the shop..Classes - See it in game. The showcase on YouTube runs 3:57.
Vehicle Boosting is sold on its own, and it’s also in our Ultimate plan, which “Includes ALL current scripts and ALL future releases”. Compare the plans if you run several of our scripts.
