RD Vehicle Shop

Installation

1. Dependencies

Download the release ZIPs of oxmysql, ox_lib and ox_target (links above) and put them into your resources folder.

2. The resource

Put the rd_vehicleshop folder into resources. Keep the folder name rd_vehicleshop.

3. Database

Import sql/install.sql into your server database (HeidiSQL, phpMyAdmin, …).

• Every table uses CREATE TABLE IF NOT EXISTS, so an existing owned_vehicles table from ESX is not touched.
• The script also creates any missing table or column by itself on start, so a later update needs no SQL.

4. server.cfg

The connection string must be set before any resource starts, and the order matters:

set mysql_connection_string "mysql://root:password@localhost:3306/fivem"

ensure oxmysql
ensure ox_lib
ensure es_extended        # or qb-core / qbx_core
ensure ox_target
# ensure screenshot-basic # optional
# ensure cd_garage        # optional

ensure rd_vehicleshop

5. config.lua

• Config.Framework = 'esx' (or 'qb' / 'qbox')
• Config.OwnedVehiclesTable: the table your garage reads (default owned_vehicles)
• Config.ExtraColumnsSingle / Config.ExtraColumnsCart: extra columns your garage needs (e.g. in_garage, garage_id). Missing columns are added automatically.

Everything else (shops, vehicles, prices, positions, language, marketplace, plates, test drive) is set in game in the admin panel.

6. Admin access

There are two ways, and either one is enough:

-- config.lua: ESX groups / QB permissions
Config.AdminGroups = {'admin', 'superadmin', 'owner'}

# server.cfg: ACE permission (framework-independent)
add_ace group.admin rd.vehicleshop.admin allow
add_principal identifier.license:YOUR_LICENSE group.admin

Optional: limit someone to their own shops with Config.AdminRoles (shop_manager).

7. First start in game

1. Type /vehicleshopadmin.
2. Shops → Edit → Positions in the world: place the vendor, vehicle delivery, test drive start, vehicle preview spot and the desk tablet (look at the spot, mouse wheel / arrows rotate, E confirms, ESC cancels).
3. Vehicles: add or edit vehicles (type the spawn code, and seats, speed and type are detected automatically). The Showcase tab adds cars that stand in the shop.
4. Settings: language, plates, daily deal, test drive, 2D/3D tablet, Discord webhook.

8. Vehicle images

The catalogue shows nui/img/vehicles/<model>.png. You can add images in three ways:

• put a PNG / JPG / WEBP named after the spawn code into nui/img/vehicles/,
• set an https:// image URL on the vehicle in the admin panel,
• or use Take photo in the vehicle form (requires screenshot-basic).

A car without an image shows a placeholder icon, so nothing breaks.