> For the complete documentation index, see [llms.txt](https://fetchq-store.gitbook.io/fetchq-store-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://fetchq-store.gitbook.io/fetchq-store-docs/advanced-fruit-and-vegetables-cargo-job.md).

# Advanced Fruit & Vegetables Cargo Job

## 🍎 FetchQ Fruit Job

An immersive agricultural logistics transport script for FiveM servers. Allow your players to take on fruit transport jobs, working solo with NPC laborers or teaming up with friends to load and deliver fruit crates to markets across Los Santos.

***

### 🌟 Overview

**FetchQ Fruit Job** introduces a dynamic, multi-step transport job. Players can sign up at the fruit depot to execute logistics operations ranging from loading fruit crates at the farm to delivering them to various city markets. With a built-in risk/reward system for legal and smuggling documents, custom animations, and group play support, this script provides a highly engaging economic activity.

***

### ✨ Features

#### 🚚 Transport & Logistics Missions

* **Two Major Job Modes:**
  * *Solo Mode:* Drive the transport truck (`mule3`) to the fruit farm loading bays, where hired NPC farmers automatically bring crates to your truck.
  * *Group Mode:* Form a party of 2-4 players. Manually pick up heavy vegetable crates from the ground, carry them using custom animations, and load them physically onto the transport truck.
* **Dynamic Deliveries:** Multiple market locations across the map (Strawberry, Davis, Mirror Park, Little Seoul, Downtown Vinewood, Tataviam Mountains, Paleto Bay, Sandy Shores).
* **Interactive NPCs:** Specialized delivery vendors dynamically spawn at market locations and approach the rear of the truck to receive the delivery.

#### ⚖️ Risk & Reward System

* **Weigh Station Mechanics:** After loading the truck, players must stop at the designated weigh station.
* **Document Choice:**
  * *Risk-Free (Legal):* Obtain a legal green document. Lower earnings but safe from police checkpoints.
  * *Risky (Smuggling):* Obtain a red document. Yields higher earnings but carries the risk of getting caught at police checkpoints.

#### 👥 Multiplayer & Squad Play

* **Party System:** Players can easily invite nearby players to join their fruit transport crew (up to 4 players total).
* **Cooperative Workflow:** In group mode, players share the physical labor of picking up, carrying, and loading crates onto the transport vehicle.

#### ⚙️ System & Administration

* **Universal Compatibility:** Seamless out-of-the-box compatibility with frameworks like `qb-core`, `qbx_core`, or `es_extended`.
* **Target & UI Integration:** Fully utilizes `ox_lib` for UI elements and supports target systems like `qb-target` and `ox_target`.
* **Job Restrictions:** Can easily restrict access to specific jobs (e.g., 'farmer') or require players to be on duty.

***

### 🚀 Installation & Configuration

#### 1. General Setup

The script **does not require** any dedicated SQL database tables. Simply ensure the resource is placed in your resources folder and started in your `server.cfg`.

#### 2. Item Configuration

Add the required transport documents (`green_document`, `red_document`) to your framework's inventory configuration.

#### 3. Framework Configuration (`config.lua`)

The script is highly customizable. Open `config.lua` to edit:

* **Economy & Payouts:** Adjust safe and risky payment bounds within `Config.Payment`.
* **Group Limits:** Configure group sizes via `Config.MinGroupSize` and `Config.MaxGroupSize`.
* **Locations:** Edit the coordinates for the depot, farm, loading bays, weigh station, and all delivery markets.
* **Job Settings:** Restrict the job by editing `Config.RequiredJob` or enforce on-duty status using `Config.RequireJobOnDuty`.


---

# 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, and the optional `goal` query parameter:

```
GET https://fetchq-store.gitbook.io/fetchq-store-docs/advanced-fruit-and-vegetables-cargo-job.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.