pnCases 1.5.1
Большое обновление системы кейсов, анимаций, витрин и интерфейсов
Кейсы стали самостоятельными YAML-конфигурациями, Machine получил новую структуру меню, добавлены новые анимации и темы витрины, а хранение наград и пользовательских настроек стало надёжнее.
ЧТО НОВОГО
Самостоятельные кейсы в cases/*.yml
• Убрана привязка кейсов к заранее заданным типам вроде money или luckperms.
• Каждый кейс создаётся командой:
/pncases createcase
• Каждый кейс хранится в отдельном файле:
cases/.yml
• В одном кейсе можно свободно сочетать предметы, деньги Vault, поинты PlayerPoints, группы и права LuckPerms, а также персональные команды.
• Имя файла является внутренним ID кейса.
• Параметр display-name отвечает за отображаемое название кейса в GUI, голограммах, ключах и сообщениях.
• Новый кейс сразу получает одноимённый ключ без суффикса _key.
• Команды /givekey, /takekey, /setcase, /delcase и автодополнение работают с актуальными ID кейсов и ключей.
• Исправлено удаление файла кейса и его привязанных блоков через команду:
/pncases delcase
• Команда /pncases setcase привязывает выбранный кейс к блоку без копирования чужого шаблона.
Новая архитектура конфигурации кейса
• Секция blocks теперь расположена в начале файла.
• Списки слотов сохраняются в компактном формате:
[0, 1, 2]
• Конфигурация разбита на понятные секции:
• Голограмма.
• Витрина.
• GUI.
• Broadcast.
• Стоимость.
• Анимация.
• Награды.
• Виртуальный ключ и цена открытия теперь определяются самим кейсом.
• Всегда используется один ключ с ID кейса.
• Лишние параметры cost.type, cost.key и cost.amount удалены.
• Покупка ключа за опыт перенесена из плоских параметров buy_xp_* в секцию cost.xp-purchase.
• Из создаваемых файлов убраны лишние технические поля витрины:
• interval_ticks.
• radius.
• height.
• speed.
Для этих параметров используются внутренние безопасные значения.
• Удалён дублирующий параметр idle-particles.effects.
• Включение витрины теперь управляется одним параметром enabled.
• В начале нового файла выводится единая подробная подсказка по плейсхолдерам, типам наград и доступным редкостям.
• Убраны повторяющиеся комментарии-заголовки перед каждой секцией.
• Обычное сохранение больше не создаёт рядом лишние .bak-файлы.
• Резервная копия .broken.bak создаётся только при обнаружении повреждённого YAML.
• Запись YAML выполняется через временный файл с проверкой и атомарной заменой.
Настройки GUI внутри каждого кейса
• Кнопка кейса перенесена из общего gui.yml в:
cases/.yml → gui.button
• Каждый кейс может иметь собственный материал основной кнопки.
• Поддерживается собственная Base64-текстура.
• Можно настроить название кнопки.
• Можно настроить lore кнопки.
• Старое поле gui.open-item автоматически переносится в gui.button.
• Устранено предупреждение о якобы отсутствующем gui.open-item.
• Пустые строки в конце lore сохраняются, поэтому оформление больше не обрезается.
• Параметр item_data больше не мешает явно заданным name и lore.
• Название кнопки, ключа и голограммы корректно обновляется после изменения display-name.
• Для состояния нехватки ключей добавлены настройки:
• gui.insufficient-keys.name.
• gui.insufficient-keys.lore.
• Добавлен параметр gui.preview_enabled.
При значении true:
• ЛКМ показывает содержимое кейса.
• ПКМ открывает кейс.
При значении false:
• ЛКМ сразу открывает кейс.
• ПКМ сразу открывает кейс.
• Переключатель просмотра содержимого доступен в Machine.
Настраиваемая история и разметка слотов
• Пустой элемент истории настраивается отдельно для каждого кейса через gui.history.empty.
• Старое поле gui.history.empty-item автоматически переносится в новую секцию.
• Иконку пустой истории можно изменить предметом с курсора в Machine.
• Разметка меню позволяет назначать слоты для:
• Основной кнопки.
• Выбора анимации.
• Истории.
• Декора.
• Пустого пространства.
• Обязательные роли при переносе корректно меняются местами и больше не создают дубликаты.
• Если выбор анимации отключён и слот 49 освобождён, его автоматически занимает история.
• При повторном включении пользовательского выбора слот возвращается кнопке анимации.
• Исправлен пустой 50-й слот в стандартной разметке нового кейса.
Редкости и предпросмотр наград
Добавлены редкости:
• COMMON.
• UNCOMMON.
• RARE.
• EPIC.
• LEGENDARY.
• MYTHIC.
• Название, цвет, символ и свечение каждой редкости настраиваются в:
gui.yml → preview.rarities
• Цвет и символ объединены в одном поле name.
Пример:
&d✹ Мифическая
• В заголовке создаваемого кейса перечислены все допустимые ID редкостей.
• Предпросмотр показывает реальную вероятность выпадения без технического веса.
• Из публичного lore убраны внутренний тип награды, команды и служебные пояснения.
• Кнопка «Содержимое кейса» получила отдельную Base64-иконку.
• Кнопка получила короткое RGB-название без лишнего lore.
• Стрелки страниц полностью скрываются, если все награды помещаются на одной странице.
• Для нескольких страниц используются отдельные Base64-кнопки:
• Назад.
• Вперёд.
• Недоступное направление.
Персональные сообщения и broadcast
• Сообщение об успешной выдаче задаётся непосредственно в конкретной награде через rewards[].message.
• Из messages.yml удалены общие успешные сообщения:
• reward.default.
• reward.luckperms.
• reward.vault.
• reward.playerpoints.
• Если message у награды отсутствует, лишнее сообщение игроку не отправляется.
• Системные ошибки провайдеров и неверных предметов по-прежнему настраиваются в messages.yml.
• Broadcast перенесён из общего messages.yml в каждый файл кейса.
• Для каждого кейса broadcast можно отдельно включить или выключить через broadcast.enabled.
• Строки broadcast задаются в broadcast.lines.
Поддерживаемые плейсхолдеры:
• {player}.
• {case}.
• {case_id}.
• {reward}.
Тип награды PERSONAL
• Добавлен тип награды PERSONAL.
• PERSONAL выполняет персональную консольную команду.
В командах доступны плейсхолдеры:
• {player}.
• {uuid}.
• Команда сохраняется вместе с отложенной наградой в SQLite, MySQL и MongoDB.
• Для JDBC-хранилищ добавлена автоматическая миграция поля command.
• В комплект добавлен файл cases/test.yml.
В нём находятся примеры наград:
• ITEM.
• VAULT.
• PLAYERPOINTS.
• LUCKPERMS.
• PERSONAL.
• Кастомные Base64-головы.
АНИМАЦИИ ОТКРЫТИЯ
Новые анимации
Дыхание дракона
Крупный дракон из частиц облетает кейс, снижается и выдыхает пламя, из которого появляется награда.
Голодный мимик
Сундук оживает, проглатывает ложные награды и выдаёт выигранную.
• Обе новые анимации отмечены меткой NEW в меню выбора.
• Полностью удалена старая анимация CAULDRON — «Астральный разлом».
Новая архитектура анимаций
• Современные реализации для Minecraft 1.21+ перенесены в animation/main.
• Совместимые реализации перенесены в animation/legacy.
• Для Minecraft 1.16.5 принудительно используется совместимый «Круг фортуны».
• Для Minecraft 1.17–1.20 используется отдельный совместимый режим без загрузки классов Display Entities.
• Все открытия работают через единый жизненный цикл AnimationRun.
• Контекст открытия централизованно отслеживает:
• Задачи.
• Временные сущности.
• Listener-ы.
• Изменённые блоки.
Единая очистка выполняется при:
• Успешном завершении.
• Ошибке запуска.
• Выходе игрока.
• Выгрузке мира.
• Выключении плагина.
• Добавлен watchdog, который завершает зависшее открытие и не оставляет кейс заблокированным.
• Звуки анимаций перенесены в код.
• Громкость звуков приведена к единому безопасному диапазону.
Единое отображение награды
• Все современные анимации используют единый визуальный предмет и подпись награды.
• Убран отдельный title с названием награды по центру экрана.
• Название награды остаётся над вращающимся предметом и следует за ним до завершения.
• Исправлены лишние и зависшие TextDisplay, которые появлялись под блоком кейса.
• Для отображения используется настоящий визуальный предмет награды.
• Поддерживается отображение Base64-голов.
• Количество частиц в момент выпадения уменьшено.
• Предмет и его название больше не перекрываются финальным эффектом.
Защита сцены
• Пока идёт анимация, посторонние игроки мягко отталкиваются от кейса в радиусе 5 блоков.
• Открывающий игрок удерживается за пределами радиуса 3 блоков.
• Защита отключается сразу после завершения или отмены открытия.
ПОЛНОСТЬЮ НОВАЯ ВИТРИНА КЕЙСА
Старые стили заменены полноценными темами витрины.
Доступные темы:
• Арканный ритуал.
• Разлом пустоты.
• Штормовая клетка.
• Огненный феникс.
• Ядовитая кобра.
• Ледяная корона.
• Плач душ.
• Зов левиафана.
• Небесные крылья.
• Драконья орбита.
• Каждая тема получила собственный силуэт, движение, траекторию и цветовую композицию.
• Феникс, левиафан и дракон перемещаются вокруг кейса.
• Небесные крылья получили анимацию взмахов.
• Статичным сценам сохранена устойчивая композиция.
• Витрина больше не создаёт предмет или сундук над блоком.
• Отображается только выбранная анимация частиц.
• Оставлена одна кнопка включения витрины.
• Оставлена одна кнопка выбора темы.
• Дублирующий переключатель эффектов удалён.
• После изменения в Machine обновляется только витрина выбранного кейса, а не все кейсы сервера.
• Старые служебные display-сущности витрин очищаются при загрузке и выключении плагина.
НОВЫЙ MACHINE И ДИЗАЙН GUI
• Machine полностью перестроен на отдельные понятные экраны:
• Основные настройки.
• Меню кейса.
• Анимация.
• Голограмма.
• Витрина.
• Покупка за опыт.
• Разметка.
• Удалён лишний экран «Быстрые настройки».
• Повторяющиеся иконки заменены уникальными Base64-текстурами.
• Кнопки «Вернуться» и «Выйти» используют единую красную Base64-иконку без лишнего lore.
• Основные кнопки получили собственные Base64-иконки.
• Категории получили собственные Base64-иконки.
• Анимации получили собственные Base64-иконки.
• Темы витрины получили собственные Base64-иконки.
• Системные действия получили собственные Base64-иконки.
• Заголовки Machine и меню выбора анимации используют чёрный цвет &0.
• Пользовательские заголовки самих кейсов остаются настраиваемыми.
• Lore Machine приведён к единому RGB-дизайну.
Используются разделы:
• Основная информация.
• Текущие параметры.
• Действие.
• Плейсхолдеры голограммы отображаются в Machine уже подставленными.
• Вместо буквального текста {display-name} показывается настоящее название кейса.
• В gui.yml оставлены только изменяемые пользовательские тексты, lore предпросмотра и оформление редкостей.
• Слоты, навигация, системные иконки, звуки и дизайн Machine теперь находятся в коде.
Выбор анимаций
• Анимации разделены на две категории:
• Обычные.
• С мобами.
• Разделы доступны игрокам и администраторам в Machine.
• Категории и кнопка возврата используют Base64-головы.
• Убраны служебные строки о категории, технических эффектах и внутреннем способе отображения.
• Каждая анимация получила RGB-название.
• Каждая анимация получила собственную иконку.
• Каждая анимация получила понятное визуальное описание.
• Выбор игрока хранится отдельно для каждого сочетания «игрок + кейс».
• Исправлена ошибка, из-за которой разные кейсы использовали одну общую выбранную анимацию.
Плавное и безопасное обновление GUI
• Сервисы анимации открытия и обновления слотов вынесены в общую библиотеку pnLibrary.
• Эти сервисы можно повторно использовать в других плагинах.
• GUI появляется от центра к краям.
• Поддерживаемые сервером заголовки раскрываются плавно.
• Быстрое закрытие и повторное открытие больше не оставляет инвентарь частично пустым.
• Незавершённая сессия сначала восстанавливает все предметы.
• Отложенное обновление проверяет, что у игрока всё ещё открыт нужный инвентарь.
• При изменении настройки обновляются только действительно изменившиеся слоты.
• При наличии ProtocolLib дополнительно отправляется отдельный пакет SET_SLOT.
• При отправке отслеживаются containerId и stateId.
• Bukkit-инвентарь остаётся основным состоянием.
• Без ProtocolLib используется безопасное штатное обновление.
• Убраны мигание и повторное раскрытие всего меню.
• Убрано одновременное обновление соседних Base64-кнопок.
ИСПРАВЛЕНИЯ
Отложенные награды и хранение
• Pending-награда записывается до запуска анимации.
• Pending-награда больше не может быть перезаписана другим открытием.
• Исправлена блокировка следующего открытия сообщением о необходимости сначала получить отложенную награду.
• Активная анимация не позволяет обработчику входа преждевременно выдать её pending-награду.
• При ошибке сохранения стоимость безопасно возвращается, если отсутствие записи подтверждено.
• Если состояние хранилища определить нельзя, открытие останавливается без повторной выдачи.
• Старая однозначно определяемая PERSONAL-награда без сохранённой команды может быть восстановлена из актуальной конфигурации.
• Настройки выбранной анимации сохраняются по ID кейса в SQLite, MySQL и MongoDB.
Кейсы, шаблоны и голограммы
• При применении настроек кейса обновляются не только награды, но и связанные визуальные параметры.
• После изменения конкретного кейса обновляются только его голограмма и витрина.
• Остальные кейсы не пересоздаются.
• Исправлено сохранение нового display-name во всех меню и подсказках команд.
• Исправлено удаление кейса.
• Исправлена очистка ключа удалённого кейса.
• Исправлено обновление списка загруженных кейсов.
• Конфликтующие привязки блоков обнаруживаются до применения новой конфигурации.
• При ошибке YAML старые рабочие кейсы остаются активными вместо частичной перезагрузки.
• FancyHolograms и DecentHolograms используют единый жизненный цикл.
• Добавлен безопасный выбор провайдера AUTO.
Команды и сообщения
• Панель /pncases получила отдельный блок состояния.
В нём отображаются:
• Версия плагина.
• Поддерживаемые серверы.
• Информация об обновлении.
• Discord.
• Информация отображается без скрытого hover.
• Команды в панели стали интерактивными.
• Нажатие подставляет выбранную команду в строку чата.
• Из YAML удалена большая статическая служебная секция command-menu.
• Исполнитель команд и автодополнение объединены в одном классе.
• Автодополнение показывает только существующие кейсы и реально используемые ключи.
• Из messages.yml удалён неиспользуемый параметр primary.
• config.yml сокращён до настроек базы данных, провайдера голограмм и символов наград.
• Удалён неиспользуемый параметр case-files.auto-export.
pnCases 1.5.1
Полностью переработанная система кейсов с самостоятельными конфигурациями, новыми анимациями, витринами и обновлённым Machine.
Поддержка и обновления