🏎️ AEGIS DEALERSHIP & 3D VEHICLESHOP
The Ultimate Player-Owned Automotive Business & Luxury 3D Showroom System
🌟 Turn Vehicle Shopping Into a Thriving Business Empire
Aegis Dealership & Vehicleshop transforms automotive sales on your FiveM server from a mundane menu into an immersive, player-driven economy and cinematic 3D showroom experience.
Designed with an ultra-responsive glassmorphism interface, Montserrat typography, and synthesized sound effects, players can inspect vehicles in 3D with full mouse controls, dynamic paint mixing, and real-time handling telemetry.
For entrepreneurs, it delivers a full-scale corporate management suite: purchase unowned dealerships, manage company vaults, recruit and position sales advisor NPCs in real-time, launch promotional discount campaigns, and earn automatic sales commissions on every vehicle driven off the lot!
💎 Feature Breakdown
🏢 1. Player-Owned Business & Vault Economy
- Dealership Purchasing: Players can purchase unowned dealerships directly in-game or have ownership granted by server admins.
- Automated Company Vault: Configurable commission percentage (e.g., 10%–15%) from every customer vehicle sale automatically credits directly into the business vault.
- Financial Management: Deposit and withdraw company funds securely through personal bank accounts.
- Liquidate Back to State: Owners can sell their business back to the city for a configurable reimbursement percentage + 100% of the remaining vault balance.
- Promotional Discount Sliders: Owners can activate store-wide sales discounts (0% to 25%) to drive customer rushes and outcompete rivals.
🧍 2. Real-Time Ghost Staff NPC Management
- In-Game 3D Ghost Placement: Position sales advisors anywhere on the lot using smooth keyboard controls (rotate, elevation, distance).
- Live Duty Toggles: Toggle advisors active/inactive instantly without server restarts.
- Staff Ped Models & Custom Roles: Choose from pre-configured ped models and rename staff with custom titles.
- Dynamic 3D Overhead Floating Badges: Proximity badges indicating staff roles and real-time dealership status (OPEN / CLOSED).
🏎️ 3. Cinematic 3D Vehicle Showroom
- Orbital 360° Studio Camera: Drag to rotate, scroll wheel to zoom, and right-click to adjust camera elevation.
- Dual-Palette Live Paint Customizer: Instant preview of primary & secondary metallic/matte colors with real-time studio lighting.
- Dynamic Vehicle Telemetry: Live HUD displaying Top Speed (KM/H), Acceleration, Braking, Traction Rating, and Seat Capacity straight from game handling files.
- Instant Category Filtering & Search: Rapid filtering across Super, Sports, SUV, Sedan, Muscle, Bikes, and Compacts with live debounce search.
- Flexible Payment Methods: Seamless selection between Cash and Bank balances.
⏱️ 4. Isolated Test Drive Simulator
- Dedicated Test Routing: Teleport players into a dedicated test vehicle at specified test spawn coordinates.
- Countdown HUD Widget: Floating glassmorphism timer with low-time visual warnings.
- Anti-Abuse Protections: Automatic safety termination if the driver exits the vehicle or runs out of time, smoothly fading back to the showroom desk.
📋 5. Live Audit Log Ledger
- Real-Time 60-Event History: Automatic database tracking of vehicle purchases, deposits, withdrawals, staff updates, and ownership transfers with date, actor, and financial logs.
🌍 6. Native 7-Language Multi-Locale Support
- Ready out-of-the-box with 7 built-in translations: English (en), Turkish (tr), German (de), French (fr), Spanish (es), Portuguese (pt), and Italian (it).
⚙️ Technical Specifications & Compatibility
Specification
Details
Frameworks
Qbox Framework (qbx_core), QBCore (qb-core), ESX Legacy (es_extended), Standalone Bridge
Database
oxmysql (Automatic schema migration on boot)
Target Systems
ox_target / qb-target / 3D Floating DrawText (Auto-detected)
Vehicle Keys
qbx_vehiclekeys, qb-vehiclekeys, wasabi_carlock, custom export bridge
Fuel Systems
ox_fuel, LegacyFuel, cdn-fuel, custom export bridge
Performance
0.00ms idle / 0.02ms - 0.04ms in active 3D camera inspection mode
Escrow Status
Cfx.re Asset Escrow Protected (Configs, locales, and bridge files remain 100% open-source)
📦 What Files Are Open-Source (Configurable)?
config.lua— All dealership coordinates, pricing, commission rates, vehicle categories, and models.shared/locale.lua— 100% editable translation strings across all 7 languages.bridge/client.lua&bridge/server.lua— Framework notifications, inventory, keys, and fuel callbacks.sql/install.sql— Clean SQL database structure.html/index.html&html/style.css— Full UI styling, fonts, and layout customization.
🚀 Easy 3-Step Installation
- Place the
aegis_vehicleshopfolder into your server'sresourcesdirectory. - Add
ensure aegis_vehicleshopto yourserver.cfgafter your framework andoxmysql. - Restart your server — database tables and default dealerships initialize automatically!
💬 Need Support or Have Questions?
Join our official Discord community for 24/7 technical assistance, updates, and custom integration guides.
