# NTS Vehicle Marketplace

A comprehensive used car dealership script for FiveM, featuring an import system with auctions, player-to-player vehicle sales with contracts, and multi-framework support.

## 🚗 Features

* **Vehicle Import System** - Daily refreshed vehicle inventory with customizable spawn points
* **Auction System** - Competitive bidding between dealerships for import vehicles
* **Player-to-Player Sales** - Contract-based vehicle sales between players
* **Multi-Framework Support** - Works with ESX, QBCore, and QBox
* **Showroom Management** - Multiple dealership locations with dedicated garage zones
* **Dynamic Vehicle Pricing** - Configurable profit margins and price adjustments
* **Vehicle Condition System** - Mileage-based condition ratings
* **DUI Price Tags** - 3D price displays above vehicles in showrooms
* **Multi-Language Support** - English and Italian included, easily extendable

## 📋 Requirements

| Dependency                                                                      | Required   | Notes                         |
| ------------------------------------------------------------------------------- | ---------- | ----------------------------- |
| [ox\_lib](https://github.com/overextended/ox_lib)                               | ✅ Yes      | Core functionality            |
| [oxmysql](https://github.com/overextended/oxmysql)                              | ✅ Yes      | Database operations           |
| [ox\_inventory](https://github.com/overextended/ox_inventory)                   | ✅ Yes      | Contract item system          |
| [jg-vehiclemileage](https://github.com/JoeSzymkowiczFiveworx/jg-vehiclemileage) | ❌ Optional | Real vehicle mileage tracking |

## 🔧 Supported Frameworks

* **ESX** (Legacy and new versions)
* **QBCore**
* **QBox**
* Automatic framework detection available

## 📖 Quick Links

| Section                                                                           | Description                   |
| --------------------------------------------------------------------------------- | ----------------------------- |
| [Installation](https://nitesam.gitbook.io/nts-docs/usedcars/installation)         | Setup guide and prerequisites |
| [Configuration](https://nitesam.gitbook.io/nts-docs/usedcars/configuration)       | All config options explained  |
| [Client Functions](https://nitesam.gitbook.io/nts-docs/usedcars/functions)        | Client-side open functions    |
| [Server Functions](https://nitesam.gitbook.io/nts-docs/usedcars/functions-1)      | Server-side open functions    |
| [Shared Functions](https://nitesam.gitbook.io/nts-docs/usedcars/functions-2)      | Utility functions             |
| [Keys Integration](https://nitesam.gitbook.io/nts-docs/usedcars/keys-integration) | Vehicle keys system setup     |
| [Languages](https://nitesam.gitbook.io/nts-docs/usedcars/languages)               | Multi-language support        |
| [FAQ](https://nitesam.gitbook.io/nts-docs/usedcars/faq)                           | Common issues and solutions   |