> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cakestudio.fun/llms.txt
> Use this file to discover all available pages before exploring further.

# Кастомные предметы и модели

> Добавление своих предметов для топлива, ремонта и крафта из ItemsAdder, Oraxen, Nexo и CustomModelData.

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

***

## ⚙️ Настройка в конфигурациях

Вы можете прописывать предметы из сторонних плагинов в файлах конфигурации блоков привата (папка `blocks/`), в `fuel.yml` или в ремонтных наборах.

Для этого в параметре предмета укажите его ID с соответствующим префиксом. Поддерживаются форматы как с двоеточием (`:`), так и с дефисом (`-`).

### 1. ItemsAdder

Для использования предметов из ItemsAdder укажите префикс `itemsadder:` и полный namespaced ID предмета:

```yaml theme={null}
# Пример настройки топлива
itemsadder: "fandemine:ruby"
```

### 2. Oraxen

Для использования предметов из Oraxen укажите префикс `oraxen:` и ID предмета из конфигурации Oraxen:

```yaml theme={null}
# Пример настройки ремонтного набора
oraxen: "ruby_ore"
```

### 3. Nexo

Для использования предметов из Nexo укажите префикс `nexo:` и ID предмета из конфигурации Nexo:

```yaml theme={null}
# Пример в рецепте крафта
nexo: "amethyst_ingot"
```

***

## 4. Ванильный CustomModelData

Если вы настраиваете приваты с использованием классического `CustomModelData` без сторонних плагинов, укажите базовый ванильный материал в `material` и номер модели в параметре `custom-model-data`:

```yaml theme={null}
material: "PAPER"
custom-model-data: 10052
```

***

## ⌨️ Добавление предметов командами

Вы также можете добавлять предметы в списки топлива, починки или крафта прямо из руки во время игры на сервере.

### ⛽ Кастомное топливо

Любой предмет в вашей руке может стать топливом для регионов.

1. Возьмите в руку предмет, который хотите сделать топливом.
2. Используйте команду: `/ps admin additem fuel <тип> <очки_топлива> [теги]`

**Параметры:**

* **`<тип>`**:
  * `normal`: Учитывается только материал предмета (любой алмаз станет топливом).
  * `custom`: Учитывается точная копия предмета (имя, лор, модель должны совпадать).
* **`<очки_топлива>`**: Количество секунд защиты за 1 предмет.
* **`[теги]`** (только для `custom`): `-displayname`, `-lore`, `-custommodeldata`. Позволяют игнорировать конкретные части метаданных.

**Пример:** Сделать обычный алмаз топливом на 1 час (3600 секунд).
`/ps admin additem fuel normal 3600`

### 🛠️ Предметы для ремонта

Предметы для восстановления прочности блоков привата.

1. Возьмите в руку нужный предмет.
2. Используйте команду: `/ps admin additem repair <id> <очки_прочности>`

* **`<id>`**: Уникальный идентификатор (например, `heavy_repair_kit`).
* **`<очки_прочности>`**: Сколько единиц прочности восстановит 1 предмет.

**Пример:** Сделать золотое яблоко предметом починки на 5 единиц.
`/ps admin additem repair golden_apple_repair 5`

### 🧪 Ингредиенты для крафта

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

1. Возьмите в руку нужный предмет.
2. Используйте команду: `/ps admin additem ingredient <id>`

* **`<id>`**: Уникальный идентификатор (например, `magic_core`).

Зарегистрированный ингредиент можно использовать в конфиге [блока привата](/cakeregions/configuration/blocks) в формате `custom:id`.

<Note>
  Все созданные команды сохраняют предметы в папку `plugins/CakeRegionsPlus/data/items/`. Вы можете редактировать их вручную или выдавать командой `/ps admin giveitem`.
</Note>