# 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>" %}


---

# Agent Instructions: 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://anoxstudios.gitbook.io/anoxstudios/free-scripts/side-hustles/anox-carquest.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.