> 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/activities/pepper-hunting.md). # Pepper Hunting Jagd als Freizeitaktivität für alle Spieler – lebendes Wild, Pirsch mit Wind und Spuren, Jagdschein mit Schonzeiten und Wilderei, Level 1–50, Jagd-Tablet, Jagdhund, legendäre Tiere und Wettbewerbe. > ✅ **Pepper Hunting holen:** > 🧪 **Getestet auf unserem Dev-Server:** Wir testen alle Skripte selbstverständlich permanent auf unserem eigenen Dev-Server „Pepper Scripts“. > 🎬 **Tutorial-Video:** ### Überblick Pepper Hunting macht die Jagd zu einer Freizeitaktivität für **alle Spieler** – ohne Job und ohne Betrieb. In **Jagdgebieten** lebt ein echter **Wildbestand**: Der Server weiß, welche Tiere wo stehen, gespawnt werden sie nur in der Nähe von Jägern, und erlegtes Wild wächst über die Zeit nach. Außerhalb der Gebiete bleibt die Stadt ruhig. Gejagt wird mit **eigenen Jagdwaffen**, die sich nur im Jagdgebiet ziehen lassen. Das Wild **hört, sieht und wittert**: Wind, Geräusche und Tarnung entscheiden, ob man nah genug herankommt. **Spuren**, **Fernglas**, **Lockrufe**, **Köder** und **Hochsitze** helfen dabei. Wo der Schuss sitzt, bestimmt die **Qualität** der Beute; angeschossenes Wild flieht und hinterlässt eine **Blutspur**. Wer legal jagen will, macht den **Jagdschein** (Theorie-Quiz + Schießstand) und beachtet **Schonzeiten** und **Tageskontingente** – sonst ist es **Wilderei**, die Beute wird illegal und die Polizei kann gerufen werden. Ein **Jäger-Level 1–50** (rund 60 Stunden) schaltet Erweiterungen, Waffen und Gebiete frei; das **Jagd-Tablet** zeigt Sammelbuch, Trophäen, Ranglisten und die Karte. Dazu kommen **Jagdhund**, **Fallen**, **legendäre Tiere**, **Jagdgruppen mit Treibjagd** und **Wettbewerbe**. Wildfleisch lässt sich für **Pepper Eats** zerlegen. ### Features * **Jagdgebiete:** 6 Vorgaben (Paleto-Wald, Mount Chiliad, Raton Canyon, Grapeseed-Felder, Tongva Hills, Great Chaparral) und beliebig viele weitere – im Spiel mit `/huntadmin` abstecken (Umriss ablaufen), Tierarten, Bestand, Mindest-Level, Blip * **Lebender Wildbestand** je Gebiet auf dem Server, Spawn nur in Jägernähe, Nachwuchs über Zeit – Hirsch, Wildschwein, Puma, Kojote, Kaninchen, Falke * **Eigene Jagdwaffen** (Jagdbüchse, Flinte, Jagdmesser) als Items, nur im Jagdgebiet ziehbar, verschossene Munition wird abgezogen * **Trefferzonen und Qualität:** Kopf/Herz-Lunge = sauber, Körper, Keule, Lauf – dazu passende Waffe, Mehrfachtreffer und Frische → Qualität 0–100 und 1–5 Sterne * **Pirsch:** Wild hört (Schleichen ist leiser), sieht (Blickfeld, Sichtlinie) und wittert (Wind je Gebiet, wechselt alle 10 Minuten); Raubtiere greifen an * **Spuren** (Fährte, Losung, Fraßstelle, Schlafplatz) führen zu Wild in bis zu 450 m; untersuchen zeigt Art, Alter und Richtung * **Nachsuche:** angeschossenes Wild flieht, blutet und verendet – der Blutspur folgen, der Schütze bekommt das Tier * **Fernglas** (Art, Geschlecht, Gewicht, erreichbare Sterne, Wind), **Wind- und Geräuschanzeige**, **Tarnkleidung** * **Lockrufe** für Hirsch, Wildschwein und Raubwild (zu oft rufen verscheucht), **Lockfutter** und **Salzleckstein** * **Hochsitze:** aufstellbar (Item) und fest (Admin) – von oben sieht und wittert dich das Wild schlechter * **Aufbrechen** mit Jagdmesser: Fleisch, Häute, Felle, Geweih, Keilerwaffen, Krallen, Federn als ox\_inventory-Items mit Qualität, Jäger und „legal/illegal“ * **Wildhändler** kauft nach Qualität mit Tagesschwankung, **Hehler** kauft gewilderte Beute zum Spottpreis * **Jagdschein:** Theorie-Prüfung (22 Fragen DE/EN, Lösungen nur auf dem Server) und Schießstand-Prüfung, Ausweis-Item, Erweiterungen Großwild, Raubwild, Nachtjagd * **Regeln:** Schonzeiten je Art und Wochentag, Tageskontingente, Nachtjagd – Verstoß = Wilderei mit Polizei-Meldung (ps-, cd-, qs-, rcore-, core\_dispatch oder eingebaut) * **Jagdladen** mit 17 Waren, Waffen und Munition nur mit passendem Schein und Level * **Jäger-Level 1–50** (≈ 60 Stunden) mit Freischaltungen: Erweiterungen, Laden-Waren, Gebiete, mehr Hochsitze, Köder und Fallen * **Sammelbuch** je Tierart mit Meilensteinen (XP + Geld), **Präparator** macht aus Beute **Trophäen** mit Punkten * **Jagd-Tablet** (Item oder `/hunttablet`): Übersicht, Level, Sammelbuch, Trophäen, Ranglisten, Karte, Hund, Gruppe, Wettbewerb, Legenden * **Jagdhund** (Retriever, Schäferhund, Husky) mit Namen, Füttern, Zuneigung und Hunde-Level: Bei Fuß, Sitz, Suchen (findet angeschossenes Wild zuerst), Apportieren * **Fallen** für Kleinwild (Drahtschlinge, Kastenfalle) – aufstellen, später kontrollieren * **Legendäre Tiere** (Weißer Hirsch, Alter Keiler, Schattenjäger, Geisterkojote) mit Gerüchten, Ruhmeshalle und besonderen Trophäen * **Jagdgruppen** bis 6 Jäger: Beute sofort aufbrechen, XP-Anteil, **Treibjagd** * **Wettbewerbe** (größter Hirsch, Sauenjagd, Kaninchen-Sprint, sauberster Schuss) nach Zeitplan oder durch Admins, mit Preisen * **Pepper-Eats-Verknüpfung:** Wildfleisch beim Wildhändler für die Restaurant-Küche zerlegen * **Admin-Menü** mit Gebieten, Orten (Händler, Hehler, Jagdschein-Büro, Schießstand, Jagdladen, Präparator, Hundezüchter, Hochsitze), Übersicht, Jagdschein/Level setzen, Wettbewerbe * 3 Discord-Webhooks, Server- und Client-Exports, Deutsch & Englisch, Config, Sprachdateien, Bridges und Installationsdateien offen ### Voraussetzungen | Voraussetzung | Version | | ------------------ | --------------------------- | | FiveM-Server-Build | ≥ 7290 | | OneSync | erforderlich | | Framework | ESX, QBCore oder Qbox | | Datenbank | MySQL 8 oder MariaDB ≥ 10.6 | ### Abhängigkeiten * [ox\_lib](https://github.com/overextended/ox_lib) * [oxmysql](https://github.com/overextended/oxmysql) * [ox\_inventory](https://github.com/overextended/ox_inventory) – Beute mit Qualität, Jagdwaffen, Werkzeuge * optional [ox\_target](https://github.com/overextended/ox_target) oder qb-target – sonst Hinweistext „\[E] …“ * optional ein Dispatch-Script (ps-dispatch, cd\_dispatch, qs-dispatch, rcore\_dispatch, core\_dispatch) * optional [Pepper Eats](https://pepper-scripts.tebex.store) – Wildfleisch als Restaurant-Zutat ### Installation 1. Ordner nach `resources/[pepper]/pepper_hunting` kopieren – **nicht umbenennen**. 2. Items: den Inhalt von `install/ox_items.lua` (Deutsch) bzw. `install/ox_items_en.lua` (Englisch) in `ox_inventory/data/items.lua` einfügen – **vor** die letzte `}` der Datei. 3. Alle Bilder aus `install/images/` nach `ox_inventory/web/images/` kopieren (32 Bilder). 4. **Wichtig:** ox\_inventory nimmt Spielern Waffen weg, die nicht aus dem Inventar gezogen wurden. Trag die drei Spielwaffen der Jagdwaffen in die `server.cfg` ein (Pepper Hunting prüft das beim Start und warnt): ``` # Jagdbüchse, Jagdflinte, Jagdmesser – genau so, ohne Leerzeichen, vor ensure ox_inventory setr inventory:ignoreweapons [100416529,487013001,-1716189206] ``` 5. `server.cfg`: ``` ensure oxmysql ensure ox_lib ensure ox_inventory # ensure ox_target # optional – bzw. qb-target # dein Framework (es_extended / qb-core / qbx_core) wie gewohnt davor ensure pepper_hunting add_ace group.admin pepper_hunting.admin allow ``` 6. Die 12 Datenbank-Tabellen legt das Script beim Start selbst an. Nur wenn dein DB-Benutzer das nicht darf: `install/pepper_hunting.sql` importieren. 7. Server starten. In der Konsole steht `Pepper Hunting 1.0.0 gestartet (…, 6 Jagdgebiete)`. 8. Im Spiel `/huntadmin` öffnen und die **Vorgabe-Orte prüfen**: Die Koordinaten der Gebiete, Händler, des Jagdschein-Büros, Schießstands, Jagdladens, Präparators und Hundezüchters sind gute Näherungen – auf eigenen Karten oder mit MLOs bitte einmal anschauen und bei Bedarf neu setzen. ### Konfiguration Alle Einstellungen liegen offen in `config/`: | Datei | Inhalt | | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `config.lua` | Sprache, Framework, Befehl, Tasten, Gebiete, Spawn, Abschuss, Beute, **Pirsch** (Wahrnehmung, Wind, Spuren, Nachsuche, Fernglas, Lockrufe, Köder, Hochsitze), Handel | | `animals.lua` | Tierarten: Modelle, Größe, passende Waffen, Gewicht, Beute, XP, Sinne, Angriff; Trefferzonen | | `zones.lua` | Vorgabe-Jagdgebiete (nur für eine leere Datenbank) | | `weapons.lua` | Jagdwaffen-Items → Spielwaffe + Munition, Messer, „nur im Gebiet“ | | `items.lua` | alle Items mit Preis/Gewicht (daraus entsteht `install/ox_items.lua`) | | `places.lua` | Vorgabe-Orte und Ortsarten, NPC-Modelle, Blips | | `license.lua` | Jagdschein, Gebühren, Erweiterungen, Schein je Art, Schonzeiten, Kontingente, Wilderei/Polizei, Schießstand, Quiz, Jagdladen | | `progression.lua` | Level-Kurve, XP-Quellen, Freischaltungen, Sammelbuch-Meilensteine, Präparator, Tablet, Ranglisten | | `extras.lua` | Jagdhund, Fallen, legendäre Tiere, Jagdgruppen + Treibjagd, Wettbewerbe, Pepper Eats | | `server.lua` | Webhooks, Admin-ACE, Quiz-Lösungen (wird nie an Clients gesendet) | Häufige Anpassungen: * **Schwierigkeit der Pirsch:** `Config.Perception.Difficulty` (0.6 = leicht, 1.0 = anspruchsvoll) * **Spieldauer bis Level 50:** `Config.Level.XpCurve` (1.25 ≈ 60 Stunden), Event-Wochenende: `Config.Level.XpMultiplier = 2.0` * **Ohne Jagdschein-Regeln** (alles legal): `Config.License.Enabled = false` * **Preise:** `Config.Items` (Ankauf), `Config.Shop.Items` (Jagdladen), `Config.Trade.StarFactor` ### Rechte | Recht | Wie | | ----------------------- | --------------------------------------------------------------- | | Admin-Menü `/huntadmin` | ACE `pepper_hunting.admin` oder Gruppe aus `Config.AdminGroups` | | Jagen | alle Spieler – legal mit Jagdschein, sonst Wilderei | | Polizei-Meldungen | Jobs aus `Config.Poaching.PoliceJobs` (Mindest-Dienstgrad) | ### Jagdgebiete anlegen 1. `/huntadmin` → **Gebiete** → „Neues Jagdgebiet“, Namen eingeben. 2. **Umriss abstecken:** Lauf, fahr oder flieg die Grenze ab und drück an jeder Ecke **E** – **X** nimmt den letzten Punkt zurück, **Enter** schließt den Umriss, **ESC** bricht ab. Leuchtende Wände zeigen den Umriss. 3. **Tierarten** per Regler gewichten, **Bestand** (Tiere gleichzeitig) und optional **Ab Jäger-Level** wählen. 4. **Anlegen.** Der Bestand ist sofort da; „Bestand neu verteilen“ setzt ihn neu. **Orte** (Wildhändler, Hehler, Jagdschein-Büro, Schießstand, Jagdladen, Präparator, Hundezüchter, fester Hochsitz): `/huntadmin` → **Orte** → „Neuer Ort“ → Art und Namen wählen → „Setzen“ → an die Stelle stellen, in Blickrichtung drehen, **E**. Beim Schießstand ist die Position der Standplatz, die Scheiben stehen in Blickrichtung. ### So wird gejagt * **Ausrüsten:** Jagdladen (Messer, Fernglas, Lockrufe, Köder; Flinte und Büchse mit Schein). Jagdwaffe als Item **benutzen** = ziehen, nochmal = wegstecken. Verlässt du das Gebiet, wird sie automatisch weggesteckt. * **Anpirschen:** unten rechts zeigen **Wind** (Pfeil relativ zu deiner Blickrichtung) und **Geräusch** an, wie gut du bist. Gegen den Wind und geduckt kommst du am nächsten heran. * **Spuren** werden ab 30 m sichtbar – mit **E** untersuchen: Art, Alter, Richtung zur nächsten Spur. * **Schießen:** Herz-Lunge oder Kopf = volle Qualität. Ein Treffer in Keule oder Lauf: das Tier flieht – der Blutspur folgen. * **Aufbrechen** am Tier (Jagdmesser), dann zum **Wildhändler** (legale Beute) oder **Präparator** (Trophäe). * Gruppenmitglieder dürfen eure Abschüsse sofort aufbrechen; Fremde erst nach 90 Sekunden. ### Jagdschein und Regeln 1. **Jagdschein-Büro:** Theorie-Prüfung – 10 zufällige Fragen, 8 richtig (Gebühr je Versuch). 2. **Schießstand:** du wirst auf den Standplatz gestellt und bekommst eine Leih-Büchse – 4 von 6 Scheiben in 120 Sekunden treffen. Danach liegt der **Jagdschein** (Ausweis mit Nummer) im Inventar. 3. **Erweiterungen** im Büro: Großwild (Hirsch, Wildschwein, ab Level 5), Nachtjagd (ab Level 8), Raubwild (Kojote, Puma, ab Level 12). 4. **Wilderei:** ohne passenden Schein, in der Schonzeit, über dem Tageskontingent oder nachts ohne Erweiterung. Die Beute ist illegal (nur der **Hehler** kauft sie), gibt keine XP, und mit 60 % Chance meldet ein Zeuge die Polizei – mit einer ungefähren Stelle auf der Karte. ### Level, Sammelbuch und Trophäen * **Level 1–50:** XP aus legalen Abschüssen (mehr bei sauberen Schüssen), Aufbrechen, Prüfungen, Trophäen, erster Sichtung einer Art, Fallen und Meilensteinen. Level 10 ≈ 4 h, 20 ≈ 11 h, 30 ≈ 22 h, 50 ≈ 60 h. * **Freischaltungen** zeigt das Tablet: Erweiterungen, Laden-Waren, Gebiete (Mount Chiliad ab 10, Raton Canyon ab 15, Great Chaparral ab 20), mehr Hochsitze, Köder und Fallen. * **Sammelbuch:** jede Art mit Anzahl, bester Qualität, schwerstem Tier; Meilensteine bei 1/10/50/100 Abschüssen. * **Präparator:** Geweih, Keilerwaffen, Kojoten- und Pumafell (legal, ab 40 % Qualität) werden zur **Trophäe** mit Punkten aus Gewicht und Qualität – sichtbar in der Trophäenwand und der Rangliste. ### Jagdhund Beim **Hundezüchter** (ab Level 8): Retriever (apportiert besser), Schäferhund (spürt weiter auf) oder Husky. **Hundepfeife** ruft ihn / schickt ihn heim. Befehle im Tablet oder mit `/huntdog call|follow|sit|search|fetch|home`. **Suchen** zeigt Richtung und Entfernung zum nächsten Tier – eigenes angeschossenes Wild zuerst, dann folgt der Hund der Blutspur. **Apportieren** holt Kleinwild ohne Messer. Füttern (Hundefutter-Item) und Streicheln halten ihn bei Laune; stirbt er im Spiel, ist er 20 Minuten verletzt oder die Tierärztin hilft. ### Fallen, Legenden, Gruppen, Wettbewerbe * **Fallen:** Drahtschlinge (Kaninchen) oder Kastenfalle (Kaninchen, Vögel) im Gebiet aufstellen, nach 20–30 Minuten kontrollieren. Es gelten dieselben Regeln wie bei der Jagd. * **Legendäre Tiere** tauchen selten auf (Gerüchte für Jäger ab Level 15), sind zäher und schwerer und ziehen nach 40 Minuten weiter. Wer eins zuerst erlegt, kommt in die **Ruhmeshalle**. * **Jagdgruppen:** im Tablet per Server-ID einladen. Gemeinsam: Beute sofort aufbrechen, 25 % XP-Anteil in der Nähe, **Treibjagd** (Leitung im Gebiet, ab 3 Jägern): 8 Minuten lang wird Wild zur Schützenlinie getrieben. * **Wettbewerbe** starten nach Zeitplan (`Config.Events.Schedule`) oder über `/huntadmin` → „Wettbewerbe …“. Anmeldung und Live-Rangliste im Tablet, Preise für Platz 1–3. ### Pepper Eats Läuft **Pepper Eats** (mit den Wild-Rezepten), zeigt der Wildhändler „Für die Küche zerlegen“: Hirsch-, Wildschwein- und Kaninchenfleisch werden zur Restaurant-Zutat. Ohne Pepper Eats ist der Bereich unsichtbar – Hunting läuft unverändert. ### Befehle | Befehl | Wer | Zweck | | ------------------- | ------------- | -------------------------------------------------------------- | | `/huntadmin` | Admins | Gebiete, Orte, Übersicht, Jagdschein/Level setzen, Wettbewerbe | | `/hunttablet` | alle | Jagd-Tablet (auch als Item) | | `/huntdog ` | Hundebesitzer | call, follow, sit, search, fetch, home | ### Webhooks In `config/server.lua` (`ServerConfig.Webhooks`): | Schlüssel | Inhalt | | ---------- | ------------------------------------------------------------------------ | | `admin` | Gebiete/Orte angelegt, geändert, gelöscht; Jagdschein/Level durch Admins | | `hunting` | Wilderei, legendäre Tiere (gesichtet, erlegt), Wettbewerbe | | `security` | Verdachtsfälle der Plausibilitätsprüfung | ### Exports **Server** ```lua exports.pepper_hunting:getZones() -- alle Jagdgebiete exports.pepper_hunting:getZoneAt(x, y) -- Gebiet an einer Position oder nil exports.pepper_hunting:getPlayerZone(src) -- Gebiet, in dem der Spieler steht, oder nil exports.pepper_hunting:getHunter(src) -- Level, XP, Statistik, Sammelbuch exports.pepper_hunting:getLevel(src) -- Jäger-Level exports.pepper_hunting:addXp(src, amount) -- XP gutschreiben exports.pepper_hunting:getLicense(src) -- Jagdschein mit Erweiterungen exports.pepper_hunting:hasLicense(src) -- true/false exports.pepper_hunting:giveLoot(src, species, quality, weight) -- Beute-Items geben exports.pepper_hunting:startEvent(template) -- Wettbewerb starten exports.pepper_hunting:getDog(src) -- Jagdhund oder nil ``` **Client** ```lua exports.pepper_hunting:isInHuntingZone() exports.pepper_hunting:getCurrentZone() exports.pepper_hunting:openTablet() ``` ### Framework-Anbindung Die Bridges in `bridge/` (offen) erkennen ESX, QBCore und Qbox automatisch (`Config.Framework = 'auto'`). Geld läuft über das Framework, Items über ox\_inventory, Polizei-Meldungen über `bridge/server/dispatch.lua`. ### Troubleshooting | Problem | Lösung | | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Jagdwaffe verschwindet sofort wieder | `setr inventory:ignoreweapons [...]` ohne Leerzeichen und vor `ensure ox_inventory` (siehe Installation); die Server-Konsole nennt beim Start die richtige Zeile | | Keine Tiere im Gebiet | Gebiet aktiv? Mindest-Level erreicht? `Config.Debug = true` zeigt Ausgaben in F8 | | Händler/Orte an falscher Stelle | `/huntadmin` → Orte → neu setzen | | Items ohne Bild | Bilder aus `install/images/` nach `ox_inventory/web/images/` kopieren | | Polizei bekommt keine Meldung | Dispatch-Script läuft? Sonst greift der eingebaute Alarm für `Config.Poaching.PoliceJobs` | | „Für die Küche zerlegen“ fehlt | Pepper Eats mit den Wild-Rezepten muss laufen | ### Changelog **1.0.0 (25.10.2026)** – erste Veröffentlichung. Alle Änderungen stehen in `CHANGELOG.md` in der Ressource. ### Support Ticket in unserem [Discord](https://discord.gg/6NaFJWKDYu) (Kategorie „Script Support“) öffnen und den Kauf vorher mit `/verify` verknüpfen.