> For the complete documentation index, see [llms.txt](https://wiki.comelyworld.online/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.comelyworld.online/top/pitomcy.md).

# Питомцы

### Что это такое

Система питомцев позволяет приручать обычных мобов (волков, зомби, големов и т.д.) — они становятся личными питомцами игрока, следуют за ним, сражаются на его стороне и хранятся в базе данных между заходами на сервер.

{% hint style="warning" %}
Ванильное приручение отключено — приручение возможно только через предметы плагина.
{% endhint %}

***

### Как получить питомца

1. Возьмите в руку **Волшебную морковь** (золотая морковь со специальной меткой — обычная морковь не сработает).
2. Кликните ПКМ по разрешённому мобу.

{% hint style="warning" %}
Морковь расходуется всегда, даже если приручение провалилось.
{% endhint %}

Шанс успеха зависит от типа моба:

| Моб                      | Шанс приручения |
| ------------------------ | --------------- |
| Волк                     | 100%            |
| Кошка                    | 75%             |
| Панда                    | 50%             |
| Зомби, скелет и их родня | 40%             |
| Железный голем           | 20%             |
| Визер-скелет             | 15%             |

При успехе моб исчезает из мира и попадает в хранилище игрока. Сохраняются: имя (если было), здоровье, окрас/вариант (порода кошки, цвет попугая, масть лошади и т.д.), броня и седло (на лошадях, волках, ламах, аллеях и т.д.).

***

### Команды

| Команда                 | Описание                        |
| ----------------------- | ------------------------------- |
| `/pets`                 | Открыть меню питомцев (главное) |
| `/pet give <ник>`       | Подарить питомца другому игроку |
| `/pet giveaccept <id>`  | Принять предложенный подарок    |
| `/pet givedecline <id>` | Отклонить предложенный подарок  |

***

### Меню /pets

Меню представляет собой сундук-интерфейс на 54 слота, по 44 питомца на страницу (перелистывание стрелками «Назад»/«Вперёд» внизу).

Каждый питомец отображается иконкой с описанием: здоровье с полоской, статус, ID, дата приручения, количество дней с игроком, порода/окрас, а для сидящего или раненого питомца — мир и координаты его местонахождения. Мёртвый питомец отображается черепом. Книга по центру меню показывает соотношение «Всего / Лимит».

#### Управление в меню

| Действие                                              | Результат                                                                         |
| ----------------------------------------------------- | --------------------------------------------------------------------------------- |
| ЛКМ                                                   | Призвать питомца; если он уже активен — телепортировать к себе                    |
| ПКМ                                                   | Убрать питомца в хранилище                                                        |
| Shift + ЛКМ                                           | Посадить/поднять питомца (сидящий питомец не следует за хозяином)                 |
| Shift + ПКМ                                           | Удалить питомца — с отдельным подтверждением (зелёная/красная шерсть), необратимо |
| ПКМ с едой питомца в руке                             | Вылечить раненого питомца (в том числе из хранилища)                              |
| ПКМ с зачарованным золотым яблоком на мёртвом питомце | Возродить с полным HP (яблоко расходуется, эффект аналогичен тотему)              |

***

### Статусы питомца

| Статус      | Описание                                                                                                                                    |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| Активен     | Питомец в мире, следует за хозяином                                                                                                         |
| В хранилище | Питомец «в кармане», не занимает лимит активных                                                                                             |
| Ранен       | Призвать нельзя, лечится только едой питомца                                                                                                |
| Мёртв       | Возрождается зачарованным яблоком; для донат-групп с бессмертием — автоматически через 6 часов (оживает раненым с 1 HP, далее лечится едой) |

***

### Поведение питомца в мире

#### Следование

Раз в 5 тиков питомец движется за хозяином. Если расстояние превышает 25 блоков или хозяин переходит в другой мир — питомец телепортируется к нему, с поиском безопасного места (без лавы и кактусов).

#### Бой

В бою участвуют только «боевые» типы питомцев (волк, зомби, скелет, голем, паук и подобные).

* Если хозяина атаковали или хозяин сам ударил моба — питомец бросается на обидчика.
* Питомец не выбирает цели самостоятельно (ванильный AI отключён).
* Питомец не атакует чужих мобов и не атакует своего хозяина.
* Урон от питомца по любой другой цели, кроме обидчика, отменяется.

#### Защита

* Питомец не получает урон от падения, не горит, не тонет в пустоте (телепортируется к хозяину), не задыхается в блоках.
* Сидящий питомец полностью бессмертен: любой урон отменяется; при падении в пустоту питомец перемещается в хранилище.
* С убитого питомца ничего не выпадает.

{% hint style="info" %}
Разведение питомцев отключено — скрестить питомца нельзя.
{% endhint %}

#### Ограничения для чужих игроков

* Взаимодействие с чужим питомцем полностью запрещено: нельзя оседлать, ограбить или «угнать».
* Хозяин может ездить на верховых питомцах (лошадь, свинья, страйдер, гаст, наутилус) и надевать на них броню/седло.
* Сидящего питомца оседлать нельзя.
* Сундук осла/мула/ламы открыть нельзя — содержимое не сохраняется.
* Стричь овец и доить коров/коз, являющихся питомцами, нельзя.

{% hint style="info" %}
Седлание работает по ванильным правилам, но питомцы не подбирают предметы. У зомби и скелетов при призыве очищается снаряжение, чтобы исключить фарм дропа.
{% endhint %}

***

### Предметы плагина

| Предмет                                         | Назначение                                                                                                                                                           |
| ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Волшебная морковь                               | Приручение мобов                                                                                                                                                     |
| Золотая еда питомца (жареная говядина с меткой) | ПКМ по своему питомцу — полное лечение или вывод из состояния «ранен» (работает и по раненому питомцу в хранилище через меню)                                        |
| Магический поводок (поводок с меткой)           | Ведёт моба за собой; работает на любом разрешённом мобе, даже не приручённом; один игрок может вести только одного моба одновременно, повторный клик снимает поводок |

{% hint style="warning" %}
У предметов плагина нет крафта — выдача возможна только администратором.
{% endhint %}

***

### Подарки между игроками

1. Игрок вызывает `/pet give <ник>` — открывается выбор питомца (раненых и мёртвых питомцев подарить нельзя).
2. Получателю в чат приходит предложение с 2 минутами на решение: `/pet giveaccept` или `/pet givedecline`.

{% hint style="warning" %}
Кулдаун на отправку подарка — 60 секунд. Питомца нельзя отдать, если у получателя уже достигнут лимит.
{% endhint %}

***

### Донат-группы и лимиты

| Группа  | Питомцев всего | Активных одновременно | Бессмертие |
| ------- | -------------- | --------------------- | ---------- |
| игрок   | 3              | 1                     | нет        |
| comely  | 5              | 3                     | нет        |
| vip     | 5              | 2                     | да         |
| elite   | 10             | 5                     | да         |
| sponsor | 15             | 10                    | да         |

Списки разрешённых мобов у большинства групп практически идентичны (волки, коты, фермерские животные, жуки, зомби/скелеты, големы, гасты, наутилусы и т.д.).

{% hint style="info" %}
Бессмертие в рамках донат-группы означает, что питомец после смерти автоматически оживает через 6 часов. Без этого статуса возрождение возможно только зачарованным золотым яблоком.
{% endhint %}

***

### Дополнительные детали

* При выходе игрока с сервера все его активные питомцы автоматически убираются в хранилище.
* После возрождения игрока его питомцы телепортируются к нему.
* При смене мира питомцы перемещаются вместе с игроком.
* Сидящие питомцы остаются в мире даже после рестарта сервера и восстанавливаются при следующем запуске.

***

### Кратко

Игрок собирает коллекцию прирученных мобов с помощью Волшебной моркови и управляет ими через `/pets` — призывает, убирает в хранилище, сажает, лечит, дарит или удаляет. Питомцы следуют за игроком и защищают его в бою. После смерти питомца можно воскресить зачарованным яблоком или дождаться автоматического возрождения при наличии соответствующей донат-группы.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://wiki.comelyworld.online/top/pitomcy.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
