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

# Advanced Hunting Job

## FetchQ Hunting <a href="#user-content-fetchq-hunting" id="user-content-fetchq-hunting"></a>

An immersive, feature-rich hunting and tracking script for FiveM servers. Provide your players with an engaging progression system, hunting dog companions, dynamic missions, and a full tracking experience in the wilderness.

### 🌟 Overview <a href="#user-content--overview" id="user-content--overview"></a>

FetchQ Hunting introduces a dynamic, level-based hunting system. Players start at level 1 and progress up to level 100 by completing various hunting missions. With features like blood tracking, hunting dog companions, vehicle rentals, and a comprehensive party system, this script offers a highly rewarding progression economy for your server.

### ✨ Features <a href="#user-content--features" id="user-content--features"></a>

#### 🐕 Hunting Dog Companions <a href="#user-content--hunting-dog-companions" id="user-content--hunting-dog-companions"></a>

* **Purchasable Dogs:** Players can purchase their own hunting dog (German Shepherd, Rottweiler, or Husky) from the Hunting Manager.
* **Dog Commands:** Command your dog to follow, sit, lay down, or enter/exit your vehicle.
* **Animal Tracking:** Command your dog to search the area. The dog will track down animals within a 50-meter radius and alert you.
* **Attack Mode:** Dogs can be ordered to attack specific targets or the animals they find.

#### 📜 Progression & Mission System <a href="#user-content--progression--mission-system" id="user-content--progression--mission-system"></a>

* **100 Levels of Progression:** An extensive leveling system with dynamic UI to track your hunting XP, total kills, and successful hunts.
* **Extensive Missions:** Over 50 configured missions ranging from "Hunt 1x Pig" to "King of the Hill (8x Mountain Lions)" and massive "50x Deer" herd culls.
* **Mission Rewards:** Completing missions rewards players with cash, XP, and useful items (like bandages).

#### 🩸 Advanced Tracking & Hunting Mechanics <a href="#user-content--advanced-tracking--hunting-mechanics" id="user-content--advanced-tracking--hunting-mechanics"></a>

* **Blood Trails & Hitmarkers:** Animals leave dynamic blood trails when wounded. Players can follow these trails to track injured prey.
* **Dynamic Health Scaling:** Animal health scales dynamically based on the size of your hunting party.
* **Hunting Zones:** Specific circular hunting zones where missions take place and animals spawn dynamically.

#### 👥 Multiplayer Party System <a href="#user-content--multiplayer-party-system" id="user-content--multiplayer-party-system"></a>

* **Group Hunts:** Invite nearby players to join your hunting group.
* **Shared Objectives:** Hunt together and take down harder targets as a team.
* **Multiplayer Scaling:** The script scales the difficulty (animal health) based on the number of active party members.

#### 🥩 Processing & Economy <a href="#user-content--processing--economy" id="user-content--processing--economy"></a>

* **Slaughter House:** Transport hunted animals (using vehicle trunks) to the designated processing zone.
* **Meat Sales:** Processed animals yield various types of meat (Venison, Beef, Boar Meat, Coyote Meat, etc.) which can be sold to the meat buyer for profit.
* **Vehicle Rentals:** The Hunting Manager provides vehicle rentals (Bodhi2, Bison, Enduro) specifically tailored for transporting large or small animals.

#### ⚙️ System & Administration <a href="#user-content-system-administration" id="user-content-system-administration"></a>

* **Framework Auto-Detection:** Integrates cleanly with your active framework.
* **NPC Manager:** A configurable Hunting Manager NPC handles the UI, market, and vehicle rentals.
* **Debug Mode:** Built-in commands (`/huntingdebug`, `/debugspawnanimal`) for admins to easily test animal spawns and zones.

### 🚀 Installation & Configuration <a href="#user-content--installation--configuration" id="user-content--installation--configuration"></a>

#### 1. Database Setup (SQL) <a href="#user-content-1-database-setup-sql" id="user-content-1-database-setup-sql"></a>

Install the SQL file included in the script

#### 2. Item Configuration <a href="#user-content-2-item-configuration" id="user-content-2-item-configuration"></a>

Place the provided item images into your inventory's image directory.

Configure your inventory (`items.lua`) to include the following items from the script:

* **Weapons:** `WEAPON_HUNTINGRIFLENEW`, `WEAPON_BATTLEAXE`
* **Accessories:** `binoculars_hunting`
* **Ammo:** `ammo-sniper`, `snp_ammo`
* **Meat:** `a_c_pig_meat`, `a_c_cow_meat`, `a_c_deer_meat`, `a_c_boar_meat`, `a_c_cormorant_meat`, `a_c_coyote_meat`, `a_c_mtlion_meat`
* **Dogs:** `german_shepherd`, `rottweiler`, `husky`

#### 3. Developer / Admin Commands <a href="#user-content-3-developer--admin-commands" id="user-content-3-developer--admin-commands"></a>

* **Debug Mode:** Set `J0.debug = true` in `config.lua` to enable target debug zones and printing.
* **Commands:** Use `/debugspawnanimal [model]` to test animal spawning and interactions.

### 🛠️ Customization (config.lua) <a href="#user-content-customization-configlua" id="user-content-customization-configlua"></a>

The script is highly customizable through `shared/config.lua` and `shared/missons.lua`:

* **Vehicle Rentals:** Change rental vehicles, prices, and categories in `.VehicleRentalConfig`.
* **Missions:** Edit mission requirements, XP, level gates, and rewards in `shared/missons.lua`.
* **Zones & Routing:** Modify the slaughterhouse route and processing zones.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://fetchq-store.gitbook.io/fetchq-store-docs/advanced-hunting-job.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.