RD Vehicle Shop

Always download the release ZIP (oxmysql.zip, ox_lib.zip, ox_target.zip), not "Source code".
The source code is not built and causes errors such as No such export ... in resource oxmysql.

Optional

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.

FAQ

How do I open the admin panel?
/vehicleshopadmin. The command name is Config.AdminCommand.

Where do I add shops, vehicles and categories? There is nothing in config.lua.
In the admin panel. shared/defaults.lua is only the starting catalogue for a fresh install. After that, the database wins.

How do I change the language?
Admin panel → Settings → Language. Included: English, Slovak, Czech, German.

How do I add my own language?

1. Copy locales/en.lua to locales/xx.lua.
2. Change Locales['en'] to Locales['xx'] and translate the texts.
3. Set date_locale, e.g. 'fr-FR'.

It appears in Settings automatically.

Can I sell addon vehicles?
Yes. The model must be streamed on your server. Type its spawn code in Add vehicle, and seats, speed and type are read from the model.

The car in the vehicle detail floats in an empty studio / in the sky.
Place the Vehicle preview spot for that shop (Edit → Positions in the world). Without it the empty studio is used.

Players don't get keys after buying.

• cd_garage: enable the key integration in Settings → General.
• Any other key system: add your export to Config.Keys.onVehicleOwned in config.lua.

Bought cars don't appear in my garage.
Check that Config.OwnedVehiclesTable is the table your garage reads, and set the extra columns it needs in Config.ExtraColumnsSingle / Config.ExtraColumnsCart. For QBCore / QBox, see the Framework note.

How does financing work? Can players lose the car while offline?

• The player pays a down payment and gets the car right away. Instalments are charged automatically from Config.Financing.account.
• With onlineOnly = true (default) the due date waits while the player is offline.
• After maxMissed missed instalments the car is repossessed.

How do company (job) shops work?
Set a job on the shop in the admin panel. Only employees can enter and they pay from the company account. A built-in account works out of the box. To use your own society system, fill Config.CompanyMoney.

How do I turn off the 3D tablet?

• Admin → Settings → Display: set the default view and whether players may switch.
• To disable 3D completely, set Config.Tablet3D.enabled = false.

My ox_target key is not ALT.
The label above the showcase cars only shows text. Change it with Config.Showcase.label.key.

How does a player end a test drive early?
Leave the vehicle, use the target on it, or type /returncar.

Can I limit how many cars a player owns?
Yes, with Config.MaxVehiclesPerPlayer (0 = no limit).

Can I edit prices in bulk?

• Select vehicles in the admin panel and use bulk edit.
• Or use Export / Import CSV. The files are in rd_vehicleshop/csv/.

Common errors

Turn on Debug in Admin → Settings to print detailed loading information to the server console ([rd_vehicleshop DEBUG] ...).