A&A Store Dealership

Give your players a premium dealership experience with A&A Store Dealership!

A modern, feature-rich FiveM dealership system designed for immersive roleplay servers. Let players browse an extensive vehicle catalog, preview vehicles with customizable colors, take timed test drives, and purchase their favorite vehicles using cash or bank money.

With private OneSync routing buckets, each player gets their own isolated showroom experience without sharing the showroom instance with other players.

✨ Key Features

• Private Showroom Instances — Individual player sessions powered by OneSync routing buckets.
• Modern NUI Interface — Browse vehicle categories, select vehicles, customize colors, view balances, and manage purchases through a clean interface.
• Multiple Dealership Types — Land vehicles included, with optional boat and aircraft dealerships.
• NPC Interaction — Dealership ped with blip support and E-key and/or target-based interaction.
• Vehicle Preview — Display vehicles with customizable colors and cinematic camera presentation.
• Bank & Cash Payments — Purchase vehicles using either payment method.
• Server-Side Price Validation — Vehicle prices are validated against the server-side catalog.
• Unique License Plates — Purchased vehicles receive their own plates, separate from showroom vehicles.
• Vehicle Ownership Integration — Supports ownership storage through configured framework vehicle tables.
• Vehicle Delivery — Spawn the purchased vehicle at the configured delivery location.
• Timed Test Drives — Configurable test-drive duration and optional temporary vehicle keys.
• Camera Presentation — Configurable intro animation, camera movement, and orbit speed.
• Optional Job Restrictions — Restrict dealership access by job where supported.
• Optional HUD Integration — Configurable HUD hide hook.
• Configurable Rate Limits — Protection for dealership entry, purchases, and test-drive actions.
• Sales Logging — Optional sales history stored in aastore_dealership_sales.
• Multilingual Support — English and Turkish locales included.

🚘 Vehicle Catalog

Configure your own vehicles, brands, labels, categories, and prices directly in config.lua.

The included default catalog covers a range of vehicle categories, including:

• Compacts
• Sedans
• SUVs
• Coupes
• Muscle Cars
• Sports Cars
• Supercars
• Motorcycles
• Off-Road Vehicles
• Vans
• Boats
• Helicopters
• Planes

Available categories depend on your configured vehicle lists and enabled dealership types.

Fully configurable pricing: Set your own prices and catalog entries to match your server's economy.

Note: This resource does not include a limited-stock system, vehicle inventory counters, financing, or loans.

💳 Purchase & Payment System

The purchase system supports both bank and cash payments.

• Prices are retrieved and validated server-side.
• Money is removed before vehicle ownership is saved.
• Failed ownership inserts attempt to refund the payment.
• Unique plates are generated for purchased vehicles.
• Optional vehicle key item integration is available through the inventory bridge.
• Optional sales logging is supported.

Framework vehicle-table compatibility depends on your selected framework and database configuration.

🏁 Timed Test Drives

Allow players to experience vehicles before purchasing them.

• Configurable test-drive duration.
• Configurable test-drive behavior and session settings.
• Optional traffic control within the private routing bucket.
• Optional temporary keys for the showroom vehicle.
• Configurable showroom and delivery locations.

🎥 Showroom Camera & Presentation

Create a more immersive vehicle-shopping experience with configurable camera effects.

• Intro camera sequence.
• Adjustable camera transition durations.
• Configurable vehicle orbit speed.
• Optional showroom time-of-day settings.
• Optional showroom weather settings.

🔑 Garage & Vehicle Key Integration

Purchased vehicles are saved with a configurable garage ID so they can be accessed through your existing garage resource.

Supported vehicle-key integrations include:

• qbx_vehiclekeys
• qb-vehiclekeys
• wasabi_carlock
• qs-vehiclekeys
• Renewed-Vehiclekeys

Automatic detection and integration behavior depend on the installed resources and configuration. You can also configure the key system as none.

Important: A&A Store Dealership is a dealership and vehicle ownership resource, not a complete garage UI.

⚙️ Supported Frameworks

Supported frameworks:

• Qbox (qbx_core)
• QB-Core (qb-core)
• ESX (es_extended)

Required dependencies:

• oxmysql
• OneSync
• One supported framework

Optional integrations:

• ox_target
• qb-target
• Supported vehicle-key resources
• Inventory resource for the optional key item

Custom framework forks, modified database schemas, and renamed vehicle tables may require additional configuration or adaptation.

🛠️ Configuration & Customization

Customize the dealership to fit your server through config.lua.

Available settings include:

• Framework and target system
• Language and currency
• Dealership entrance coordinates
• Showroom and delivery locations
• Vehicle catalog and prices
• Available vehicle colors
• Camera settings
• Test-drive duration
• Job restrictions
• Garage IDs
• Vehicle key integration
• Rate limits
• Optional showroom environment settings

Included locales:

• English (locales/en.json)
• Turkish (locales/tr.json)

📦 What’s Included?

• aastore_dealership FiveM resource
• Lua resource logic
• NUI dealership interface
• Editable configuration file
• English and Turkish locale files
• SQL helper for optional sales logging
• Barlow Condensed fonts
• SIL Open Font License (web/fonts/OFL.txt)

The resource is prepared for Cfx Asset Escrow where supported. NUI HTML, CSS, and JavaScript files are not encrypted by Asset Escrow.

📥 Installation

1. Install oxmysql and your supported framework.

2. Ensure OneSync is enabled on your FiveM server.

3. Place aastore_dealership in your resources directory.

4. Add the following line after its dependencies in your server configuration:

   ensure aastore_dealership

5. Configure your dealership locations, vehicle catalog, prices, framework, and integrations in config.lua.

6. Restart your server and test the dealership, purchases, vehicle ownership, garage integration, and test drives.

Optional sales-history database setup is available through database/install.sql. The sales table is also created automatically.

Configuration is required. Your server's framework, database, garage, and optional integrations should be tested before production use.

⚠️ Compatibility Notes

• Framework adapters are provided for the listed frameworks and integrations.

• Custom framework forks and modified vehicle database tables are not guaranteed to work without changes.

• Garage IDs must match the configuration expected by your garage resource.

• Optional inventory key-item mode requires a correctly configured inventory item.

• Test all integrations on your server before going live.

  Documentation & Installation

  Full documentation, installation instructions, configuration options and supported frameworks are available on GitHub.

  GitHub Documentation: https://github.com/AAStoree/aastore_dealership

• Discord Support: https://discord.gg/aastore

When requesting support, please include your purchase reference and relevant resource configuration details.

Updates and maintenance are not guaranteed on a fixed schedule.

YOUTUBE