# 🎯 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](/combatpets/features/pet-templates.md) 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](/combatpets/features/pet-tiers.md) configs.
* Tamed & MythicMobs mobs can not be captured.
* Player must have capture [Permission](/combatpets/general/permissions.md)(s) for specific [Pet](/combatpets/features/pet-templates.md)(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](/combatpets/features/pet-templates.md) 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](/combatpets/features/pet-tiers.md) 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.


---

# 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://nightexpress.gitbook.io/combatpets/features/capturing.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.