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

# anox-carquest

### ✨ Overview

<figure><img src="/files/X0vhNlBzElqMuSVobRfG" alt=""><figcaption></figcaption></figure>

> **anox-carquest** is a premium vehicle quest system where players hunt for specific cars, deliver them to earn rewards, and unlock progressively challenging lists. Perfect for servers seeking an engaging progression-based car collection mechanic.

### ✨ Features

* [ ] 🚗 **Multi Tier Vehicle Quests**

- Progressive unlocking system with multiple car lists
- Each list features different vehicle types and difficulties
- Earn rewards for completing full car collections
- Return to completed lists for additional rewards
- **Unlimited lists possible** - create as many vehicle categories as you want
- **Easy to add new vehicles** to any existing list

* [ ] 🔄 Dynamic Car Delivery System

- Simple delivery point for turning in vehicles
- Clear visual indicators showing valid target cars
- Smooth delivery experience with progress bars
- Automatic vehicle processing and validation

* [ ] 💰 Rewarding Progression

- Earn increasing rewards as you complete harder lists
- Additional bonus rewards for returning to completed lists
- Customizable reward amounts for each car category
- Adjustable bonus percentage for returning to completed lists

* [ ] 👨‍💼 **NPC Integration**

- Interact with npc using target system
- Clean menu interface using ox\_lib showing progress and available cars
- Visual status indicators for completed and in-progress lists
- Blips to easily locate the quest giver can toggle

* [ ] 🎮 **Intuitive Player Experience**

- Simple E-key delivery system
- On-screen prompts showing valid/invalid vehicles
- Detailed menus tracking completion status
- Database persistence for quest progress
- Admin command to reset any player's progress

* [ ] 🔧 **Framework Support**

- Works with **ESX**, **QBCore**, and **QBox**
- Full ox\_lib integration for UI and interactions
- Easy configuration for any server setup
- Localization support through **ox\_lib**

### ✨ Requirements

* [ ] One of the following frameworks:

- `ESX`
- `QBCore`
- `Qbox`

* [ ] **Must-have dependencies:**

- [`ox_lib`](https://github.com/overextended/ox_lib)
- [`oxmysql`](https://github.com/overextended/oxmysql)
- [`ox_target`](https://github.com/overextended/ox_target) or [`qb-target`](https://github.com/qbcore-framework/qb-target)

### ✨ Installation Guide

* [ ] **Step 1: Download the** [**Resource**](https://github.com/ANoXShadow/anox-carquest)
* [ ] Download the resource from our GitHub repository
* [ ] Extract the files to your server's `resources` folder
* [ ] Rename the folder to `anox-carquest`if it's not already named correctly
* [ ] **Step 3: Configure Your server.cfg**
* [ ] Add the following line to your `server.cfg` file:

```
ensure oxmysql
ensure ox_lib
ensure anox-carquest
```

**Step 4: Configure the Resource**

* Open the `config.lua` file in the `anox-carquest`folder
* Set your preferred framework:
  * `Config.Framework = 'esx'` for ESX
  * `Config.Framework = 'qb'` for QBCore
  * `Config.Framework = 'qbx'` for QBox

### ✨ Preview

{% embed url="<https://www.youtube.com/watch?v=vPv01PdK4dE>" %}