Плагин Косметика GadgetsMenu [Premium] [5.34.0]

• Добавлена поддержка 26.3. (Бета)

• Добавлено 10 новых эмоций: Mind Blown, Facepalm, Jackpot, Error 404, Star Struck, Vanish, X-Ray, Melting, Bubblegum, Overcaffeinated.
• Добавлено 32 новых анимированных головных убора: Spinning Globe, Campfire, Aquarium, Buffering, Thunder Cloud, Black Hole, Mimic Chest, Galaxy, Lava Lamp, Rubik's Cube, Volcano, Fireworks, Cuckoo Clock, Aurora, Matrix Rain, Snow Globe, Disco Ball, Pufferfish, Magic 8-Ball, Hourglass, Aqua Orb, Ender Pulse, Evil Eye, Fire Demon, Ice Mage, Golem, Basketball, Robo Bird, Fox Spirit, Derpy Eyes, Demon Eyes, Bauble.
• Добавлено 19 новых плащей: Rainy Day, Acid Rain, Bone Wings, Melon, Clover, Strawberry, Snow Globe, Popcorn, Bubble Tea, Mushroom, Ghost, Avocado, Donut, Bee, Jellyfish, Rainbow, Rocket, Diamond, Gift Box, Crown, Pumpkin, Burger.
• Кастомные плащи:
  • Добавлен режим анимации PICTURE, который отображает изображение плоско на спине игрока, используя тот же рендерер, что и встроенные плащи с изображениями. Теперь настроенный плащ может воспроизводить любой из них.
  • Фигуры теперь можно рисовать в виде символьной графики с использованием палитры (Palette), где каждому символу соответствует определённый цвет, вместо указания HEX-кода через запятую для каждой ячейки. Например, встроенная фигура Clover занимает около 4200 символов в старом формате и всего 525 в формате символьной графики.
  • Для слоёв PICTURE добавлен необязательный параметр Rotation, позволяющий поворачивать изображение в его собственной плоскости, как это сделано у плащей Clover и Bubble Tea.
  • Удалён режим анимации COLOR_GRID. Он отображал то же самое, что и PICTURE, но имел менее удобное управление. Слой, всё ещё использующий COLOR_GRID, будет пропущен, а в консоли будут указаны ключи, которые необходимо изменить. Инструкции по конвертации доступны в документации Custom Cloaks.
• Гаджет Grappling Hook теперь доступен на серверах версии 1.8 и выше. Ранее он работал только на серверах версии 1.13 и выше.
• Исправлено ISSUES-1039 — обновление предметов меню перенесено в основной поток для более безопасного и стабильного выполнения.
• Исправлено ISSUES-1040 — оптимизированы эффекты частиц для повышения производительности призыва и общей эффективности.
• Исправлено ISSUES-1041 — оптимизирован HTTP-запрос /gmenu about -diagnose, чтобы предотвратить блокировку основного потока. Также добавлен тайм-аут подключения.
• Исправлено ISSUES-1043 — исправлена ошибка, из-за которой гаджет Scarecrow навсегда удалял настоящий шлем игрока при активации.
• Исправлено ISSUES-1045 — оптимизирована загрузка музыкальных гаджетов: файлы песен теперь обрабатываются только один раз при инициализации, что сокращает время последующих загрузок.

• Добавлено 5 новых плащей: Rainy Day Cloak, Acid Rain Cloak, Bone Wings Cloak, Easter Egg Cloak, Monarch Wings Cloak.
• Добавлен гаджет Flammable Grappling Hook.
• Гаджет Grappling Hook теперь подтягивает игрока выше как при запуске, так и при прибытии, благодаря чему зацепиться за край возвышенности стало значительно надёжнее.
• Добавлена поддержка четырёх медных инструментов нотных блоков, появившихся в Minecraft 26.1: Trumpet, Exposed Trumpet, Weathered Trumpet и Oxidized Trumpet.
• Чтение песен .nbs обновлено до последнего формата Note Block Studio (версия 5). Теперь песни могут содержать до 240 пользовательских инструментов и размещать их пользовательские звуки во вложенных папках. Также теперь считываются настройки зацикливания, блокировки слоёв, имя оригинального автора и размер такта песни.

Изменения

• Добавлены кастомные плащи (Custom Cloaks). Теперь можно создавать собственные плащи с использованием 6 режимов анимации: GRID, COLOR_GRID, ORBIT, SPIRAL, SCATTER, SPHERE, нескольких слоёв анимации для одного плаща, частиц для каждого слоя и смены цветов.
• Вместе с Custom Cloaks добавлено 7 демонстрационных примеров — по одному для каждого типа анимации: Infernal Wings, Phoenix Wings, Astral Helix, Aurora Scanner, Nebula Storm, Arcane Sphere и трёхслойный Seraph Aegis. Все они отключены по умолчанию.
• Удалена поддержка v1_21_R5 (1.21.6, 1.21.7, 1.21.8). Поддержка версий 1.21.9, 1.21.10 и 1.21.11 сохранена.
• Исправлена ISSUES-1031 — исправлена редкая проблема, из-за которой экипированные косметические предметы не восстанавливались при входе игрока, в результате чего сохранённый выбор косметики удалялся из базы данных.

