> 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/faq.md).

# FAQ

## For players

<details>

<summary>How do I open the farm tablet?</summary>

With `F6` or the chat command `/farmer`. If your server changed the key or another script uses `F6`, use `/farmer` or change the key under **Settings → Key Bindings → FiveM**.

</details>

<details>

<summary>What happens if my lease expires while I'm offline?</summary>

Ripe crops are moved to the farm storage automatically (one quality tier lower), unripe crops are lost. Afterwards the same field is locked for you for 30 minutes. Before it expires you get two warnings (2 hours and 30 minutes beforehand) if you're online.

</details>

<details>

<summary>My inventory is full – is the harvest lost?</summary>

No, it stays on the field. With the **field crate** upgrade (from level 15), harvest that doesn't fit into your inventory goes into the farm storage at the farm HQ. Without it the harvest stops with "inventory full" – make room (e.g. harvest basket) and harvest again.

</details>

<details>

<summary>Why can't I lease a field?</summary>

Either the field size isn't unlocked for your level yet (large fields from level 10), you have reached your lease limit (1 field at first, up to 6 later), or the field is still locked for 30 minutes after your last lease.

</details>

<details>

<summary>The machine doesn't work although I'm driving over the field.</summary>

Check in the work menu (`K`) that an operation is selected, don't drive too fast and drive the whole lane – a lane counts once about 80 % of its length has been covered. Some implements need an attached trailer. At 0 % condition the machine needs to go to the workshop first.

</details>

<details>

<summary>Do production and animals keep running while I'm offline?</summary>

Yes. Productions keep running in real time. Animals keep producing too, until their collection containers are full (16 hours at most). Animals never die, but poorly supplied animals produce less.

</details>

<details>

<summary>What does prestige do?</summary>

From level 100 you start again at level 1, keep all your unlocks and get a point for small permanent bonuses (9 % in total at most). There are up to 10 prestige tiers.

</details>

## For server owners

<details>

<summary>Does Pepper Farmer work with ESX, QBCore and Qbox?</summary>

Yes. Set your framework in `config/config.lua` under `Config.Framework` (`'esx'`, `'qbcore'` or `'qbox'`). oxmysql, ox\_lib, ox\_inventory and ox\_target are required as well – see [Installation](broken://pages/5f424a889b0098d2d8b9dbc80b3937f597007b1e).

</details>

<details>

<summary>Does it work with qb-inventory or qb-target?</summary>

No. Pepper Farmer needs **ox\_inventory** (items, farm storage, harvest basket) and **ox\_target**.

</details>

<details>

<summary>Do I need to install vehicle mods?</summary>

No. All machines use GTA vanilla vehicles. You can optionally add addon models in `config/vehicles.lua`.

</details>

<details>

<summary>Do I have to import the SQL file?</summary>

No, the tables are created automatically on first start. Only if your database user is not allowed to create tables do you import `install/pepper_farmer.sql` manually.

</details>

<details>

<summary>The locations don't match my map (floating boards, merchants in walls).</summary>

All positions are approximations. Move them in the tablet under **Admin → Locations / Fields** with **Set to my position** – this applies to all players immediately. See [Admin Tab & Locations](broken://pages/52a88d6a724c08c0b288cd67655c2b029d8140c3).

</details>

<details>

<summary>Will my adjusted positions be lost in an update?</summary>

No. They are stored in the database (table `farmer_locations`), not in the script's files.

</details>

<details>

<summary>Can I boost XP or income for an event?</summary>

Yes: `Config.Levels.globalXpMultiplier` in `config/levels.lua` for XP and `Config.Economy.globalMultiplier` in `config/economy.lua` for sales revenue and rewards. Then restart the resource.

</details>

<details>

<summary>Can I change the lease duration?</summary>

Yes, with `Config.FieldRules.leaseHours` in `config/fields.lua` (default 24).

</details>

<details>

<summary>Can another resource give money, XP or items through Pepper Farmer?</summary>

No. The exports are read-only (version, profile, level, unlocks). See [Commands & Exports](broken://pages/52556f3118b2fcddc36fe0fbf4d0fd402c7ccb5e).

</details>

<details>

<summary>How do I give myself admin rights?</summary>

Add `add_ace group.admin pepper_farmer.admin allow` and `add_principal identifier.license:YOUR_LICENSE group.admin` to `server.cfg`. The exact guide is in [Installation, step 10](broken://pages/5f424a889b0098d2d8b9dbc80b3937f597007b1e).

</details>

{% hint style="success" %}
Your question isn't here? The detailed troubleshooting is at the end of the [Installation](broken://pages/5f424a889b0098d2d8b9dbc80b3937f597007b1e) page. Otherwise our [Discord](https://discord.gg/6NaFJWKDYu) will help you.
{% endhint %}