Типы слотов (type)
Параметр type — это сердце каждой иконки в меню. Он говорит плагину, как должен вести себя этот слот: будет ли он просто декорацией, или он должен автоматически отображать предмет, надетый на игрока.
Правильное использование типов позволяет создавать по-настоящему динамичные и умные профили.
Сводная таблица всех типов
Ниже приведен краткий справочник по всем доступным типам слотов.
Тип (type) | Описание | Пример использования |
|---|---|---|
DEFAULT | Тип по умолчанию. Обычный, статичный предмет. | Декоративные рамки, кнопки команд. |
HELMET | Отображает ванильный шлем (реальную броню). | Слот с алмазным/незеритовым шлемом. |
CHEST_PLATE | Отображает нагрудник (реальную броню). | Слот для нагрудника. |
LEGGINGS | Отображает поножи (реальную броню). | Слот для поножей. |
BOOTS | Отображает ботинки (реальную броню). | Слот для ботинок. |
MAIN_HAND | Отображает предмет в реальной главной руке. | Слот для меча или кирки. |
OFF_HAND | Отображает предмет в реальной второй руке. | Слот для тотема или щита. |
HAT | Отображает косметическую шляпу. Отличается от HELMET. | Слот для визуальной шапки (косметика). |
BACKPACK | Отображает косметический рюкзак. | Слот для рюкзака. |
WALKING_STICK | Отображает косметическую трость. Отличается от OFF_HAND. | Слот для трости/жезла. |
BALLOON | Отображает косметический шар. | Слот для спутника-шара. |
SPRAY | Отображает выбранный спрей. | Слот для спрея. |
STATUS | Отображает кастомный статус игрока. | Иконка с текстом статуса. |
DRAG_AND_DROP | Слот для временного размещения предметов. | Примерочная. |
SAVED_ITEM | Слот для Drag & Drop постоянного сохранения предметов. | Витрина редких предметов. |
Информация
Слоты снаряжения и косметики являются read-only (только для чтения). Игроки не могут забрать предмет из такого слота через меню. Они лишь отображают текущее состояние игрока.
Стандартное снаряжение (Ванильное)
Эти типы напрямую связаны с реальным инвентарём игрока. Они показывают предметы, дающие характеристики (защиту, эффекты).
Тип (type) | Описание |
|---|---|
HELMET | Реальный шлем из слота брони (например, Алмазный шлем). |
CHEST_PLATE | Реальный нагрудник из слота брони. |
LEGGINGS | Реальные поножи из слота брони. |
BOOTS | Реальные ботинки из слота брони. |
MAIN_HAND | Предмет, который игрок физически держит в основной руке. |
OFF_HAND | Предмет, который игрок физически держит во второй руке (например, Щит). |
Косметическое снаряжение
Эти типы позволяют отображать визуальную косметику отдельно от реальной брони. Плагин поддерживает интеграцию с ECosmetics, HMCCosmetics и CosmeticsCore. Выбор провайдера осуществляется в config.yml (опция cosmetics-provider).
Тип (type) | Описание | Примечание |
|---|---|---|
HAT | Отображает визуальную Шляпу. | |
BACKPACK | Отображает экипированный Рюкзак. | |
WALKING_STICK | Отображает экипированную Трость/Жезл. | |
BALLOON | Отображает экипированный Воздушный шар. | |
SPRAY | Отображает выбранный Спрей. | В основном только в ECosmetics. |
В чем разница между HELMET и HAT?
HELMET: Показывает реальный предмет (например, Незеритовый шлем на Защиту IV).HAT: Показывает косметический предмет (только визуал), надетый через плагин косметики.
Вы можете использовать оба типа в одном меню, чтобы показать, какая у игрока броня И как он выглядит!
Функциональные слоты
Эти типы обладают уникальной логикой и делают профили интерактивными.
Тип (type) | Описание |
|---|---|
STATUS | Отображает предмет, символизирующий статус игрока. Рекомендуется использовать с states и разными предметами для онлайн/оффлайн статуса (onlineItem/offlineItem), чтобы иконка менялась. |
DRAG_AND_DROP | Слот, в который владелец профиля может временно поместить любой свой предмет. Предмет не сохранится после закрытия инвентаря. Полезен для примерки или временного хранения. |
SAVED_ITEM | Персистентный слот. Предмет, который владелец профиля поместит сюда, сохранится в базе данных и будет виден всем, кто смотрит его профиль. Идеально для показа трофеев, любимого оружия или инструмента. |
Сохранённые предметы (SAVED_ITEM)
Используйте этот тип с осторожностью. Если вы удалите слот SAVED_ITEM из конфигурации, игроки потеряют доступ к сохранённым в нём предметам! Данные останутся в БД, но вернуть их можно будет только через редактирование базы.
Слоты для меню статуса
Эти типы предназначены исключительно для использования в меню смены статуса (status.yml). Не используйте их в обычных профилях.
Тип (type) | Описание |
|---|---|
CHANGE_STATUS_ACCEPT | Кнопка подтверждения. При нажатии сохраняет текст из наковальни как новый статус. |
CHANGE_STATUS_CANCEL | Кнопка отмены. При нажатии закрывает меню смены статуса без сохранения. |