Подробнее о Custom Cloaks: перейти к документации

• Fixed ISSUES-1028 - Fixed a ClassNotFoundException (PacketPlayOutMount) affecting the Cowboy Gadget on Paper 26.1/26.2.

• Переработана и улучшена анимация гаджета Railgun.
• Исправлено [ISSUES-1033] — исправлена проблема с асинхронным обновлением инвентаря игроков, которая могла приводить к ConcurrentModificationException.
• Исправлено [ISSUES-1034] — исправлена проблема с запланированными асинхронными проверками инвентаря, которые могли вызывать рассинхронизацию инвентаря и ошибки.
• Исправлено [ISSUES-1035] — исправлена проблема, из-за которой асинхронное обновление анимированных шляп могло вызывать ошибки синхронных событий при смене мира игроком.
• Исправлено [ISSUES-1036] — исправлена проблема, из-за которой экипировка косметического предмета с Equip-Cosmetic-Item-To-Slot, установленным в REPLACE или DROP, могла уничтожить или выбросить неправильный предмет. Замещённый предмет теперь безопасно возвращается в инвентарь игрока.
• Исправлено [ISSUES-1037] — исправлена проблема, из-за которой передача Mystery Dust офлайн-игрокам не работала из-за асинхронного выполнения событий.
• Исправлено [ISSUES-1038] — исправлена проблема, из-за которой баланс Mystery Dust мог некорректно перезаписываться или становиться отрицательным при ошибках базы данных. Также оптимизированы CRUD-операции с базой данных.

• Исправлено: устранена проблема ISSUES-1032, из-за которой игроки могли бесплатно получать Gifted Mystery Boxes.
• Исправлено: устранена ошибка, которая могла вызывать IllegalAccessError на серверах Paper.

Изменения​

• В публичный API для разработчиков добавлен новый набор событий Bukkit:
  • ItemPurchaseEvent
  • CosmeticEquipEvent
  • CosmeticUnequipEvent
  • CosmeticUnlockEvent
  • MysteryBoxCraftEvent
  • MysteryBoxRewardEvent
  • GadgetActivateEvent
  • EmoteActivateEvent
  Теперь разработчики могут отслеживать (и при необходимости отменять) покупку, экипировку и разблокировку косметики, создание и открытие Mystery Box, а также активацию гаджетов и эмоций.
• Исправлено (ISSUES-1028): устранена ошибка ClassNotFoundException (PacketPlayOutMount), возникавшая при спешивании с питомца на Paper 26.1/26.2.

---

API для разработчиков — новые события​

Все события находятся в пакете com.yapzhenyie.GadgetsMenu.api.event и используют стандартную систему событий Bukkit (@EventHandler, getHandlerList()).

Косметика​

Событие	Можно отменить	Описание
ItemPurchaseEvent	✅	Вызывается при покупке косметики за Mystery Dust. Содержит PurchaseStatus (SUCCESS / FAILED). При отмене успешной покупки потраченная валюта автоматически возвращается игроку.
CosmeticEquipEvent	✅	Вызывается при экипировке любой косметики. Позволяет запретить использование косметики, например, на аренах или во время боя.
CosmeticUnequipEvent	❌	Вызывается при снятии косметики. Используется только для уведомления.
CosmeticUnlockEvent	❌	Вызывается, когда игрок получает косметику: при покупке, открытии Mystery Box или выдаче через API/администратором.

События экипировки, снятия и разблокировки предоставляют объект CosmeticType (getCosmeticType()), через который можно получить:

• название;
• отображаемое имя;
• требуемое разрешение;
• редкость;
• стоимость в Mystery Dust.

Для комплектов брони (Suits) событие вызывается отдельно для каждой части комплекта.

Mystery Box​

Событие	Можно отменить	Описание
MysteryBoxCraftEvent	✅	Вызывается при создании Mystery Box за Mystery Dust.
MysteryBoxRewardEvent	❌	Вызывается при получении награды из Mystery Box. Метод isDuplicate() позволяет определить, была ли эта награда уже разблокирована ранее.

Гаджеты и эмоции​

Событие	Можно отменить	Описание
GadgetActivateEvent	✅	Вызывается при активации гаджета. Метод isLeftClick() позволяет определить тип клика.
EmoteActivateEvent	✅	Вызывается при активации эмоции.

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

• Fixed ISSUES-1030 - Rideable horse-family pets (horse, donkey, mule, llama, camel, skeleton/zombie horse) no longer spam ClassCastException while being ridden on Minecraft 26.2.

5.29.0​