> For the complete documentation index, see [llms.txt](https://acestudios.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://acestudios.gitbook.io/docs/jobs-and-economy/date-farming-job.md).

# Date Farming & Packaging Job

A full date farming production chain with quality tiers and farming zones.

**Date Farming & Packaging Job** (`ace_datepackagingJob`) is a complete production chain. Players harvest dates from palm trees, clean them at cleaning machines, package them at packaging machines, and sell them to an exporter NPC. Packaged dates get a **quality grade** that multiplies the sale price, and **farming zones** control which grades each area can produce.

|                   |                                                                                                                         |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------- |
| **Resource name** | `ace_datepackagingJob`                                                                                                  |
| **Version**       | 1.0.0                                                                                                                   |
| **Frameworks**    | ESX, QBCore, Qbox (auto-detected)                                                                                       |
| **Inventories**   | ox\_inventory, qb-inventory, qs-inventory, lj-inventory, ps-inventory, codem-inventory, core\_inventory (auto-detected) |
| **Interaction**   | ox\_target, qb-target, marker or 3D text                                                                                |
| **Dependencies**  | `ox_lib`                                                                                                                |
| **Languages**     | English, Arabic, German, Spanish, French, Russian, Turkish                                                              |
| **Database**      | Not used                                                                                                                |

## Production chain

```
Palm tree ──harvest──► Raw Dates (2–5)
                         │  5 raw
                         ▼
               Cleaning Machine ──► Clean Dates (5)
                         │  5 clean
                         ▼
              Packaging Machine ──► Packaged Dates (1, with a quality grade)
                         │
                         ▼
               Date Exporter NPC ──► Cash (Base Price × Quality Multiplier)
```

The amounts above are the defaults from `config.lua`.

## Items

|                                                                                                                                                                                                                                                                            | Item             | Config key                  |
| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | ---------------- | --------------------------- |
|        <img src="https://2698751888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeduQ6kxfGcEoMzSKJnCJ%2Fuploads%2Fgit-blob-d7ec612b31181dd0f0dcb159781b2bc853731b65%2Fdatejob-raw_dates.png?alt=media" alt="Raw dates" data-size="original">        | `raw_dates`      | `Config.Items.RawDate`      |
|      <img src="https://2698751888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeduQ6kxfGcEoMzSKJnCJ%2Fuploads%2Fgit-blob-42559c00036b21144f8bf8e4be98fd8d91cd8652%2Fdatejob-clean_dates.png?alt=media" alt="Clean dates" data-size="original">      | `clean_dates`    | `Config.Items.CleanDate`    |
| <img src="https://2698751888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeduQ6kxfGcEoMzSKJnCJ%2Fuploads%2Fgit-blob-f1adcaeffcfef944ef63178ec6523711b2a034ff%2Fdatejob-packaged_dates.png?alt=media" alt="Packaged dates box" data-size="original"> | `packaged_dates` | `Config.Items.PackagedDate` |

## Quality grades

| Grade   | Price multiplier | Sale price at `BasePrice = 100` |
| ------- | ---------------: | ------------------------------: |
| Normal  |             1.0× |                            $100 |
| Premium |             1.5× |                            $150 |
| Export  |             2.5× |                            $250 |

## Features

* Harvesting with a per-tree cooldown
* Cleaning and packaging machines with configurable inputs, outputs, animations and durations
* Weighted quality system with zone-based progression (5 tiers by default)
* Option to block harvesting outside farming zones
* Exporter NPC with a map blip
* Server-side distance validation
* Discord webhook logging
* Framework, inventory and interaction bridges in editable files

{% content-ref url="/pages/T9tyNPAdGQYhwpR2ooxY" %}
[Installation](/docs/jobs-and-economy/date-farming-job/installation.md)
{% endcontent-ref %}

{% content-ref url="/pages/tW43X6gTz26NdHy1tAQr" %}
[Configuration](/docs/jobs-and-economy/date-farming-job/configuration.md)
{% endcontent-ref %}
