🚗 px-vehicleshop
High-performance, modern React-based vehicle dealership system for FiveM servers with 3D live showroom camera, timed test drives, financing, and category browsing.
Thank You for Your Purchase! If you need assistance, feature requests, or updates, join our Discord Support Server .
📋 Compatibility & Requirements
| Layer / Component | Supported | Details / Minimum Version |
|---|---|---|
| ESX Legacy | ✅ Supported | es_extended (v1.8+ / Legacy) |
| QBCore | ✅ Supported | qb-core (Latest & Stable builds) |
| Qbox (QBX) | ✅ Supported | qbx_core |
| Database | ✅ Required | oxmysql (vehicle ownership, garage & financing) |
| Interaction | ⚙️ Configurable | ox_target • qb-target • TextUI / DrawText |
| Vehicle Keys | ⚙️ Compatible | qb-vehiclekeys, wasabi_carlock, jaksam, custom |
| Fuel Systems | ⚙️ Compatible | LegacyFuel, ox_fuel, cdn-fuel, ps-fuel |
| Resmon Values | ⚡ Highly Optimized | 0.00ms (Idle) • 0.01ms (Showroom / Test Drive) |
| Minimum Artifact | 5848+ | FiveM server artifact build |
Installation
Download & Extract
Download the resource package from Keymaster and place it into your server’s resources directory.
Recommendation: Keep the folder name as px-vehicleshop.
- fxmanifest.lua
- config.lua
Add to Server Config
Add the startup command to your server.cfg:
ensure px-vehicleshopConfiguration
| Setting | Options | Description |
|---|---|---|
| Framework | "qb" • "esx" • "qbx" | Server core framework |
| Locale | "en" • "tr" | Interface and notification language |
| Interaction | "target" • "textui" • "drawtext" | How players open dealership menu |
Open config.lua to adjust dealership locations, pricing, vehicle categories, and functions.
Custom Keys & Fuel Integration
If you use custom vehicle lock or fuel scripts, update these callback functions in config.lua:
Config.GiveKeys = function(vehicle, plate)
-- Example for custom key scripts (qb-vehiclekeys / wasabi_carlock / etc.)
TriggerEvent('vehiclekeys:client:SetOwner', plate)
end
Config.SetFuel = function(vehicle, fuel)
-- Example for LegacyFuel, ox_fuel, ps-fuel
exports['LegacyFuel']:SetFuel(vehicle, fuel)
endFrequently Asked Questions
The dealership menu opens, but vehicle preview images do not load?
Config.ImageSource is reachable and returns valid image files (.png / .webp).⚠️ Troubleshooting
❌ Money Deducted But Vehicle Does Not Spawn / Keys Not Given
Cause: Framework vehicle table mismatch (owned_vehicles on ESX vs player_vehicles on QBCore) or a missing vehicle keys export function.
Solution: Check Config.DatabaseTable in shared/config.lua and ensure your server’s key resource (qb-vehiclekeys, wasabi_carlock, or ox_inventory) is properly invoked inside Config.GiveKeys.
⚠️ Players Collide / See Each Other During Test Drive
Cause: Server artifact does not support SetEntityRoutingBucket or routing bucket isolation is disabled in configuration.
Solution: Set Config.TestDrive.useRoutingBuckets = true in config.lua. Ensure your FiveM server artifact is version 5848 or newer.
⚠️ Target Interaction Does Not Appear on Dealership Ped
Cause: Target resource name mismatch (qb-target vs ox_target).
Solution: Set Config.TargetSystem = ‘ox_target’ (or ‘qb-target’) in shared/config.lua to match your installed targeting resource.
❓ FAQ (Frequently Asked Questions)
Money is deducted, but the vehicle doesn’t spawn or keys aren’t given?
Verify your vehicle database table names in your server configuration (e.g. owned_vehicles for ESX vs player_vehicles for QBCore) and confirm that your key export in Config.GiveKeys is functioning.
Target interaction is not showing up near the dealership ped?
Check Config.TargetSystem in config.lua and ensure your target resource name (qb-target or ox_target) matches your server installation.
Need Help?
👾 Join Our Discord Community
Have questions or need assistance with custom vehicle categories? Our support team is ready to assist.
Get Support ↗
Created with ❤️ by PixelSoft