Extended Dealership Simulation (ESX/QB/vRP)

Extended Dealership Simulation - Advanced Vehicle Sales System for ESX/QB/vRP

Extended Dealership Simulation revolutionizes vehicle sales on FiveM servers by introducing realistic dealership management mechanics that go far beyond basic vehicle shops. This comprehensive system transforms car dealerships into fully-functional businesses with test drives, financing options, vehicle customization packages, and detailed sales tracking. Whether you're running a luxury showroom or a used car lot, this script provides the depth and flexibility needed to create engaging automotive commerce roleplay that keeps players coming back.

What's Included

This dealership package includes a complete end-to-end vehicle sales platform with buyer and seller perspectives. Customers can browse inventory, schedule test drives with time limits and route restrictions, apply for vehicle financing with interest rates and down payments, and customize vehicles before purchase. Dealership employees access management interfaces to adjust pricing, track sales metrics, manage inventory levels, set commission rates, and process trade-ins. The system integrates with your existing vehicle shops while adding layers of immersive realism that traditional spawner menus can't provide.

Core Features

• Test Drive System - Customers can test drive any vehicle in inventory with configurable time limits (default 5 minutes) and geofenced areas. If players attempt to steal test vehicles by leaving the zone or damaging them excessively, automatic repo systems return the vehicle and flag the player. Test drives give buyers hands-on experience before committing to expensive purchases.
• Vehicle Financing - Implement realistic loan systems with down payment requirements (10-30% configurable), interest rates based on credit score or player reputation, and installment payment plans. Players can finance vehicles they couldn't afford outright, creating ongoing financial commitments that drive continued server engagement.
• Inventory Management - Dealership managers can add vehicles to showroom inventory, set individual pricing with markup percentages, assign vehicles to specific salespeople, and track which cars are on test drives vs. available for sale. Supports unlimited vehicle capacity with categorization by class, brand, or custom tags.
• Sales Commission System - Configure commission rates for sales employees (flat rate or percentage-based), track top performers with leaderboards, and manage payouts through society accounts. Great for creating competitive sales environments where players hustle for the best deals.
• Trade-In Evaluation - Customers can trade in their current vehicles toward new purchases with automatic valuation based on vehicle class, condition (damage affects value), and mileage if tracked by other scripts. Trade-in credits apply instantly to purchase price, streamlining transactions.
• Customization Packages - Offer pre-built customization packages (Sport Package, Luxury Package, Off-Road Package) that bundle upgrades at package pricing, or let customers choose individual mods before purchase. Integrates with popular customs scripts to preview modifications.
• Multi-Framework Support - Fully compatible with ESX Legacy, QBCore, and vRP frameworks. Uses framework-native functions for money transactions, job checks, and society management to ensure stability and compatibility with your existing economy.

Perfect For

• Serious roleplay servers requiring realistic business operations
• Economy-focused servers needing money sinks and long-term financial goals
• Servers with active business/job systems where dealerships employ multiple players
• Communities wanting to move beyond basic vehicle shops to proper automotive commerce
• Servers that value player-driven economies with competitive markets

Technical Details

• Performance: 0.01-0.02ms resmon (optimized database queries and event handling)
• Database: Custom tables for inventory, sales history, financing agreements, and test drives
• Framework Integration: ESX societies, QBCore management, vRP business systems
• Dependencies: Framework (ESX/QB/vRP), mysql-async or oxmysql, vehicle shop system
• File Size: 4.8 MB (includes UI assets and documentation)

Installation

1. Extract the dealership script to your resources folder
2. Import the SQL file to create necessary database tables for inventory and financing
3. Configure framework type (ESX/QBCore/vRP) in config.lua
4. Set dealership locations, test drive zones, and financing parameters
5. Add job permissions for dealership employees (salesperson, manager roles)
6. Add 'ensure extended-dealership' to server.cfg after framework
7. Restart server and populate initial inventory through management menu

Framework Compatibility

• ✅ ESX Legacy - Integrates with esx_vehicleshop, society accounts for dealership revenue, and job-based permissions. Supports multiple dealership locations with separate inventories.
• ✅ QBCore - Compatible with qb-vehicleshop, management system, and shared jobs. Includes duty system integration so employees must clock in to access sales functions.
• ✅ vRP - Works with vRP business framework, groups, and permissions. Supports vRP's wallet/bank system for transactions and installment payments.

Advanced Configuration

The script offers deep customization through config.lua. Set global financing parameters like maximum loan terms (12-60 months), minimum down payment percentages, and interest rate ranges. Configure test drive restrictions including maximum distance from dealership, time limits, damage thresholds that trigger early returns, and whether police are notified if players flee with test vehicles. Adjust commission structures with tiered rates (higher percentage for expensive vehicles) and bonus thresholds for high-volume sales. Define multiple dealership locations with independent inventories, allowing luxury showrooms in Vinewood and economy lots in Sandy Shores.

What Makes It Stand Out

Extended Dealership Simulation stands apart by treating vehicle sales as a complete business simulation rather than a simple purchase menu. The test drive feature alone transforms the buying experience - players actually get behind the wheel before committing to five-figure purchases, creating organic moments where friends test drive together or salespeople ride along to pitch features. The financing system adds economic realism that benefits both players (affordability through payments) and server economies (sustained money circulation). Combined with robust management tools that give dealership jobs actual depth, this script turns car sales from a 30-second menu interaction into an engaging roleplay experience that can occupy players for hours.

Related ESX Scripts

• Vehicle Control UI
• SA:MP Inspired Nametags
• ESX Driving School Script
• Nation Bennys (ESX)