# Car Dealer

Give your players exciting reasons to visit your dealerships!

{% embed url="<https://youtu.be/qBJGoFzy_0w>" %}

## Features

| Feature             | Description                                                       |
| ------------------- | ----------------------------------------------------------------- |
| DUI Showroom        | Real-time vehicle catalog on in-game screens                      |
| NUI Catalog         | Interactive fullscreen catalog with 3D vehicle preview            |
| 3D Preview          | Interactive vehicle rotation with mouse drag                      |
| Test Drive          | Timer with milliseconds, return zones, penalties every 10 seconds |
| Multi-Dealer        | Unlimited dealership locations with unique configurations         |
| Multi-Language      | Polish & English (easily expandable)                              |
| Framework Support   | ESX, QB-Core, OX Core, ND Framework, Standalone                   |
| Tuning System       | Full vehicle customization menu with bone-based interactions      |
| Car Key Integration | Built-in support for popular vehicle key systems                  |
| Separate Showrooms  | Teleport players to private showroom instances                    |
| Stock System        | Per-vehicle stock management via JSON files                       |

## Display Modes

| Mode        | Description                                                      |
| ----------- | ---------------------------------------------------------------- |
| DUI Replace | Replace existing prop textures with catalog (dealership screens) |
| DUI Prop    | Spawn TV props with DUI texture for custom locations             |
| NUI Catalog | Fullscreen interface with camera view and 3D vehicle display     |

## Test Drive System

| Feature        | Description                                             |
| -------------- | ------------------------------------------------------- |
| Timer Display  | Real-time countdown with milliseconds (HH:MM:SS.mmm)    |
| Return Zone    | Configurable zone where player can return vehicle       |
| E Key Return   | Press E inside return zone while in vehicle to return   |
| Penalty System | Charges player every 10 seconds if vehicle not returned |
| Auto Teleport  | Returns player to dealer after returning vehicle        |

## Dependencies

| Dependency | Required | Description                                           |
| ---------- | -------- | ----------------------------------------------------- |
| ox\_lib    | Yes/No   | Core library for zones, callbacks, notifications, DUI |
| oxmysql    | Yes      | Database operations for vehicle ownership             |
| ox\_target | No       | Interaction system for targets                        |