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

# Pepper Farmer

Farming as a career instead of a mini job: with **Pepper Farmer** you start with a leased garden bed in Grapeseed and work your way up to large fields with tractors, combines and a crop duster, barns with ten animal species and 40 processing machines, all the way to a co-op with its own farm brand, export orders and the state contract. Every one of the 100 levels unlocks something, every harvest has a quality, and the market reacts to supply, demand, season and events. Everything is managed in the **farm tablet** in the Pepper design.

{% hint style="info" %}
🧪 **Tested on our dev server:** Of course we test all scripts continuously on our own dev server “Pepper Scripts”.
{% endhint %}

{% hint style="success" %}
**Get Pepper Farmer:** [pepper-scripts.tebex.store](https://pepper-scripts.tebex.store/)
{% endhint %}

## Features

* **100 levels with 9 ranks** – every level unlocks something, plus level rewards, a daily bonus and **prestige** (up to 10 stars) with small permanent bonuses
* **47 crops + 3 legendary varieties** on beds, large fields, orchards, a vineyard, greenhouses and a mushroom cellar
* **24-hour field leases**, seasons, weather with forecast, frost, diseases and **five quality tiers**
* **13 machines on GTA vanilla vehicles** – cultivator, plough, seeders, water tank, mower, fertilizer spreader, combine, field sprayer, baler, crop duster
* **10 animal species** with feeding, watering, mucking out, brushing, milking, shearing, incubator, breeding with genetics, vet and truffle hunting with the truffle pig
* **40 processing machines and 112 recipes** in real chains – flour → dough → bread, milk → cheese → ageing cellar, grapes → must → wine, sausages, ham, dry-aged steak
* **Dynamic market** with 10 merchants, reputation per merchant, market events, season bonus, organic certificate and your own farm brand
* **Contracts:** contract board, server-wide group orders with leaderboard, supply contracts, export and the state contract
* **Farm:** farm storage, 19 farm upgrades, your own farm shop with NPC customers, weekly market and agricultural show
* **Co-ops** for up to 6 players, 22 daily and 14 weekly challenges, 56 achievements with titles
* **Admin tab in the tablet** with a location editor: move places and fields in game – no restart needed
* Secured server-side (action tokens, locks against duplication, rate limits, audit log)
* ESX, QBCore and Qbox via open bridges, German & English, config and locales open

{% hint style="info" %}
**GTA vanilla vehicles only:** all machines use vehicles that already ship with the game (e.g. `tractor`, `tractor2`, `bison`, `duster`). You don't need to install any vehicle mods. If you like, you can add your own addon models in `config/vehicles.lua`.
{% endhint %}

## At a glance

|                             |                                                                                                                                                                                                                                                               |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Version**                 | 1.0.0                                                                                                                                                                                                                                                         |
| **Framework**               | ESX Legacy (`es_extended`), QBCore (`qb-core`) or Qbox (`qbx_core`)                                                                                                                                                                                           |
| **FiveM server**            | build 7290 or newer, **OneSync** required                                                                                                                                                                                                                     |
| **Dependencies (required)** | [oxmysql](https://github.com/CommunityOx/oxmysql/releases), [ox\_lib](https://github.com/CommunityOx/ox_lib/releases), [ox\_inventory](https://github.com/CommunityOx/ox_inventory/releases), [ox\_target](https://github.com/CommunityOx/ox_target/releases) |
| **Database**                | MySQL 5.7+ or MariaDB 10.3+                                                                                                                                                                                                                                   |
| **Vehicles**                | GTA vanilla models only (no downloads needed)                                                                                                                                                                                                                 |
| **Languages**               | German, English                                                                                                                                                                                                                                               |
| **Delivery**                | Cfx.re Asset Escrow (`config/`, `locales/`, `bridge/`, `install/` open)                                                                                                                                                                                       |

## Pages

* [Installation](broken://pages/5f424a889b0098d2d8b9dbc80b3937f597007b1e) – detailed step-by-step guide, no programming knowledge needed
* [Configuration](broken://pages/ddc58590b5875d0bc2c03bce7ed67c85dbbc72c5)
* [Gameplay](broken://pages/1a04aaa4dfdab4bad7bdce58d9c948945a770729)
* [Admin Tab & Locations](broken://pages/52a88d6a724c08c0b288cd67655c2b029d8140c3)
* [Commands & Exports](broken://pages/52556f3118b2fcddc36fe0fbf4d0fd402c7ccb5e)
* [FAQ](broken://pages/cdf8e823c8f40ea7a9576c96c2f47842a738596e)
* [Changelog](broken://pages/569a1a91524876ee54188bdaa5747bb75e6b3cae)