> For the complete documentation index, see [llms.txt](https://docs.cdev.shop/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cdev.shop/fivem/pet-system.md).

# Pet System

## SHOWCASE VIDEO

{% embed url="<https://youtu.be/9perfvfwDF0>" %}

## What is this resource?

This resource is a companionship script that provides entertainment, customization of appearance and other refined details ([features listed here](https://fivem.cdev.shop/category/scripts)) that makes this the best pet script for your **FiveM** server.

## Instructional Video: Setting up Shops

📝 **Creating Shop Command:** `/pscreator`

{% embed url="<https://www.youtube.com/watch?v=-_eOmtHj4Vk>" %}

### Installation Guide

***

{% stepper %}
{% step %}

## Install all resource dependencies

Make sure you have all of the following resources installed:

* cdev\_lib <mark style="color:green;">(Include with cdev\_pets)</mark>
* cdev\_pets
* cdev\_pets\_assets <mark style="color:green;">(Include with cdev\_pets)</mark>
* cdev\_pets\_assets2 <mark style="color:green;">(Include with cdev\_pets)</mark>
  {% endstep %}

{% step %}

## Organizing Your Resource Folders

🚩 <mark style="color:red;">**Correct folder organization is essential for everything to work properly.**</mark>

➤ Step 1: Create the `[cdev]` folder. Inside your server's `resources` folder and Place **only** the following resource inside:

* cdev\_pets

➤ Step 2: Create the `[cdev_assets]` folder till inside your server’s `resources` folder, Inside `[cdev_assets]`, place the following assets:

⚠ <mark style="color:yellow;">**If you have the**</mark> [<mark style="color:blue;">**Pet Subscription DLC Package**</mark>](https://fivem.cdev.shop/package/5756559)<mark style="color:yellow;">**, you must place inside the**</mark> **`[cdev_assets]`** <mark style="color:yellow;">**folder**</mark> <mark style="color:red;">**only**</mark> <mark style="color:yellow;">**the resources folders that are under the**</mark> <mark style="color:red;">**(Have Pets Subscription)**</mark> <mark style="color:yellow;">**tab bellow.**</mark>

{% tabs %}
{% tab title="Don't have Pets Subscription" %}

| CFX Portal Name                       | Folder Name (after download) |
| ------------------------------------- | ---------------------------- |
| cDev - Cat American                   | cdev\_cat\_amer              |
| cDev Pets Assets Premium - Dobbermann | cdev\_dog\_dobb              |
| cDev Pets Assets Premium - Rottweiler | cdev\_dog\_rott              |
| cDev Pets Assets                      | cdev\_pets\_assets           |
| cDev Pets Assets 2                    | cdev\_pets\_assets2          |
| {% endtab %}                          |                              |

{% tab title="Have Pets Subscription" %}

| CFX Portal Name                  | Folder Name (after download) |
| -------------------------------- | ---------------------------- |
| cDev Pets Assets Compiled Dogs   | cdev\_dog\_pets              |
| cDev Pets Assets Compiled Dogs 2 | cdev\_dog\_pets2             |
| cDev Pets Assets Compiled Cats   | cdev\_cat\_pets              |
| cDev Pets Assets                 | cdev\_pets\_assets           |
| cDev Pets Assets 2               | cdev\_pets\_assets2          |
| cDev PetShop                     | cdev\_petshop                |
| {% endtab %}                     |                              |
| {% endtabs %}                    |                              |

➤ Step 3: Add `cdev_lib` to the Resources Root

**Below is an example screenshot showing the correct folder structure:**

<div align="left"><figure><img src="/files/qjHOCelMd5uCGmabgbmU" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

## Server.cfg Configuration

This resource must always be started **after your&#x20;**<mark style="color:yellow;">**framework**</mark>**&#x20;and any&#x20;**<mark style="color:yellow;">**other**</mark>**&#x20;required resources**.

It is essential to follow the correct startup order to ensure proper functionality and avoid conflicts.

**Below is an example screenshot showing the recommended startup order:**

<div align="left"><figure><img src="/files/UajSDJ4JQ6vcvPTiqUra" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Cdev\_lib Configuration

For the pet system and the connection between your <mark style="color:yellow;">framework</mark> and the resources to work correctly, you need to configure the `cdev_lib` resource properly according to your <mark style="color:yellow;">framework</mark>. For more details, click the link below to follow the instructions.

{% tabs %}
{% tab title="ESX" %}
{% content-ref url="/pages/Yi1MUNc2bDxhthgwzwsL" %}
[ESX Configuration](/fivem/cdev-library/esx-configuration.md)
{% endcontent-ref %}
{% endtab %}

{% tab title="QBCore/QBOX" %}
{% content-ref url="/pages/PkCCFDz1sdRi0ZwCg0nY" %}
[QBCore/QBox Configuration](/fivem/cdev-library/qbcore-qbox-configuration.md)
{% endcontent-ref %}
{% endtab %}

{% tab title="Custom Framework" %}
{% content-ref url="/pages/t35JeKJHIe4wFFf66V5G" %}
[Advanced Customization](/fivem/cdev-library/advanced-customization.md)
{% endcontent-ref %}
{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}

### (Optional) If you use any multijob or want full integration

{% tabs %}
{% tab title="Qbcore" %}
{% content-ref url="/pages/b8mP9d0rdvzcqTHrLLkL" %}
[How integrate Jobs with Pets QBCore](/fivem/pet-system/how-integrate-jobs-with-pets-qbcore.md)
{% endcontent-ref %}
{% endtab %}

{% tab title="Qbox" %}
{% content-ref url="/pages/JGyUFGw8ihu0kUt2mfZB" %}
[How integrate Jobs with Pets QBox](/fivem/pet-system/how-integrate-jobs-with-pets-qbox.md)
{% endcontent-ref %}
{% endtab %}
{% endtabs %}

{% hint style="danger" %}
**It is necessary to follow the steps exactly as shown for the names to work.**
{% endhint %}
{% endstep %}
{% endstepper %}

***

{% hint style="danger" %}
To be able to stream the pets and clothing in game, you must have an active CFX Element Club Subscription!\
\
You can check [HERE](https://portal.cfx.re/subscriptions) to see any active subscriptions
{% endhint %}

{% hint style="danger" %}
**Do not modify the encrypted files in any way, as this may cause issues with the resource's functionality.**
{% endhint %}

{% hint style="warning" %}
cDev Pets Version 2.5.0 requires users that already have this script running to run a query to add new columns to a table;

\
`ALTER TABLE cdev_pets ADD sniff INT(11) NOT NULL, ADD resistance INT(11) NOT NULL, ADD agility INT(11) NOT NULL, ADD attack INT(11) NOT NULL;`
{% endhint %}