Story Vehicle Dealership - Custom Car Sales Script with QTarget Integration
Transform your FiveM server's vehicle sales experience with the Story Vehicle Dealership script, a fully customizable car sales system featuring qtarget interaction, easy configuration, test drive mechanics, and seamless framework integration. Perfect for car dealer jobs, vehicle purchase systems, showroom management, sales commissions, and creating immersive automotive business roleplay.
What's Included
The Story Vehicle Dealership script delivers a complete vehicle sales framework with qtarget-based interactions, configurable vehicle catalogs, test drive functionality, purchase processing, financing options, delivery systems, commission tracking for salespeople, admin vehicle management, and extensive customization through an easy-to-edit config file. The script includes both customer-facing purchase mechanics and employee job features for comprehensive dealership operations.
Key Features
- QTarget Integration - Modern interaction system using qtarget for browsing, test drives, purchases
- Easy Configuration - Simple config.lua setup for vehicle lists, prices, spawn locations
- Test Drive System - Timed test drives with auto-return or purchase options
- Vehicle Categories - Organize inventory by class (sports, sedans, SUVs, commercial)
- Purchase Processing - Bank integration, cash payments, financing installment plans
- Sales Commission - Employee earnings tracking for dealer job roleplay
- Delivery Mechanics - Instant delivery or scheduled pickup from dealership
- Stock Management - Limited inventory system with restock mechanics
- Customization Preview - View vehicle colors and basic modifications before purchase
- Admin Controls - Add/remove vehicles, adjust prices, manage stock levels
- Multi-Location Support - Configure multiple dealership locations across the map
Perfect For
- Car Dealer Jobs - Salesperson positions with commissions and quotas
- Vehicle Economy - Controlled car sales preventing spawn abuse
- Business Roleplay - Dealership ownership, employee management, profit tracking
- Realistic Purchases - Immersive buying experience vs. simple menus
- Financing Systems - Loan mechanics for expensive vehicle purchases
- Showroom Displays - Physical vehicle showcasing with MLO integration
- Test Drive Events - Special promotions and limited-time vehicle sales
Customer Features
- Browse Catalog: QTarget interaction to view available vehicles with specs and pricing
- Test Drives: Take vehicles for timed test drives before committing to purchase
- Purchase Options: Buy outright with cash/bank or finance with payment plans
- Color Selection: Choose paint colors and basic customization options
- Vehicle Info: View stats including top speed, handling class, seating capacity
- Delivery Choice: Instant spawn or scheduled pickup from dealership lot
Employee/Dealer Features
- Sales Tracking: Monitor individual and total sales with commission calculations
- Customer Assistance: Help players browse, arrange test drives, process sales
- Stock Checks: View inventory levels and request restocks from management
- Commission Earnings: Percentage-based income from successful vehicle sales
- Finance Approval: Process loan applications and payment schedules
- Vehicle Prep: Arrange showroom displays and test drive vehicle staging
Installation
- Download the Story Vehicle Dealership resource package
- Ensure qtarget is installed and running on your server
- Extract dealership script to resources folder
- Configure vehicle catalog in config.lua (models, prices, categories)
- Set dealership locations and spawn points for purchases
- Configure job permissions for car dealer employees
- Add
ensure story-dealership to server.cfg
- Restart server and verify qtarget zones at dealerships
- Test purchase flow, test drives, and payment processing
Framework Compatibility
- ✅ ESX - Integrates with esx_vehicleshop, banking, job systems, garage scripts
- ✅ QBCore - Works with qb-vehicleshop, qb-banking, qb-garages, qb-management
- ✅ QBOX - Full support for job and banking frameworks
- ✅ QTarget - Required dependency for interaction system
Configuration Options
- Vehicle List: Define available cars with spawn codes, names, prices, categories
- Dealership Locations: Set coordinates for multiple dealer locations
- Test Drive Settings: Duration limits, restricted areas, auto-return timers
- Payment Methods: Enable cash, bank transfers, financing options
- Commission Rates: Set salesperson percentage earnings per vehicle type
- Stock Limits: Optional inventory restrictions and restock timers
- Job Permissions: Define which jobs can access dealer management features
- Financing Terms: Configure loan lengths, interest rates, down payments
Admin Management
- Vehicle Addition: Add new cars to catalog without script edits
- Price Adjustments: Modify vehicle costs for sales events or economy balancing
- Stock Control: Set inventory levels and manage restocking
- Sales Analytics: View total sales, revenue, top-selling vehicles
- Employee Reports: Monitor salesperson performance and commissions paid
- Test Drive Management: Adjust time limits and restricted zones
Customization & Integration
- MLO Showrooms: Works with custom dealership interiors and display areas
- Garage Systems: Integrates with parking scripts for vehicle storage
- Banking Scripts: Compatible with various economy frameworks for payments
- Society Systems: Dealership profits can feed into business accounts
- Modification Shops: Direct players to tuning after purchase
- Insurance Scripts: Offer vehicle insurance during sales process
Realistic Dealership Roleplay
Create authentic car sales experiences where employees greet customers, explain vehicle features, arrange test drives, negotiate prices, and process financing. Customers can browse showrooms, compare options, test drive before buying, and experience a realistic purchasing journey rather than simple spawning menus. The commission system incentivizes salespeople to actively engage with buyers, creating organic roleplay interactions.
What Makes It Stand Out
Story Vehicle Dealership elevates vehicle acquisition from a boring menu interaction to an immersive business experience. The qtarget integration provides modern, seamless interactions that feel natural compared to command-based systems. Unlike basic vehicle shops, this script supports complete dealership operations including employee jobs, test drives, financing, and commission tracking that creates economic gameplay. The easy configuration means you can quickly customize vehicle offerings without diving into complex code, while the multi-location support allows for competitive dealerships across your map. Whether you're a salesperson working for commission, a customer test-driving your dream car, or a business owner managing inventory and prices, this script transforms vehicle sales from a functional necessity into engaging roleplay content.
Video Preview
Preview: (streamable)
https://streamable.com/nkl70f
Support & Updates
Includes fast delivery and dedicated support for installation assistance, configuration guidance, framework integration, and customization help. The script is editable and open source, allowing you to modify and extend functionality as needed. Lifetime updates ensure compatibility with future framework versions and qtarget updates.
Technical Notes
- Dependencies: Requires qtarget for interaction system
- Performance: Optimized for multiplayer with minimal resource usage
- Editable: Open source code allows custom modifications
- Config-Driven: Most changes require only config.lua edits, no scripting needed
Related ESX Scripts