# 🎯 Capturing

## About

Players can **capture pets** from regular mobs in the world using special **capture item**.

Global capture settings located in the `capturing.yml` config file.

To start capturing, player should **right click** a **mob** with **capture item**.

{% hint style="warning" %}
Only mobs that have [Pet Template](https://nightexpress.gitbook.io/combatpets/features/pet-templates) avaialble for their entity type can be captured.
{% endhint %}

## Features

* ✅ **Capture Item**. Custom item to capture pets.
* ✅ **Item Consume**. Set whether or not to consume capture item on use.
* ✅ **Escape Chance**. Per Pet chance to escape capture.
* ✅ **Capture Chance**. Per Pet chance for successful capture.
* ✅ **Health Percent**. Set max health % for mobs to be available for capture.
* ✅ **Save Progress**. If capture was unsuccessful, next attempts will have previous successful % value.

## Details

* Mobs can only be captured when their **health %** is **under** certain value.
* If mob escaped during capturing, it can not be captured anymore.
* Tier of the captured pet is choosen by the **Weight** option of [Pet Tier](https://nightexpress.gitbook.io/combatpets/features/pet-tiers) configs.
* Tamed & MythicMobs mobs can not be captured.
* Player must have capture [Permission](https://nightexpress.gitbook.io/combatpets/general/permissions)(s) for specific [Pet](https://nightexpress.gitbook.io/combatpets/features/pet-templates)(s) to be able to capture them.

## Setup Tips

### Toggle Capturing

To enable or disable the Capturing feature, go to `config.yml` and set the `Features` -> `Capture` on `false` or `true`.

### Escape & Capture Chances

To set escape or capture chance for a **specific pet**, go to [Pet Template](https://nightexpress.gitbook.io/combatpets/features/pet-templates) configuration(s) and edit the `Capture` -> `Chance` and `Capture` -> `Escape_Chance` settings.

### Exclude Tiers

To exclude a **specific tier** from capturing, go to [Pet Tier](https://nightexpress.gitbook.io/combatpets/features/pet-tiers) configuration(s) and set the `Catching` -> `Enabled` on `false`.

### Disable Escaping

To disable escaping for **all mobs**, go to `capturing.yml` and set `Escape_Allowed` on `false`.

### Health Requirement

There is `Health_Percent` setting in the `capturing.yml` that defines mob health requirement to be able to capture it.

You can set it to `100` to disable it.

### More Random

To make capture more **difficult** and **less predictable**, you can disable the `Save_Progress` setting in the `capturing.yml`.

It will make next attempts after the first unsuccessful capture completely random instead of saving previous progress value.