Pepper Hunting

Jagd als Freizeitaktivität für alle Spieler – lebendes Wild in Jagdgebieten, Pirsch mit Wind und Spuren, Jagdschein mit Schonzeiten und Wilderei, Level 1–50, Jagd-Tablet, Jagdhund, Fallen, legendäre Tiere, Gruppenjagd und Wettbewerbe für ESX, QBCore und Qbox.

Ü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

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.1 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.

Erster Test

1. /huntadmin öffnen und prüfen, dass die 6 Vorgabe-Gebiete in der Liste stehen.
2. Mit /huntadmin dir selbst einen Jagdschein geben oder im Jagdschein-Büro die Prüfung machen.
3. Im Jagdladen ein Jagdmesser und eine Jagdbüchse mit Munition kaufen und in ein Jagdgebiet (z. B. Paleto-Wald) gehen.
4. Die Jagdbüchse als Item benutzen, ein Tier erlegen und es mit dem Jagdmesser aufbrechen.
5. Die Beute beim Wildhändler verkaufen und im Jagd-Tablet (/hunttablet) das Sammelbuch ansehen.

Konfiguration

Alle Einstellungen liegen offen in config/:

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

Pirsch

Config.Perception = {
    Difficulty = 0.85,
    Sight = 42.0,
    Scent = 85.0,
    Camo = 0.55,
    Stand = 0.45,
}

Jagdschein und Wilderei

Config.License = {
    Enabled = true,
    Item = 'hunt_license',
    RequireItem = false,
    Account = 'bank',
    Fees = { theory = 250, practice = 400, card = 100 },
}

Level

Config.Level = {
    Max = 50,
    XpCurve = 1.25,
    XpMultiplier = 1.0,
}

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.

Webhooks

In config/server.lua (ServerConfig.Webhooks):

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.

Befehle und Rechte

Rechte:

Tasten (Config.Keys, GTA-Control-IDs):

Exports

Server

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

exports.pepper_hunting:isInHuntingZone()
exports.pepper_hunting:getCurrentZone()
exports.pepper_hunting:openTablet()

FAQ

Die Jagdwaffe verschwindet sofort wieder.

ox_inventory nimmt Waffen weg, die nicht aus dem Inventar gezogen wurden. Trag setr inventory:ignoreweapons [100416529,487013001,-1716189206] ohne Leerzeichen und vor ensure ox_inventory in die server.cfg ein. Die Server-Konsole nennt beim Start die richtige Zeile.

Im Jagdgebiet tauchen keine Tiere auf.

Prüfe, ob das Gebiet aktiv ist und ob du das Mindest-Level des Gebiets hast. Tiere spawnen nur in der Nähe von Jägern. Config.Debug = true zeigt Gebietsumrisse und Tier-Markierungen.

Die Items haben keine Bilder oder fehlen.

Inhalt von install/ox_items.lua (bzw. ox_items_en.lua) in ox_inventory/data/items.lua einfügen und alle Bilder aus install/images/ nach ox_inventory/web/images/ kopieren. Fehlende Items nennt die Konsole beim Start mit Namen.

Muss ich die SQL-Datei importieren?

Nein. Die 12 Tabellen legt das Script beim Start selbst an und ergänzt fehlende Spalten. install/pepper_hunting.sql brauchst du nur, wenn dein Datenbank-Benutzer keine Tabellen anlegen darf.

Händler oder Orte stehen an der falschen Stelle.

/huntadmin → Orte → den Ort neu setzen. Die Vorgaben sind Näherungen, auf eigenen Karten oder mit MLOs lohnt ein Blick.

Die Polizei bekommt keine Wilderei-Meldung.

Läuft ein unterstütztes Dispatch-Script? Sonst greift der eingebaute Alarm für die Jobs aus Config.Poaching.PoliceJobs. Ein Zeuge meldet nur mit 60 % Chance (Config.Poaching.ReportChance).

„Für die Küche zerlegen“ fehlt beim Wildhändler.

Pepper Eats muss laufen und die Wild-Rezepte dürfen dort nicht abgeschaltet sein (Config.WildRecipes).

Kann ich ohne Jagdschein-Regeln spielen?

Ja: Config.License.Enabled = false. Dann darf jeder alles jagen und nichts ist Wilderei.

Wie lege ich ein eigenes Jagdgebiet an?

Im Spiel mit /huntadmin → Gebiete → „Neues Jagdgebiet“ und den Umriss mit E abstecken. Die Vorgaben aus config/zones.lua entstehen nur bei leerer Datenbank (Config.Zones.SeedPresets).

Wie ändere ich Texte oder die Sprache?

Sprache über Config.Locale ('de' oder 'en'), Texte in locales/de/*.json bzw. locales/en/*.json. Item-Namen stehen in ox_inventory/data/items.lua.

Wie mache ich das Leveln schneller oder langsamer?

Config.Level.XpCurve in config/progression.lua (1.25 ≈ 60 Stunden bis Level 50). Für ein Event-Wochenende Config.Level.XpMultiplier = 2.0.

Die Pirsch ist zu schwer.

Config.Perception.Difficulty senken (Standard 0.85, 0.6 = leicht). Der Faktor wirkt auf Hören, Sehen und Wittern.

Welche Inventare werden unterstützt?

Nur ox_inventory. Beute trägt Qualität, Jäger und „legal/illegal“ als Metadaten.

Support

Discord → Ticket (Kategorie „Script Support“) unter https://discord.gg/6NaFJWKDYu, Kauf vorher mit /verify verknüpfen.

Permanent auf dem Dev-Server von Pepper Scripts getestet.

Changelog

Aktuell: 1.0.1 (25.10.2026) – „Für die Küche zerlegen“ erscheint nicht, wenn Pepper Eats die Wild-Rezepte abgeschaltet hat. Alle Änderungen stehen in CHANGELOG.md in der Ressource.

Fehler gefunden? Melde ihn im Discord.