> For the complete documentation index, see [llms.txt](https://hardi-1.gitbook.io/wikivaltryx/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hardi-1.gitbook.io/wikivaltryx/mekhaniki/plaginy/customtools.md).

# CustomTools

Добро пожаловать в официальную документацию плагина **CustomTools** для Minecraft 1.20.1 Paper!

Этот плагин добавляет уникальные механики взаимодействия с предметами и блоками, делая игровой процесс более интересным и функциональным.

{% hint style="info" %}
**Важно:** Все эффекты плагина сохраняются после перезапуска сервера!
{% endhint %}

### 📋 Содержание

1. 🖌️ Кисточка
2. 🖼️ Рамки для предметов
3. 🦴 Костная мука
4. 💡 Советы и хитрости
5. ❓ FAQ

***

### 🖌️ Кисточка

Кисточка в нашем плагине получила две уникальные функции!

#### 🌱 Превращение подзола в дёрн

**Как использовать:**

1. Возьмите **Кисточку** в основную руку
2. Найдите блок **Подзола**
3. Нажмите **ПКМ** по подзолу
4. Наслаждайтесь результатом! ✨

{% hint style="success" %}
**Эффект:** Область 3×3 блоков подзола мгновенно превращается в дёрн с красивыми частицами!
{% endhint %}

**📊 Детали механики:**

| Параметр         | Значение                   |
| ---------------- | -------------------------- |
| Область действия | 3×3 блока                  |
| Тип частиц       | `VILLAGER_HAPPY`           |
| Звуковой эффект  | Звук мотыги                |
| Расход прочности | 1 единица за использование |

#### 🖼️ Показ скрытых рамок

**Как показать скрытую рамку:**

1. Возьмите **Кисточку** в руку
2. Найдите невидимую рамку (попробуйте навести курсор в места, где могут быть рамки)
3. Нажмите **ПКМ** по невидимой рамке
4. Рамка появится с магическими эффектами! ✨

**🎆 Эффекты появления:**

* **Частицы зачарования** (`ENCHANTMENT_TABLE`)
* **Световые лучи** (`END_ROD`)
* **Магические звуки** появления
* Кисточка теряет прочность

{% hint style="info" %}
**Подсказка:** Если вы не помните, где скрыли рамку, попробуйте водить кисточкой по стенам - курсор изменится при наведении на невидимую рамку!
{% endhint %}

***

### 🖼️ Рамки для предметов

Рамки получили множество новых возможностей! Теперь их можно скрывать и замораживать для создания уникальных механизмов.

#### 👻 Скрытие рамок

**Как скрыть рамку:**

1. Поместите любой предмет в рамку
2. Возьмите **Ножницы** в руку
3. Зажмите **Shift**
4. Нажмите **ПКМ** по рамке
5. Рамка станет невидимой! 🫥

{% hint style="warning" %}
**Важно:** Скрыть можно только рамки с предметами внутри!
{% endhint %}

**Как показать скрытую рамку:**

1. Возьмите **Кисточку** в руку
2. Нажмите **ПКМ** по невидимой рамке
3. Рамка появится с красивыми эффектами! ✨

#### 🧊 Заморозка рамок

Заморозка блокирует возможность поворачивать предметы в рамках - идеально для защиты декораций!

**Как заморозить рамку:**

1. Возьмите **Пчелиные соты** в руку
2. Нажмите **ПКМ** по рамке
3. Рамка замораживается! ❄️

**Как разморозить рамку:**

1. Возьмите **Костную муку** в руку
2. Нажмите **ПКМ** по замороженной рамке
3. Рамка размораживается! 🌱

{% hint style="success" %}
**Логика:** Пчелиные соты (воск) замораживают, костная мука (удобрение) оживляет!
{% endhint %}

#### 📋 Сравнительная таблица

| Действие    | Предмет       | Дополнительно | Эффект                 |
| ----------- | ------------- | ------------- | ---------------------- |
| Скрыть      | Ножницы       | + Shift       | Рамка исчезает         |
| Показать    | Кисточка      | -             | Магические эффекты     |
| Заморозить  | Пчелиные соты | -             | Блокировка поворота    |
| Разморозить | Костная мука  | -             | Разблокировка поворота |

#### 🎯 Практические применения

**Скрытые рамки:**

* **Секретные кнопки** - спрячьте рычаги и кнопки
* **Невидимые декорации** - создавайте "парящие" предметы
* **Скрытые механизмы** - прячьте редстоун-устройства
* **Минималистичный дизайн** - убирайте лишние элементы интерьера

**Замороженные рамки:**

* **Защита музеев** - предметы нельзя случайно повернуть
* **Стабильные декорации** - картины и карты не собьются
* **Защита от гриферов** - заморозьте важные элементы
* **Точные механизмы** - редстоун-устройства с фиксированным положением

***

### 🦴 Костная мука

Костная мука получила две новые удивительные способности!

#### 🌳 Восстановление коры деревьев

**Как использовать:**

1. Возьмите **Костную муку** в руку
2. Найдите дерево без коры (stripped log/wood)
3. Нажмите **ПКМ** по блоку дерева
4. Кора восстановится! 🌲

{% hint style="success" %}
**Эффект:** Любой ободранный блок дерева мгновенно получает свою кору обратно с красивыми эффектами роста!
{% endhint %}

#### 🌲 Поддерживаемые типы деревьев

**Брёвна (Logs):**

* **Дуб** (Oak) - `STRIPPED_OAK_LOG` → `OAK_LOG`
* **Берёза** (Birch) - `STRIPPED_BIRCH_LOG` → `BIRCH_LOG`
* **Ель** (Spruce) - `STRIPPED_SPRUCE_LOG` → `SPRUCE_LOG`
* **Джунгли** (Jungle) - `STRIPPED_JUNGLE_LOG` → `JUNGLE_LOG`
* **Акация** (Acacia) - `STRIPPED_ACACIA_LOG` → `ACACIA_LOG`
* **Тёмный дуб** (Dark Oak) - `STRIPPED_DARK_OAK_LOG` → `DARK_OAK_LOG`
* **Мангровое дерево** (Mangrove) - `STRIPPED_MANGROVE_LOG` → `MANGROVE_LOG`
* **Вишня** (Cherry) - `STRIPPED_CHERRY_LOG` → `CHERRY_LOG`
* **Бамбук** (Bamboo) - `STRIPPED_BAMBOO_BLOCK` → `BAMBOO_BLOCK`

**Древесина (Wood):**

* **Дубовая древесина** - `STRIPPED_OAK_WOOD` → `OAK_WOOD`
* **Берёзовая древесина** - `STRIPPED_BIRCH_WOOD` → `BIRCH_WOOD`
* **Еловая древесина** - `STRIPPED_SPRUCE_WOOD` → `SPRUCE_WOOD`
* **Древесина джунглей** - `STRIPPED_JUNGLE_WOOD` → `JUNGLE_WOOD`
* **Акациевая древесина** - `STRIPPED_ACACIA_WOOD` → `ACACIA_WOOD`
* **Древесина тёмного дуба** - `STRIPPED_DARK_OAK_WOOD` → `DARK_OAK_WOOD`
* **Мангровая древесина** - `STRIPPED_MANGROVE_WOOD` → `MANGROVE_WOOD`
* **Вишнёвая древесина** - `STRIPPED_CHERRY_WOOD` → `CHERRY_WOOD`

{% hint style="info" %}
**Всего поддерживается:** 17 различных типов ободранной древесины!
{% endhint %}

#### 🧊 Разморозка рамок

**Как разморозить рамку:**

1. Возьмите **Костную муку** в руку
2. Найдите замороженную рамку (с ней нельзя взаимодействовать)
3. Нажмите **ПКМ** по рамке
4. Рамка размораживается! 🌱

#### 📊 Сводная таблица использования

| Применение          | Цель               | Эффект                    | Расход         |
| ------------------- | ------------------ | ------------------------- | -------------- |
| Восстановление коры | Ободранное дерево  | Возвращает кору + частицы | 1 костная мука |
| Разморозка рамки    | Замороженная рамка | Разблокирует поворот      | 1 костная мука |

***

### 💡 Советы и хитрости

#### 🎯 Общие советы

{% hint style="warning" %}
**Важно:** Все инструменты и материалы расходуются при использовании. Планируйте свои действия заранее!
{% endhint %}

| Предмет       | Расход                           | Применение                            |
| ------------- | -------------------------------- | ------------------------------------- |
| Кисточка      | Прочность (-1 за использование)  | Подзол → дёрн, показ рамок            |
| Костная мука  | Количество (-1 за использование) | Восстановление коры, разморозка рамок |
| Пчелиные соты | Количество (-1 за использование) | Заморозка рамок                       |
| Ножницы       | Не расходуются                   | Скрытие рамок                         |

#### 🖌️ Продвинутые техники с кисточкой

**Ландшафтный дизайн:**

1. **Планируйте большие области** - кисточка обрабатывает 3×3, используйте это
2. **Создавайте узоры** - чередуйте подзол и дёрн для интересных текстур
3. **Восстанавливайте биомы** - превращайте испорченные участки в красивые лужайки

{% hint style="info" %}
**Лайфхак:** Если забыли, где скрыли рамку, медленно водите кисточкой по стене - курсор изменится при наведении на невидимую рамку!
{% endhint %}

#### 🖼️ Мастерство работы с рамками

**Создание секретных механизмов:**

1. **Скрытые кнопки:**
   * Поместите рычаг в рамку
   * Скройте рамку ножницами + Shift
   * Подключите редстоун
   * Получите невидимую кнопку!
2. **Защищённые экспозиции:**
   * Разместите ценные предметы в рамках
   * Заморозьте все рамки пчелиными сотами
   * Никто не сможет случайно повернуть экспонаты

{% hint style="success" %}
**Мастер-класс:** Создайте секретную дверь, скрыв рамку с рычагом, затем заморозив её для дополнительной защиты!
{% endhint %}

#### 🌳 Экологичное строительство

**Восстановление природы:**

1. **После добычи ресурсов:**
   * Всегда восстанавливайте кору костной мукой
   * Превращайте подзол в дёрн кисточкой
   * Оставляйте природу красивой для других игроков
2. **Исправление ошибок:**
   * Случайно ободрали не тот блок? Костная мука исправит!
   * Испортили ландшафт? Кисточка поможет восстановить!

#### 🎨 Креативные проекты

**Идеи для строителей:**

1. **Музей с защитой:**
   * Разместите экспонаты в рамках
   * Заморозьте все рамки
   * Создайте информационные таблички
2. **Секретная база:**
   * Скройте все рамки с механизмами
   * Создайте невидимые входы
   * Заморозьте критически важные элементы
3. **Интерактивная выставка:**
   * Комбинируйте скрытые и видимые рамки
   * Создавайте "появляющиеся" экспонаты
   * Используйте заморозку для финальных позиций

{% hint style="success" %}
**Помните:** Все изменения сохраняются после перезапуска сервера, поэтому ваши творения будут жить вечно!
{% endhint %}

***

### ❓ FAQ

#### 🔧 Общие вопросы

**В: Сохраняются ли эффекты после перезапуска сервера?**

{% hint style="success" %}
**О:** Да! Все эффекты (скрытые рамки, замороженные рамки) полностью сохраняются после перезапуска сервера.
{% endhint %}

**В: На каких версиях работает плагин?**

**О:** Плагин разработан для Minecraft 1.20.1 Paper. Совместимость с другими версиями не гарантируется.

#### 🖌️ Вопросы о кисточке

**В: Почему кисточка не работает на подзоле?**

**О:** Проверьте:

* Кисточка находится в **основной руке** (не в левой)
* Вы нажимаете **ПКМ** (правую кнопку мыши)
* Блок действительно является **подзолом**
* У кисточки есть прочность

**В: Можно ли увеличить область действия кисточки?**

**О:** Нет, область действия фиксирована - 3×3 блока. Это сделано для баланса игры.

**В: Кисточка сломалась, что делать?**

{% hint style="warning" %}
**О:** Кисточка изнашивается при использовании. Создайте новую или отремонтируйте в наковальне.
{% endhint %}

#### 🖼️ Вопросы о рамках

**В: Не могу скрыть рамку, что не так?**

**О:** Для скрытия рамки нужно:

* В рамке должен быть **любой предмет** (не пустая)
* Ножницы в **основной руке**
* Зажать **Shift**
* Нажать **ПКМ** по рамке

**В: Как найти скрытую рамку, если забыл где она?**

{% hint style="info" %}
**О:** Возьмите кисточку и медленно водите по стене. Курсор изменится при наведении на невидимую рамку!
{% endhint %}

**В: Замороженную рамку нельзя повернуть, это баг?**

**О:** Это не баг, а функция! Замороженные рамки полностью блокируют поворот до разморозки костной мукой.

#### 🦴 Вопросы о костной муке

**В: Костная мука не восстанавливает кору, почему?**

**О:** Проверьте:

* Блок действительно **ободранный** (stripped)
* Костная мука в **основной руке**
* Нажимаете **ПКМ** по блоку
* Тип дерева поддерживается плагином

**В: Какие типы деревьев поддерживаются?**

**О:** Поддерживаются все ванильные типы:

* Дуб, Берёза, Ель, Джунгли
* Акация, Тёмный дуб, Мангровое, Вишня, Бамбук
* Как брёвна (logs), так и древесина (wood)

#### 🎮 Игровые вопросы

**В: Считается ли использование плагина читерством?**

{% hint style="success" %}
**О:** Нет! Плагин официально установлен на сервере и доступен всем игрокам. Используйте все функции свободно!
{% endhint %}

**В: Есть ли ограничения на использование?**

**О:** Единственное ограничение - расход материалов (прочность кисточки, количество костной муки и сот).

#### 🔍 Решение проблем

**В: Функция не работает, что делать?**

1. **Проверьте предмет в руке** - правильный ли предмет, в правильной ли руке
2. **Проверьте цель** - подходит ли блок/рамка для данной функции
3. **Проверьте действие** - правильная ли кнопка мыши, нужен ли Shift
4. **Перезайдите на сервер** - иногда помогает обновить соединение

**В: Эффекты пропали после перезапуска?**

{% hint style="danger" %}
**О:** Это не должно происходить! Если эффекты пропали, немедленно сообщите администрации - возможна проблема с сохранением данных.
{% endhint %}

#### 📞 Получение помощи

При сообщении о проблеме укажите:

* **Что делали** (пошаговые действия)
* **Что ожидали** (какой результат должен был быть)
* **Что получили** (что произошло на самом деле)
* **Версию клиента** и другие детали

{% hint style="info" %}
**Совет:** Чем подробнее описание проблемы, тем быстрее её можно решить!
{% endhint %}

***

*Создано для игроков нашего сервера с ❤️*

### 📢 Поддержка и обратная связь

Если у вас возникли вопросы, предложения или вы обнаружили баг — пожалуйста, сообщите нам:

🌐 **valtryx.fun/feedback**

💬 **Discord** — канал поддержки

*Не нашли ответ на свой вопрос? Обратитесь к администрации сервера!*