> For the complete documentation index, see [llms.txt](https://zloma-scripts.gitbook.io/zloma-scripts/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://zloma-scripts.gitbook.io/zloma-scripts/zloma_vehicleshop-paid/zloma_vehicleshop.md).

# Overview

**Complete dealership and showroom system for FiveM**

> **Requires** [**zloma\_core**](https://github.com/ZlomaScripts/zloma_core) — This script is built on top of zloma\_core, a universal framework wrapper for ESX, QBCore, and QBox.

zloma\_vehicleshop is a production-ready vehicle dealership resource with real showroom browsing, per-salon categories, test drives, trade-ins, visual admin tools, and an optional business layer with employees, orders, deliveries, pricing control, and financial tracking.

***

## Highlights

| Feature                   | Description                                                                                                                  |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| **Multi-Salon Support**   | Create multiple independent dealerships with their own vehicles, categories, NPCs, blips, and showroom layouts               |
| **Live Showroom Preview** | Spawn and inspect vehicles inside a private showroom instance with camera controls and color preview                         |
| **Tuning Preview**        | Let customers preview GTA V vehicle mods visually before buying without transferring those mods to the final owned vehicle   |
| **Test Drives**           | Timed test drive sessions with isolated routing buckets and automatic cleanup                                                |
| **Trade-In System**       | Exchange an owned vehicle toward a new purchase using configurable shop percentages                                          |
| **Admin Creator Tools**   | Full in-game salon CRUD with location picker, spawn editor, showroom editor, ped setup, and category/vehicle management      |
| **Business Mode**         | Employee management, stock orders, customer orders, pricing rules, showroom inventory, deliveries, and shop balance handling |
| **Localization Ready**    | English and Croatian locales included, open for edits in escrow releases                                                     |

***

## Dependencies

| Resource     | Required | Purpose                                                                |
| ------------ | -------- | ---------------------------------------------------------------------- |
| `ox_lib`     | Yes      | UI helpers, callbacks, menus, input dialogs                            |
| `oxmysql`    | Yes      | Database access                                                        |
| `zloma_core` | Yes      | Framework, money, job, notification, key, target, and utility wrappers |

***

## Escrow Layout

These files remain open in a production escrow build:

* `config.lua`
* `cl_customization.lua`
* `sv_customization.lua`
* `locales/*.lua`
* `shared/*.lua`

***

## Quick Links

* [Installation](/zloma-scripts/zloma_vehicleshop-paid/installation.md)
* [Configuration](/zloma-scripts/zloma_vehicleshop-paid/configuration.md)
* [Features](/zloma-scripts/zloma_vehicleshop-paid/features.md)
* [API Reference](/zloma-scripts/zloma_vehicleshop-paid/api-reference.md)

***

## Purchase

zloma\_vehicleshop is a paid resource. Join the Discord for purchase info and support:

**Discord:** [discord.gg/ccAz3NJGCt](https://discord.gg/ccAz3NJGCt)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://zloma-scripts.gitbook.io/zloma-scripts/zloma_vehicleshop-paid/zloma_vehicleshop.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.