# Adding Custom Pet

Adding your custom pet it's super easy just add a file inside "/plugins/ThePets/custom\_pets" folder like file below, you can add as much pets as you want.

{% code title="/plugins/ThePets/custom\_pets/example\_pet.yml" lineNumbers="true" %}

```yaml
# ================================
#        Example Pet      
# ================================
pet-entity-options:
  displayName: "&8[Lvl %pet_level_number%] &7%player%'s %pet_egg_displayname%"
  material: PLAYER_HEAD
  texture: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZDZkZjM3OGJlZTY5ODBhNzg0NTkzYTFhZTk4OTI4MGE2ZTk2MjFhOTE5MTcyZGE0OWQzMTgxNWYzYzQ5Mjg2ZSJ9fX0=
  particle: DRIP_LAVA
pet-egg:
  petId: custom_pet_id
  texture: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZDZkZjM3OGJlZTY5ODBhNzg0NTkzYTFhZTk4OTI4MGE2ZTk2MjFhOTE5MTcyZGE0OWQzMTgxNWYzYzQ5Mjg2ZSJ9fX0=
  displayName: "&6Example Pet"
  material: PLAYER_HEAD
  eggDisplayName: "&7[Lvl %pet_level_number%] %pet_egg_displayname%"
  petModelEngine:
    modelId: null
    useModelEngine: false
    modelEngineAnimation: null
command-rewards:
  rewards: {}
pet-levels:
  1:
    requiredXp: 15.0
    petInfoInGUI:
    - "&8%pet_category_displayname% Pet"
    - ""
    - "&8+&a5 &9☠ Critic Damage"
    - "&8+&a5 &9☣ Critic Chance"
    - ""
    - "&6Fire Resistance Force"
    - "&fAdds &c10% &fFire resistance"
    - "&fprovided from a &cmagic potion&f!"
    petPotions:
    - potion: FIRE_RESISTANCE
      level: 2
    statRewards:
    - stat: critic_chance
      amount: 5
    - stat: critic_damage
      amount: 5
    petInfoInMessage:
    - "&8+&a5 &9☠ Critic Damage"
    - "&8+&a5 &9☣ Critic Chance"
    - ""
    - "&6Fire Resistance Force"
    - "&fAdds &c+10% &fFire resistance"
    - "&fprovided from a &cmagic potion&f!"
    commandRewards: []
  5:
    requiredXp: 25.0
    petInfoInGUI:
    - "&8%pet_category_displayname% Pet"
    - ""
    - "&8+&a10 &9☠ Critic Damage"
    - "&8+&a10 &9☣ Critic Chance"
    - ""
    - "&6Fire Resistance Force"
    - "&fAdds &c+25% &fFire resistance"
    - "&fprovided from a &cmagic potion&f!"
    petPotions:
    - potion: FIRE_RESISTANCE
      level: 3
    statRewards:
    - stat: critic_chance
      amount: 10
    - stat: critic_damage
      amount: 10
    petInfoInMessage:
    - "&8+&a10 &9☠ Critic Damage"
    - "&8+&a10 &9☣ Critic Chance"
    - ""
    - "&6Fire Resistance Force"
    - "&fAdds &c+25% &fFire resistance"
    - "&fprovided from a &cmagic potion&f!"
    commandRewards: []
pet-model-engine:
  modelId: null
  useModelEngine: false
  modelEngineAnimation: null
category: foraging
enabled: true
id: custom_pet_id
max-level: 50

```

{% endcode %}


---

# 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://quality-plus.gitbook.io/untitled/thepets/adding-custom-pet.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.