okok Vehicle Shop (QBCore / ESX)

okok Vehicle Shop is a vehicle dealership script for FiveM with separate QBCore and ESX versions. Players buy vehicles in a shop menu, and a business system lets them buy dealerships and hire their own employees.

Watch the preview video on YouTube

Features

• Three menus: the vehicle shop, a business menu for owners and employees, and an admin menu
• See which vehicles are in stock
• Change the vehicle colour in real time and check vehicle stats (max speed, acceleration and more)
• Vehicle display with camera shots from every angle
• Test drives: the player can't die during the test, the test ends when the player leaves the vehicle, and /cancel stops it (command configurable)
• Three default shops: a car dealership, an aircraft and helicopter shop and a boat shop
• Logs for every action

Business system

• Deposit and withdraw money
• See your best employee and which vehicles sell most
• Order and sell vehicles, set vehicle prices and view the sales history
• Hire and fire employees, change their grade and view their statistics
• When a business is sold, everyone on the server sees that it can be bought
• Employees can quit through the business menu and complete vehicle orders to earn money

Admin menu

• View information on all vehicle shops
• Change the owner and the money of a shop
• Add new vehicles to the shops and edit them later
• The command used to open the admin menu is vsadmin by default (configurable)

Configuration

• Use okokTextUI and okokRequests or not
• Same image for all vehicles or one image per vehicle
• Hide the minimap in the shop, camera transition times and camera shake
• Test drive time, km/h or mph, plate format
• Employee reward per completed order, owner discount when ordering, refund when selling a dealership, clear money on sale
• Max dealerships per player, max employees per dealership, admin groups, job ranks and a sub-owner rank
• Blips, shop locations and prices, cameras, vehicle categories, menu colours and webhooks

Requirements

• QBCore or ESX (separate resource for each)
• okokNotify (included)
• mysql-async for the ESX version
• Server artifacts above version 4752

Installation

• Import okokvehicleshop.sql.
• Set your webhook on line 1 of webhook.lua (QBCore) or sv_utils.lua (ESX).
• Configure config.lua, then ensure okokNotify and the vehicle shop resource in your server.cfg.
• Vehicle images go in web/img, named after the vehicle ID (PNG).