# sh-k9

### Resources

* [Configuration](https://andrew-grenade.gitbook.io/sheen-scripts/paid-resources/sh-k9/configuration)
* [Video Showcase](https://www.youtube.com/watch?v=HsRq0yVpeNU) (thanks to AdvancedTeam)
* [Review Showcase](https://www.youtube.com/watch?v=g5n1Gn3I66I) (thanks to Valour)
* [Screenshots Gallery](https://imgur.com/a/Y8cbzmA)

### Core Features

#### Main Actions

**Combat & Positioning**

* **Attack** - Target players or NPCs by aiming and pressing E
  * **Tackle** - Dogs have a chance to tackle targets (see [update 2.1](https://forum.cfx.re/t/standalone-qb-qbx-esx-nd-k9-police-dog/5071165/53?u=sheen) for details)
* **Send to Location** - Direct your dog to any spot by aiming and pressing G
* **Follow Modes**
  * **Normal Follow** - Dog stays close to handler
  * **Lead Follow** - Dog walks ahead of handler
* **Leash System** - Added in [Update 4.0](https://forum.cfx.re/t/qbcore-qbx-esx-standalone-k9-police-dog/5071165/73?u=sheen)

**Vehicle Interaction**

* **Enter/Exit Vehicle**
  * **Teleport** - Instant entry/exit
  * **Realistic Animation** - Dog jumps in/out of vehicles

**Police Work**

* **Searching Capabilities**
  * Search vehicles, players, or NPCs
  * Player search methods:
    * Aim on specific person and select search option in menu
    * Automatic detection of closest player
* **Tracking System**
  * Detect hidden players within configurable smell radius
  * Balanced mechanics to prevent gameplay exploitation
  * Adjustable tracking speed and cooldown periods
  * Performance tied to dog's level/relationship system

**Health Management**

* **Health & Armor System**
  * Configurable maximum health and armor values
  * Apply bandages to heal injured dogs
  * Apply armor for protection
  * Database storage for health/armor status (optional)
  * Revive system for fallen K9s

#### Secondary Actions

* **Status Check** - Monitor your dog's condition
* **Carry Dog** - Pick up and transport your K9
* **Play Fetch** - Interactive play with ball or frisbee
* **Feeding System** - Place food bowl that dog will find automatically
* **Dog House**
  * Build/destroy dog houses
  * Command dog to enter/exit house
* **Appearance Customization**
  * Random style selection
  * Detailed customization menu
  * Database storage of appearance settings
* **Animation System**
  * Variety of realistic preset animations
  * Animations tied to relationship level
* **Camera System** - Mount camera to dog's neck for K9 perspective
* **GPS Tracking** - Always know your dog's location

### Advanced Systems

#### Needs System

* **Hunger & Thirst**
  * Regular feeding requirement
  * Configurable options:
    * Health damage when hungry/thirsty
    * Customizable depletion rates
* **Natural Functions**
  * Bathroom needs triggered after multiple feedings
  * Can be disabled in configuration

#### Relationship System

* **Leveling Mechanics** (disabled by default)
  * XP gained through various actions
  * Database storage of progress
  * Affects command success rates
  * Influences tracking and searching effectiveness
  * Fully customizable levels, XP rewards, and failure percentages

### Configuration & Compatibility

#### Settings

* **Insta-headshot** toggle
* **ACE Permissions** and **Discord Roles** for non-framework users
* **Job Restrictions** with grade-level requirements
* **Target System Support**
  * Compatible with qb-target, ox\_target, qtarget
* **Multiple Dog Models**
  * Default shepherd and rottweiler models
  * Support for premium models:
    * [German Shepherd/Malinois](https://forum.cfx.re/t/how-to-german-shepherd-malinois-k9-dog-1-0-1/1065040)
    * [Mouby's Dog House models](https://moubys-dog-house.tebex.io/package/5176462)
    * [Additional Mouby's models](https://moubys-dog-house.tebex.io/package/6260956)
    * Unlimited custom model support
* **Dog Limit** - Configurable maximum dogs per player/character

#### User Interface

* **Chat Commands** for all actions
  * Customizable command names
* **Translation Settings** for multi-language support
* **Custom UI**
  * Control menu for dog management
  * Status window displaying vital statistics (thirst, hunger, armor, health)
* **FiveM Keybinds** for quick actions

#### Technical Features

* **Multiple Save Options**
  * Database saving via oxmysql
  * JSON alternative for servers without database support
* **Support for** [**Marx's Prop Pack**](https://marxs-mods.tebex.io/package/6461321)
  * Automatic camera prop display on dog's neck
  * Customizable basic props

#### Framework Compatibility

* Fully supports **QBCore, QBX, ESX Legacy, ND Core** frameworks
* **Standalone** version for custom framework integration
* Completely open bridge files to adapt the script to any server
* Supported inventories: qb, ox, lj, ps, qs, esx, tgiann, ak47
* Can be used without any framework/database/inventory (certain features will be disabled)

### Updates & Versions

The script is actively maintained with regular updates. Below is the complete version history:

| Version | Forum Link                                                                                                   |
| ------- | ------------------------------------------------------------------------------------------------------------ |
| 7.2     | [Update](https://forum.cfx.re/t/standalone-qb-qbx-esx-nd-k9-dog-script-police-dog/5071165/119?u=sheen)       |
| 6.9     | [Update](https://forum.cfx.re/t/standalone-qb-qbx-esx-nd-k9-dog-script-police-dog/5071165/101?u=sheen)       |
| 5.0     | [Major update](https://forum.cfx.re/t/standalone-qb-qbx-esx-nd-k9-police-dog/5071165/88?u=sheen)             |
| 4.1     | [Update](https://forum.cfx.re/t/standalone-qb-qbx-esx-k9-police-dog/5071165/77?u=sheen)                      |
| 4.0     | [Leash system introduced](https://forum.cfx.re/t/qbcore-qbx-esx-standalone-k9-police-dog/5071165/73?u=sheen) |
| 3.1.2   | [Update](https://forum.cfx.re/t/qbcore-qbx-esx-standalone-k9-police-dog/5071165/67?u=sheen)                  |
| 3.1.1   | [Update](https://forum.cfx.re/t/qbcore-qbx-esx-standalone-k9-police-dog/5071165/65?u=sheen)                  |
| 3.1     | [Update](https://forum.cfx.re/t/qbcore-qbx-esx-standalone-k9-police-dog/5071165/64?u=sheen)                  |
| 2.2.2   | [Update](https://forum.cfx.re/t/qbcore-qbx-esx-standalone-k9-police-dog/5071165/60?u=sheen)                  |
| 2.1.1   | [Update](https://forum.cfx.re/t/qbcore-qbx-esx-standalone-k9-police-dog/5071165/54?u=sheen)                  |
| 2.1     | [Tackle mechanics added](https://forum.cfx.re/t/qbcore-qbx-esx-standalone-k9-police-dog/5071165/53?u=sheen)  |
| 2.0     | [Update](https://forum.cfx.re/t/qbcore-qbx-esx-standalone-k9-police-dog/5071165/43?u=sheen)                  |
| 1.9     | [Update](https://forum.cfx.re/t/qbcore-qbx-esx-standalone-k9-police-dog/5071165/41?u=sheen)                  |
| 1.8.2   | [Update](https://forum.cfx.re/t/qbcore-qbx-esx-standalone-k9-police-dog/5071165/40?u=sheen)                  |
| 1.8.1   | [Update](https://forum.cfx.re/t/qbcore-qbx-esx-standalone-k9-police-dog/5071165/39?u=sheen)                  |
| 1.8     | [Update](https://forum.cfx.re/t/qbcore-qbx-esx-standalone-k9-police-dog/5071165/31?u=sheen)                  |
| 1.7     | [Update](https://forum.cfx.re/t/qbcore-qbx-esx-standalone-k9-police-dog/5071165/26?u=sheen)                  |
| 1.6     | [Update](https://forum.cfx.re/t/qbcore-qbx-esx-standalone-k9-police-dog/5071165/22?u=sheen)                  |
| 1.5     | [Update](https://forum.cfx.re/t/qbcore-qbx-esx-standalone-k9-police-dog/5071165/12?u=sheen)                  |
| 1.4     | [Update](https://forum.cfx.re/t/qbcore-qbx-esx-standalone-k9-police-dog/5071165/10?u=sheen)                  |
| 1.3     | [Update](https://forum.cfx.re/t/qbcore-qbx-esx-standalone-k9-police-dog/5071165/9?u=sheen)                   |
| 1.2     | [Update](https://forum.cfx.re/t/qbcore-qbx-esx-standalone-k9-police-dog/5071165/7?u=sheen)                   |
| 1.1     | [Initial release](https://forum.cfx.re/t/qbcore-qbx-esx-standalone-k9-police-dog/5071165/4?u=sheen)          |

### Recommended Resources

* [Free K9 Model](https://forum.cfx.re/t/how-to-german-shepherd-malinois-k9-dog-1-0-1/) - Quality German Shepherd/Malinois model
* [Marx's Prop Pack](https://marxs-mods.tebex.io/package/6461321) - Designed specifically for this K9 script
* [Mouby's Dog House](https://moubys-dog-house.tebex.io/) - Premium dog models

### Purchase Information

* **Where to buy:** [Tebex Store](https://sheenthebest.tebex.io/package/5624227)
* **Code Access:** Partial (main parts locked, rest is open)
* **Subscription:** One-time purchase
* **Size:** Approximately 15,000 lines of code
* **Requirements:** ox\_lib
* **Support:** Yes


---

# Agent Instructions: 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:

```
GET https://andrew-grenade.gitbook.io/sheen-scripts/paid-resources/sh-k9.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
