esx_vehicleshop

esx_vehicleshop is the official car dealership for ESX Legacy. It turns Premium Deluxe Motorsport into a showroom where players buy vehicles that are saved to owned_vehicles, and optionally into a player-run cardealer job that orders stock, sells or rents cars to other players, and gets paid daily rent.

OverviewCopy Anchor Link

Two modes, controlled by Config.EnablePlayerManagement:

• Direct sales (false, default). Anyone can enter the showroom, browse vehicles by category and buy with cash. The vehicle spawns outside, the player is warped in, and a row is added to owned_vehicles with a server-generated plate.
• Car dealer job (true). Players with the cardealer job buy stock with society money into cardealer_vehicles, then sell or rent it to nearby players, return it to the provider for 75 % of the price, and manage the society stash through the boss actions marker. The society cardealer is registered with esx_society.

Reselling at the ResellVehicle marker pays Config.ResellPercentage of the catalog price and deletes the vehicle from owned_vehicles.

InstallationCopy Anchor Link

ensure oxmysql
ensure esx_lib
ensure es_extended
ensure cron
ensure esx_addonaccount
ensure esx_addoninventory
ensure esx_society
ensure esx_license
ensure esx_vehicleshop

On first start the resource also creates vehicle_rental_payments (daily rent receipts), converts a legacy varchar vehicle_sold.date to DATETIME when all values are valid, and adds the idx_vehicle_sold_date_plate index.

ConfigurationCopy Anchor Link

ZonesCopy Anchor Link

Config.Zones defines six points. Type = -1 hides the marker.

Catalog tablesCopy Anchor Link

INSERT INTO `vehicle_categories` (`name`, `label`) VALUES ('electric', 'Electric');
INSERT INTO `vehicles` (`name`, `model`, `price`, `category`) VALUES ('Neon', 'neon', 150000, 'electric');

Vehicles whose category has no matching row in vehicle_categories are not shown (the query uses an inner join).

RentalsCopy Anchor Link

In job mode a dealer can rent a stock car to a player. The rent is computed on the server (getRentalPrice). Every day at 22:00 the cron resource triggers PayRent(): rent is taken from each renter's bank and added to society_cardealer. If a renter cannot pay, the rental is removed ("evicted"). Each charge is written to vehicle_rental_payments, so a restart does not charge twice on the same day.

Developer APICopy Anchor Link

Client export GeneratePlateCopy Anchor Link

local plate = exports.esx_vehicleshop:GeneratePlate()

Returns a random plate in the configured format that is not in owned_vehicles (checked with the esx_vehicleshop:isPlateTaken callback). It yields, so call it from a thread. The shop itself generates plates on the server and ignores client plates.

CreateThread(function()
    local plate = exports.esx_vehicleshop:GeneratePlate()
    print(('Free plate: %s'):format(plate))
end)

Server callbacksCopy Anchor Link

Net events (client to server)Copy Anchor Link

The server broadcasts esx_vehicleshop:updateVehiclesAndCategories(vehicles, categories, vehiclesByModel) to clients.

Common issuesCopy Anchor Link

• "Dealer transactions disabled" in the console. One of the dealer tables is MyISAM. Convert it with ALTER TABLE <name> ENGINE=InnoDB;.
• Shop menu is empty. The vehicles table is empty or categories do not match vehicle_categories.name.
• Plate length warning. PlateLetters + PlateNumbers (+1 with space) is above 8.
• Rent is never charged. The cron resource is not started, or society_cardealer is missing in addon_account.
• Job menu does not show. Config.EnablePlayerManagement is off or the player does not have the cardealer job.

RelatedCopy Anchor Link

• esx_garage
• esx_society
• esx_license
• cron
• Database schema

Frequently asked questions