> ## 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 на аукционе и в меню.

CakeAuction поддерживает полноценную интеграцию со всеми популярными плагинами на кастомные предметы и текстуры.

## 🛒 Продажа кастомных предметов

Все кастомные предметы из **ItemsAdder**, **Oraxen** и **Nexo** (а также любые предметы с кастомным `CustomModelData`) поддерживаются аукционом **автоматически**:

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

***

## ⚙️ Настройка статических предметов в меню

Вы можете использовать предметы из сторонних плагинов в качестве декоративных элементов, кнопок или рамок в конфигурационных файлах меню (папка `menus/`).

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

### 1. ItemsAdder

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

```yaml theme={null}
back-button:
  material: "itemsadder:fandemine:icon_back_orange" # Или "itemsadder-fandemine:icon_back_orange"
  slot: 45
  display_name: "<gray>Назад"
```

### 2. Oraxen

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

```yaml theme={null}
ruby-icon:
  material: "oraxen:ruby_sword" # Или "oraxen-ruby_sword"
  slot: 13
  display_name: "<red>Рубиновый Меч"
```

### 3. Nexo

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

```yaml theme={null}
shield-icon:
  material: "nexo:amethyst_shield" # Или "nexo-amethyst_shield"
  slot: 22
  display_name: "<purple>Аметистовый Щит"
```

***

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

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

```yaml theme={null}
custom-button:
  material: "PAPER"
  model_data: 10052 # Номер вашего CustomModelData
  slot: 4
  display_name: "Тык!"
```
