> 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/docs/de/jobs/pepper-farmer/konfiguration.md). # Konfiguration Alle Einstellungen liegen offen im Ordner `pepper_farmer/config/`. Öffne die Dateien mit einem Text-Editor (Visual Studio Code oder Notepad++, **nicht** Word). **Starte die Ressource nach jeder Änderung neu** – am sichersten mit einem kompletten Serverneustart. {% hint style="info" %} **Offene Dateien (Asset Escrow):** Du darfst `config/`, `locales/`, `bridge/` und `install/` bearbeiten. Alle anderen Ordner (`client/`, `server/`, `shared/`, `modules/`) sind verschlüsselt und dürfen nicht verändert werden. Siehe [Asset Escrow](file:///getting-started/asset-escrow.md). {% endhint %} {% hint style="warning" %} **Vorsicht beim Bearbeiten:** Lass Anführungszeichen, Kommas und Klammern stehen. Ein einziges fehlendes Komma kann dazu führen, dass die Ressource nicht mehr startet. Mach vor größeren Änderungen eine Sicherheitskopie der Datei. {% endhint %} ## Dateien | Datei | Inhalt | | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | | `config/config.lua` | Framework, Sprache, Befehl/Taste, Konten (Bar/Bank), Qualitätsstufen, Sicherheit/Rate-Limits, Admin, Genossenschaft, Hoflager, Farmzentrale | | `config/levels.lua` | XP-Kurve, Ränge, Freischaltungen von Mechaniken, Pachtlimit je Level, Levelprämien, Prestige | | `config/upgrades.lua` | Farm-Upgrades (Stufen, Mindestlevel, Preis, Material, Wirkung) | | `config/crops.lua` | Pflanzen (Level, Fläche, Jahreszeiten, Wachstum, Wasser/Dünger, Ertrag, XP, Preis, Krankheiten, Props) | | `config/fields.lua` | Felder, Beete, Plantagen, Gewächshäuser, Pachttafeln, Pachtregeln | | `config/tools.lua` | Handwerkzeuge, Dünger, Pflanzenschutz, Krankheiten, Wasserstellen, Werkstatt, Saatgutlabor | | `config/weather.lua` | Jahreszeiten, Wetter, Temperaturen, optionale Kopplung an ein Wetter-Script | | `config/vehicles.lua` | Fahrzeuge/Geräte, Depot, Arbeitsbreiten, Tempo, Verschleiß, Reparatur, Taste im Fahrzeug | | `config/animals.lua` | Tierarten, Ställe, Futter, Produkte, Pflege, Zucht, Trüffelsuche | | `config/production.lua` | Produktionsmaschinen, Standorte, Rezepte, Maschinenstufen, Verschleiß | | `config/economy.lua` | Händler, Einkaufsläden (`Config.Shops`), Markt (Basispreise), Ruf, Hofladen, Landwirtschaftsschau | | `config/contracts.lua` | Auftragsbrett, Großaufträge, Staatsauftrag | | `config/challenges.lua` | Daily- und Weekly-Challenges, Wochentruhe | | `config/achievements.lua` | Erfolge und Titel | | `config/items/*.lua` | alle Items (Name DE/EN, Gewicht, Qualität, Einkaufspreis `price`) | | `config/server.lua` | nur Server: Discord-Webhook, Versionshinweis – wird **nie** an Spieler gesendet | | `locales/de/*.json`, `locales/en/*.json` | alle Texte auf Deutsch und Englisch | ## Wichtigste Einstellungen in `config/config.lua` | Einstellung | Standard | Bedeutung | | ---------------------------------- | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | | `Config.Locale` | `'de'` | Sprache: `'de'` oder `'en'` | | `Config.Framework` | `'esx'` | `'esx'`, `'qbcore'`, `'qbox'` oder `'auto'` (siehe [Installation](broken://pages/76c13ba17f7dd3d3a9a5b311d45f31641bb6233a)) | | `Config.Debug` | `false` | Zusätzliche Konsolenausgaben zur Fehlersuche | | `Config.Currency` | `'$'` | Währungssymbol im Tablet | | `Config.Command` | `'farmer'` | Chat-Befehl für das Tablet (`/farmer`) | | `Config.Key` | `'F6'` | Standard-Taste für das Tablet | | `Config.Dashboard.anywhere` | `true` | Tablet überall öffnen (`false` = nur im Büro der Farmzentrale) | | `Config.DailyResetHour` | `5` | Um diese Stunde (Serverzeit) beginnt ein neuer Tag für den Tagesbonus | | `Config.Money.sales` | `'money'` | Konto für Verkäufe an Händler | | `Config.Money.contracts` | `'bank'` | Konto für Auftragsbelohnungen | | `Config.Money.rewards` | `'bank'` | Konto für Level-, Challenge- und Erfolgsbelohnungen | | `Config.Money.purchases` | `'cash_then_bank'` | Einkäufe: erst Bargeld, dann Bank | | `Config.Quality.priceMult` | `{ 1.00, 1.15, 1.35, 1.70, 2.20 }` | Preisfaktor je Qualitätsstufe 1–5 | | `Config.Admin.ace` | `'pepper_farmer.admin'` | ACE-Recht für Admins | | `Config.Admin.groups` | `{ 'admin', 'superadmin', 'god' }` | Framework-Gruppen mit Admin-Rechten | | `Config.Admin.command` | `'farmadmin'` | Name des Admin-Befehls | | `Config.Coop.maxMembers` | `6` | Mitglieder einer Genossenschaft (inkl. Besitzer) | | `Config.Coop.membersCanUpgrade` | `false` | Dürfen Mitglieder Farm-Upgrades kaufen? | | `Config.Storage.slots` | `80` | Plätze im Hoflager (das Gewicht steigt über das Upgrade „Hoflager“) | | `Config.Security.kickAfterStrikes` | `0` | `0` = nie kicken, sonst Kick nach so vielen abgelehnten Anfragen | | `Config.HQ` | Grapeseed | Farmzentrale (Blip, Büro, Hoflager) – besser im [Admin-Reiter](broken://pages/d4bca060ef2297c1d820a5a390d19f64d4374419) verschieben | Konten für `Config.Money`: `'money'` (Bargeld), `'bank'` oder – nur bei `purchases` – `'cash_then_bank'`. ## Weitere nützliche Einstellungen | Datei | Einstellung | Standard | Bedeutung | | --------------------- | ------------------------------------ | ---------------------------- | ------------------------------------------------------------------------------------- | | `config/levels.lua` | `Config.Levels.globalXpMultiplier` | `1.0` | Faktor auf alle XP (z. B. `1.5` = 50 % mehr) | | `config/levels.lua` | `Config.Levels.dailyBonus` | `{ cap = 2000, mult = 1.5 }` | Die ersten 2.000 XP am Tag zählen ×1,5 | | `config/levels.lua` | `Config.Levels.rewards` | Level 5–100 | Geldprämien beim Erreichen eines Levels | | `config/levels.lua` | `Config.Prestige.enabled` | `true` | Prestige ab Level 100 an/aus | | `config/economy.lua` | `Config.Economy.globalMultiplier` | `1.0` | Faktor auf Verkaufserlöse, Auftrags-, Challenge- und Erfolgsbelohnungen | | `config/economy.lua` | `Config.Economy.shopPriceMultiplier` | `1.0` | Faktor auf alle Preise der Einkaufsläden | | `config/fields.lua` | `Config.FieldRules.leaseHours` | `24` | Pachtdauer in Stunden | | `config/fields.lua` | `Config.FieldRules.priceMult` | `1.0` | Faktor auf alle Pachtpreise | | `config/weather.lua` | `Config.Seasons.mode` | `'cycle'` | `'cycle'` (jede Jahreszeit 7 echte Tage), `'calendar'` (echter Kalender) oder `'off'` | | `config/weather.lua` | `Config.Weather.game.enabled` | `false` | GTA-Wetter eines Wetter-Scripts mitlesen | | `config/vehicles.lua` | `Config.Machinery.menuKey` | `'K'` | Taste im Fahrzeug für das Arbeitsmenü | | `config/vehicles.lua` | `Config.Machinery.maxOutPerPlayer` | `2` | Gleichzeitig ausgeparkte Fahrzeuge je Spieler | | `config/server.lua` | `ServerConfig.Webhook` | `''` | Discord-Webhook für Admin- und Sicherheitsprotokolle (leer = aus) | ## Beispiele ### Sprache ändern In `config/config.lua`: ```lua Config.Locale = 'en' ``` {% hint style="warning" %} Die **Item-Namen** im Inventar kommen aus ox\_inventory, nicht aus dem Script. Wechselst du die Sprache, ersetze auch den Pepper-Farmer-Block in `ox_inventory/data/items.lua` durch den Inhalt von `install/ox_items_en.lua` (bzw. `_de.lua`) – siehe [Installation, Schritt 5](broken://pages/76c13ba17f7dd3d3a9a5b311d45f31641bb6233a). {% endhint %} ### Taste für das Tablet ändern In `config/config.lua`: ```lua Config.Key = 'F7' ``` {% hint style="info" %} `Config.Key` ist nur die **Standard-Taste**. Hat ein Spieler schon einmal gespielt, speichert FiveM seine Belegung. Jeder Spieler kann die Taste selbst ändern: **Einstellungen → Tastenbelegung → FiveM → „Farmer-Dashboard öffnen“**. Das gilt genauso für die Maschinen-Taste `K`. {% endhint %} ### Mehr Geld oder mehr XP für alle ```lua -- config/economy.lua: 20 % mehr Verkaufserlös und Belohnungen Config.Economy = { globalMultiplier = 1.2, -- … Rest unverändert … ``` ```lua -- config/levels.lua: doppelte XP (z. B. für ein Event) globalXpMultiplier = 2.0, ``` ### Einzelne Preise ändern * **Verkaufspreise am Markt:** `config/economy.lua` → `Config.Market.items` (Basispreis je Ware bei Qualität „Normal“). * **Einkaufspreise der Läden:** `price` des Items in `config/items/*.lua`. Welcher Laden (Saatguthandel, Gartengeräte, Dünger & Pflanzenschutz, Verpackung & Zutaten, Hof- & Tierbedarf) einen Artikel führt, regelt `Config.Shops` in `config/economy.lua` (explizite Liste → Namensanfang → Kategorie; jeder Artikel in genau einem Laden). * **Maschinen, Fahrzeuge, Tiere, Upgrades:** jeweils `price` in `production.lua`, `vehicles.lua`, `animals.lua`, `upgrades.lua`. ### Pachtdauer ändern ```lua -- config/fields.lua Config.FieldRules = { leaseHours = 48, -- statt 24 Stunden ``` ## Eigene Inhalte hinzufügen Freischaltungen entstehen automatisch aus den `level`-Feldern der Configs. Eine neue Pflanze, ein neues Tier oder ein neues Rezept erscheint also von selbst im Tablet, in der Level-Übersicht und in den Aufträgen. Die genauen Felder stehen jeweils am Anfang der Config-Datei und im Abschnitt **„Eigene Inhalte per Config“** der mitgelieferten `README.md`. | Neu | Datei | Kurz | | --------------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Pflanze** | `config/crops.lua` | Eintrag in `Config.Crops` mit `label`, `level`, `area`, `seasons`, `growSec`, `water`, `fert`, `yield`, `xp`, `seed`, `item`, `price`, `props`. Marktpreis in `config/economy.lua` (`Market.items`) ergänzen. | | **Tier** | `config/animals.lua` | Eintrag in `Config.Animals` **und** in `Config.AnimalOrder`, mit `level`, `price`, `ped`, `capacity`, `feedItems`, `product`, `pen`. Stallausbau als Upgrade `barn_` in `config/upgrades.lua`, neue Produkte in `config/items/animals.lua`. | | **Maschine / Rezept** | `config/production.lua` | Maschine in `Config.Machines` (`level`, `price`, `location`, `slots`, `maxTier`), Rezept in `Config.Recipes` (`machine`, `level`, `duration`, `inputs`, `outputs`, `xp`). Neue Produkte in `config/items/production.lua`. | | **Fahrzeug** | `config/vehicles.lua` | Eintrag in `Config.Vehicles` mit `model` (auch Addon-Modelle), `kind`, `level`, `price`, `ops`, `workWidth`, `maxSpeed`. | ### Neue Items in ox\_inventory übernehmen Neue Pflanzen oder Produkte bringen neue Items mit. So trägst du sie ein: 1. Server starten und in die **Serverkonsole** (nicht im Spiel) eingeben: ``` farmer_items de ``` (oder `farmer_items en`). Die Konsole meldet z. B. `[pepper_farmer] 265 Items → install/ox_items_de.lua`. 2. Den alten Pepper-Farmer-Block in `ox_inventory/data/items.lua` durch den neuen Inhalt von `install/ox_items_de.lua` ersetzen (wie in [Installation, Schritt 5](broken://pages/76c13ba17f7dd3d3a9a5b311d45f31641bb6233a)). 3. Server komplett neu starten. {% hint style="info" %} Neue Ernte-Items, die in den Erntekorb passen sollen, trägst du zusätzlich in die `whitelist` in `ox_inventory/modules/items/containers.lua` ein. {% endhint %}