pnCases - Плагин на кейсы 1.16.x - 1.21.x. 1.5.3

Версия 1.5.3 обновляет анимации открытия, интерфейсы настройки, голограммы наград, хранение данных и работу конфигураций.

Обновление рассчитано на переход с 1.5.2 без повторного создания кейсов и наград.

Добавлено

• Новая анимация «Грозовая дуэль». Два вооружённых бойца появляются во время грозы, сходятся у кейса, обмениваются атаками и завершают бой электрическим столкновением.
  
• Новая анимация «Искажение времени». Часовщик прокручивает разрушение кейса назад, сталкивается со своей будущей версией и стирает произошедшее из времени. После окончания сцены награда появляется отдельно, без закрывающих её частиц.
  
• Обе новые анимации отмечены тегом NEW в меню выбора.
  
• Добавлена поддержка Redis в качестве хранилища наряду с SQLite, MySQL и MongoDB.
  
• Добавлена автоматическая синхронизация
  Код:

  config.yml

  ,
  Код:

  gui.yml

  ,
  Код:

  messages.yml

  и файлов
  Код:

  cases/*.yml

  при запуске и перезагрузке плагина.
  
• Добавлена локализация названий предметов, блоков, зачарований и зелий через pnLibrary.
  
• Добавлена настройка голограммы выпавшей награды:
  • масштаб;
  • высота;
  • дальность отображения;
  • яркость;
  • задержка появления;
  • плавность перемещения.

Анимации

• Полные современные анимации используются на Minecraft 1.20.x и 1.21.x с одинаковыми сценариями и визуальным оформлением.
  
• Все анимации получили собственные названия и описания в меню выбора.
  
• Обычные и мобовые анимации объединены в один список без отдельных разделов.
  
• «Круг фортуны» прокручивает предметы наград текущего кейса, постепенно замедляется и останавливается на выбранной награде. При большом количестве элементов размер предметов автоматически уменьшается.
  
• В «Отравлении» восстановлено последовательное отображение ударов.
  
• В «Дыхании дракона» восстановлен финальный выдох по кейсу.
  
• Для запуска и завершения сцен используется общий жизненный цикл. Созданные сущности, временно скрытые блоки и задачи автоматически очищаются после завершения анимации или возникновения ошибки.
  
• При аварии визуальной части выбранная награда всё равно безопасно выдаётся игроку.
  
• Удалена отдельная команда и реализация
  Код:

  previewanimation

  , дублировавшая основную систему.

Исправлено

• Исправлена ошибка
  Код:

  IncompatibleClassChangeError

  при работе с
  Код:

  InventoryView

  на новых сборках Paper и Purpur.
  
• Исправлено аварийное завершение «Грозовой дуэли» на Paper 1.21.4 при экипировке ArmorStand.
  
• Исправлены рывки и рассинхронизация предмета с текстом награды в финальных сценах.
  
• Увеличена читаемость названия выпавшей награды.
  
• Исправлена обработка RGB, RGBA и legacy-цветов в GUI, названиях кейсов и сообщениях, включая последний цвет
  Код:

  &f

  в префиксе.
  
• Исправлено применение
  Код:

  idle-particles.radius

  . Параметр теперь масштабирует всю фигуру витрины.
  
• Значение
  Код:

  idle-particles.interval_ticks: 2

  больше не заменяется принудительно более медленным интервалом.
  
• Исправлена повторная обработка ожидающей награды. До подтверждения удаления записи из хранилища повторное открытие и повторная выдача игроку блокируются.

Голограммы

• Названия наград отображаются через FancyHolograms или DecentHolograms.
  
• Удалён встроенный fallback на
  Код:

  TextDisplay

  .
  
• Для работы pnCases требуется один установленный провайдер голограмм:
  • FancyHolograms;
  • DecentHolograms.
• Логика постоянных голограмм кейсов и временного текста анимаций разделена. Обновление одной голограммы больше не затрагивает остальные.

GUI и настройка кейсов

• Переработаны экраны:
  • сведений о кейсе;
  • наград;
  • анимаций;
  • меню игроков;
  • голограммы;
  • витрины;
  • покупки ключей;
  • редактора раскладки.
• Карточки настроек приведены к единой схеме: название, краткое описание, текущее значение и понятные действия ЛКМ/ПКМ.
  
• Обновление слотов и анимации открытия GUI выполняются через ProtocolLib.
  
• В редакторе наград показывается нормализованный фактический шанс выпадения вместо технического значения веса.
  
• Редкости перенесены в основной
  Код:

  config.yml

  и используют формат
  Код:

  rarity.<id>

  .
  
• Для предпросмотра награды используется один шаблон
  Код:

  lore

  . Отдельный
  Код:

  type-lore

  удалён.
  
• Удалён глобальный символ награды. Оформление теперь задаётся названием и визуальным предметом самой награды.
  
• Удалена система модулей. Редкости и предпросмотр включаются напрямую через:
  • Код:

    features.rarity

  • Код:

    features.preview

• GUI-анимация и заголовок открытия всегда являются частью интерфейса и больше не требуют отдельных переключателей.
  
• Из
  Код:

  plugin.yml

  удалено неиспользуемое поле
  Код:

  usage

  команды.

Конфигурации

• Новые параметры автоматически добавляются в существующие YAML-файлы.
  
• Устаревшие стандартные параметры удаляются автоматически.
  
• Изменённые владельцем значения не заменяются стандартными.
  
• Сохраняются пользовательские награды, привязанные блоки и раскладка меню кейса.
  
• Перед заменой файл проверяется через повторное чтение. При ошибке рабочая конфигурация остаётся без изменений.
  
• Ручное удаление конфигураций или повторная настройка кейсов при переходе с 1.5.2 не требуются.

pnLibrary и данные

• Запуск плагина, bStats и проверка обновлений переведены на общий
  Код:

  PluginRuntime

  pnLibrary.
  
• Выбор SQLite, MySQL, MongoDB или Redis выполняется через
  Код:

  DatabaseRouter

  pnLibrary.
  
• Vault и PlayerPoints подключаются через общую экономическую систему pnLibrary.
  
• Через хранилище сохраняются:
  • ключи;
  • история открытий;
  • выбранные игроками анимации;
  • ожидающие выдачи награды.
• Удалены локальные копии общих утилит предметов, визуальных сущностей, экономики и локализации.

pnCases 1.5.2

Полноценная настройка кейсов через Machine​

────────────────────────────────────

Обновление 1.5.2

Главное изменение версии — полноценная настройка кейсов через Machine.

Награды, внешний вид меню, модули и основные параметры кейсов теперь можно изменять через удобный GUI без ручного редактирования YAML.

────────────────────────────────────

Добавлено

GUI-редактор наград

В Machine появился полноценный редактор наград.

Через GUI можно создавать:

• Предметы
• Монеты Vault
• Поинты PlayerPoints
• Привилегии LuckPerms
• Отдельные права
• Командные награды

Для каждой награды можно настроить:

• Название
• Иконку
• Содержимое
• Шанс выпадения
• Редкость
• Положение в списке

Отдельное отображение наград

Добавлена отдельная настройка отображения награды в анимации и истории.

Для командной награды теперь можно задать понятное название и использовать в качестве иконки:

• Любой Minecraft-предмет
• Base64-голову

AnvilGUI

Добавлен удобный ввод значений через AnvilGUI.

Через него можно изменять:

• Названия
• Суммы
• Команды
• Привилегии
• Права
• Другие текстовые и числовые значения

Редактировать YAML вручную для этих параметров больше не требуется.

Редактор меню кейса

Через GUI теперь можно полностью настраивать разметку меню кейса.

Можно назначить:

• Слот открытия кейса
• Слот истории
• Слоты анимации
• Декоративные слоты
• Собственные предметы для элементов меню

Система модулей

Через Machine или

Код:

config.yml

можно отдельно включать и отключать:

• Редкости
• Просмотр наград
• GUI-анимацию
• Анимацию заголовка

────────────────────────────────────

Изменено

Machine

Настройка кейса в Machine полностью переработана.

Параметры теперь разделены на отдельные понятные категории, чтобы нужную настройку было проще найти.

Виртуальные ключи

Отдельная секция

Код:

keys

удалена.

Теперь каждый созданный кейс автоматически получает собственный виртуальный ключ.

Список наград

Список наград получил новый интерфейс:

• Новый дизайн
• Понятные подписи
• Тематические иконки
• Отдельное подтверждение удаления награды

Порядок наград теперь изменяется через наглядный список позиций.

Название меню

Название меню кейса теперь изменяется через AnvilGUI.

Очистка конфигурации

Файлы:

Код:

config.yml
gui.yml
messages.yml

очищены от устаревших и неиспользуемых настроек.

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

Редкости

В

Код:

gui.yml

оставлен единый плейсхолдер:

Код:

{rarity}

Он сразу содержит:

• Цвет
• Символ
• Название редкости

Команда /pncases

Справка стала компактнее и чище.

Удалены:

• Неработающие клики
• Лишние сообщения об обновлении
• Технический текст, ненужный обычному пользователю

────────────────────────────────────

Исправлено

Плейсхолдеры редкости

Исправлено отображение редкостей.

Теперь корректно отображаются:

• Цвет
• Символ
• Название

Информация о сервере

Исправлено отображение версии сервера в административной информации команды:

Код:

/pncases

────────────────────────────────────

Поддержка и обновления

Если у вас возникли вопросы, вы нашли ошибку или хотите предложить новую функцию — обращайтесь на наш Discord-сервер.

Первые новости об обновлениях, исправлениях и новых версиях появляются именно в Discord.

Присоединиться к Discord-серверу
​

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.​

Обновление pnCases 1.5.0

Вышло новое обновление плагина.
Посмотреть список изменений и скачать актуальную версию можно здесь:

Смотреть обновление pnCases 1.5.0

pnCases 1.4.9

Гибкая настройка наград, собственные редкости и обновлённая архитектура​

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Версия 1.4.9 расширяет возможности оформления кейсов и наград.

Основное внимание уделено окну «Содержимое кейса», настройке редкостей и отображению разных типов наград.

Теперь внешний вид меню можно полностью адаптировать под стиль вашего сервера: изменить расположение элементов, оформление наград, навигацию, декор, звуки и информационные строки.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Скачать pnCases 1.4.9

Скачать pnCases-1.4.9.jar

Открыть полный список изменений на GitHub​

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Настраиваемое окно «Содержимое кейса»

Окно предпросмотра наград стало полностью настраиваемым.

В файле:

Код:

plugins/pnCases/gui.yml

можно изменить:

• размер меню;

• слоты для отображения наград;

• количество наград на одной странице;

• декоративные предметы;

• информационную кнопку;

• кнопки перехода между страницами;

• расположение элементов;

• названия и описания кнопок;

• звуки открытия и переключения страниц.

Теперь интерфейс содержимого кейса можно оформить в едином стиле с остальными меню сервера.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Настройка отображения наград

Для предметов в списке наград теперь можно отдельно настроить:

• отображаемое название;

• дополнительное описание;

• показ исходного lore предмета;

• свечение;

• Custom Model Data;

• порядок информационных строк;

• отображение шанса;

• отображение редкости;

• оформление типа награды.

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

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Собственные редкости

Система редкостей больше не ограничена только стандартными вариантами.

Теперь можно создавать собственные редкости и настраивать для каждой:

• внутренний ID;

• отображаемое название;

• цвет;

• символ;

• описание;

• отдельную иконку;

• Custom Model Data;

• свечение предмета.

Например, можно добавить собственные варианты:

Код:

ANCIENT
DONATE
EVENT
SEASONAL
EXCLUSIVE

Это позволяет оформить редкости под тематику, экономику и визуальный стиль конкретного сервера.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Оформление разных типов наград

Для каждого типа награды можно отдельно настроить отображаемую информацию.

Поддерживается отдельное оформление для:

• обычных предметов;

• денежных наград Vault;

• поинтов PlayerPoints;

• групп и прав LuckPerms;

• наград-команд.

Например, для денежной награды можно показать сумму и символ валюты, для LuckPerms — название привилегии, а для команды — отдельное понятное описание вместо технической команды.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Упрощённый выбор анимации

Настройка анимации открытия теперь занимает одну кнопку в Machine GUI.

ЛКМ — выбрать следующую доступную анимацию.

ПКМ — вернуться к предыдущей анимации.

Это делает переключение режимов быстрее и убирает лишние элементы из меню настройки.

На Minecraft 1.16.5 автоматически остаётся доступна совместимая анимация:

Код:

Круг фортуны

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

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Переработанная внутренняя структура

Внутренняя архитектура pnCases была полностью перестроена.

Основные системы теперь разделены на самостоятельные модули:

• загрузка и управление кейсами;

• обработка наград;

• интерфейсы и GUI;

• анимации;

• голограммы;

• хранилище данных;

• система обновлений;

• интеграции с другими плагинами.

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

Для администратора структура конфигураций и основные команды остаются привычными.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Совместимость

Поддерживаемые серверы:

• Paper 1.16.5–1.21.11;

• Purpur 1.16.5–1.21.11.

Требуемая версия Java:

• Java 17 или новее.

Опциональные интеграции:

• LuckPerms — группы и права;

• Vault — денежные награды;

• PlayerPoints — награды в поинтах;

• FancyHolograms — голограммы;

• DecentHolograms — голограммы.

Дополнительные плагины подключаются только для соответствующих возможностей. Без них основная система кейсов продолжает работать.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Установка обновления

1. Скачайте файл:

Код:

pnCases-1.4.9.jar

2. Полностью остановите сервер.

3. Замените старый JAR-файл в папке:

Код:

plugins/

4. Запустите сервер.

5. Проверьте новые параметры в файле:

Код:

plugins/pnCases/gui.yml

Пользовательские настройки, кейсы и данные игроков сохраняются.

Новые параметры gui.yml добавляются автоматически с безопасными значениями по умолчанию.

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

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

pnCases 1.4.9

Paper / Purpur 1.16.5–1.21.11

Настраиваемые GUI • Собственные редкости • Machine GUI • MiniMessage • SQLite​

pnCases 1.4.8

Поддержка 1.16.5 • MiniMessage • Новая анимация • Расширенная настройка​

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

pnCases 1.4.8 расширяет поддержку старых версий Minecraft и добавляет новые возможности для настройки кейсов.

Теперь плагин работает на Paper и Purpur начиная с версии 1.16.5, поддерживает MiniMessage во всех YAML-файлах и позволяет изменять оформление интерфейса через отдельный gui.yml.

Для Minecraft 1.21+ также добавлена новая анимация открытия — «Осада разбойников».

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Скачать pnCases 1.4.8

Скачать pnCases-1.4.8.jar​

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Что нового в версии 1.4.8

• Добавлена поддержка Paper и Purpur 1.16.5.

• Добавлена поддержка MiniMessage во всех YAML-настройках плагина:

Код:

config.yml
messages.yml
gui.yml
cases/*.yml

• В текстах можно использовать сразу несколько форматов цветов:

Код:

&aОбычный цвет
&#42A5F5 RGB-цвет
<red>Красный текст
<bold>Жирный текст
<gradient:#42A5F5:#AB47BC>Градиентный текст</gradient>

• Старые цветовые коды через & продолжают работать.

• Добавлена новая анимация открытия «Осада разбойников» для Minecraft 1.21+.

• Добавлен отдельный файл gui.yml для настройки интерфейсов.

• Расширено административное меню Machine GUI.

• Добавлена команда создания нового кейса:

Код:

/pncases createcase <id>

• Добавлен короткий алиас основной команды:

Код:

/cases

• Один кейс можно устанавливать сразу в нескольких местах.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Новая анимация — Осада разбойников

Для серверов Minecraft 1.21+ добавлена новая анимация открытия кейса.

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

Анимация использует современные возможности Minecraft 1.21 и доступна только в полном режиме pnCases.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Поддержка MiniMessage

MiniMessage теперь работает во всех основных YAML-файлах pnCases.

Можно использовать:

• стандартные Minecraft-цвета через &;

• RGB-цвета;

• жирный, курсивный и подчёркнутый текст;

• градиенты;

• другие поддерживаемые теги MiniMessage.

Пример:

YAML:

name: "<gradient:#42A5F5:#AB47BC><bold>Мифический кейс</bold></gradient>"
lore:
  - "&7Нажмите, чтобы открыть"
  - "&#42A5F5Редкая награда"
  - "<red>Требуется ключ</red>"

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

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Отдельный gui.yml

Настройки интерфейсов вынесены в отдельный файл:

Код:

plugins/pnCases/gui.yml

В нём можно изменять:

• названия меню;

• названия кнопок;

• описание предметов;

• подсказки игрокам;

• декоративные предметы;

• материалы элементов;

• расположение кнопок;

• общее оформление GUI.

Это позволяет менять внешний вид меню без редактирования основной конфигурации плагина.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Расширенная Machine GUI

Меню настройки кейсов прямо в игре стало функциональнее.

Через Machine GUI можно настраивать:

• анимацию открытия;

• голограмму;

• частицы;

• вращающуюся витрину;

• предмет витрины;

• покупку ключей за опыт;

• расположение элементов меню;

• декоративные предметы;

• кнопки истории и предпросмотра.

Открыть меню настройки:

Код:

/pncases machine <кейс>

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Создание нового кейса

Добавлена команда:

Код:

/pncases createcase <id>

Она создаёт новый кейс с указанным идентификатором и базовыми настройками.

Пример:

Код:

/pncases createcase donate

После создания кейс можно настроить через его YAML-файл или открыть Machine GUI:

Код:

/pncases machine donate

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Несколько блоков одного кейса

Один и тот же кейс можно установить сразу в нескольких местах.

Для добавления нового блока используйте:

Код:

/pncases setcase <кейс>

Пример:

Код:

/pncases setcase donate

Повторное выполнение команды добавляет ещё один блок и не заменяет уже установленные кейсы.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Совместимость версий

Paper и Purpur 1.16.5

Плагин и основная система кейсов работают в совместимом режиме.

Доступна анимация:

Код:

Круг фортуны

Современные Display-анимации и меню их выбора на этой версии не используются.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Paper и Purpur 1.17–1.20

Используется совместимый режим анимаций без современных Display-сущностей.

Основные функции сохраняются:

• открытие кейсов;

• выдача наград;

• система ключей;

• история открытий;

• Vault;

• PlayerPoints;

• LuckPerms;

• настройка кейсов.

Визуальные эффекты могут быть проще, чем на Minecraft 1.21.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Paper и Purpur 1.21–1.21.11

Доступен полный режим pnCases:

• современные анимации;

• Display-сущности;

• вращающаяся витрина;

• расширенные частицы;

• полный выбор анимаций;

• анимация «Осада разбойников».

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Установка

1. Скачайте файл pnCases-1.4.8.jar.

2. Полностью остановите сервер.

3. Поместите JAR-файл в папку:

Код:

plugins/

4. Запустите сервер.

5. Настройте основные файлы:

Код:

plugins/pnCases/config.yml
plugins/pnCases/messages.yml
plugins/pnCases/gui.yml

6. Настройте кейсы в папке:

Код:

plugins/pnCases/cases/

Для обновления не рекомендуется использовать PlugMan и другие средства горячей перезагрузки. После замены JAR выполните полный перезапуск сервера.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

pnCases 1.4.8

Paper / Purpur 1.16.5–1.21.11

MiniMessage • Machine GUI • SQLite • Vault • PlayerPoints • LuckPerms​

pnCases 1.4.7

Скрытая выдача ключей через команду​

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Версия 1.4.7 добавляет небольшое, но полезное улучшение для команды выдачи ключей.

Теперь ключи можно выдавать скрытно — без сообщения игроку в чат. Это удобно для автоматической выдачи после покупки на сайте, через RCON, консоль или другую внешнюю систему.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Что нового

• В команду выдачи ключей добавлен необязательный флаг скрытой выдачи:

Код:

/pncases givekey <игрок> <ключ> <количество> -s

• Также доступен полный вариант флага:

Код:

/pncases givekey <игрок> <ключ> <количество> -silent

• Если указан флаг -s или -silent, игрок не получает сообщение о выдаче ключа в чат.

• Ключ всё равно корректно добавляется на баланс игрока.

• Администратор, консоль или система, которая выполнила команду, по-прежнему получает подтверждение о выдаче.

• Флаг скрытой выдачи добавлен в автодополнение команды.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Пример использования

Код:

/pncases givekey Evgeniy51234 donate_key 1 -s

В этом примере игрок Evgeniy51234 получит один ключ donate_key, но не увидит уведомление в чате.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Когда это полезно

Скрытая выдача удобна для автоматических систем:

• выдача ключей после доната на сайте;

• выдача через RCON;

• выдача через консоль;

• интеграция с магазином;

• выдача бонусов без лишних сообщений в чат;

• массовая или техническая выдача ключей администрацией.

Игрок получает ключ на баланс как обычно, но чат при этом не засоряется лишними уведомлениями.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Скачать pnCases 1.4.7

Скачать pnCases-1.4.7.jar

После замены JAR-файла рекомендуется полностью перезапустить сервер.

pnCases 1.4.6 — GlobalVersion

Один JAR для Paper и Purpur 1.19–1.21.11​

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

pnCases 1.4.6 — обновление глобальной совместимости.

Теперь один и тот же JAR-файл можно использовать на серверах Paper и Purpur от 1.19 до 1.21.11.

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

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Поддерживаемые версии

• Paper 1.19–1.21.11

• Purpur 1.19–1.21.11

• Java 17

• Java 21

Для запуска требуется Minecraft 1.19 или новее.

Если сервер работает на версии ниже 1.19, pnCases автоматически отключится и выведет понятную причину в консоль.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Что нового

• Добавлена полноценная поддержка Paper и Purpur 1.19–1.21.11.

• Один JAR теперь работает на всех поддерживаемых версиях.

• Сборка переведена на Java 17, благодаря чему pnCases запускается на серверах 1.19 и 1.20.

• Поддержка Java 21 полностью сохранена.

• Версия API плагина изменена на:

Код:

api-version: 1.19

• Старые серверы больше не воспринимают pnCases как плагин только для Minecraft 1.21.

• Добавлена автоматическая проверка версии сервера при запуске.

• Добавлен отдельный совместимый режим анимаций для Minecraft 1.19 и 1.20.

• Новые API Minecraft 1.21 больше не вызывают ошибки на старых версиях.

• Витрина над кейсом адаптирована для работы на разных версиях сервера.

• Команда /pncases теперь показывает единое информационное меню.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Режим работы на Minecraft 1.21+

На версиях Minecraft 1.21 и новее используются основные возможности pnCases:

• полноценные анимации открытия;

• современные визуальные эффекты;

• Display Entity;

• новые частицы;

• вращающаяся витрина над кейсом;

• расширенные эффекты подсветки.

Визуальная часть работает без ограничений.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Режим работы на Minecraft 1.19–1.20

На версиях 1.19 и 1.20 автоматически включается совместимый режим.

В этом режиме:

• кейсы стабильно открываются;

• ключи корректно списываются;

• награды правильно выдаются;

• Vault продолжает работать;

• PlayerPoints продолжает работать;

• LuckPerms продолжает работать;

• история открытий сохраняется;

• настройки игроков сохраняются;

• команды администратора остаются доступными.

Некоторые визуальные эффекты могут выглядеть проще, чем на Minecraft 1.21, поскольку старые версии не поддерживают новые Display и Particle API.

Основная функциональность плагина при этом не ограничивается.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Анимации

pnCases автоматически выбирает подходящую систему анимаций.

На Minecraft 1.21+

Используются полноценные анимации pnCases с современными эффектами.

На Minecraft 1.19–1.20

Используются безопасные совместимые анимации, которые не зависят от новых классов Minecraft 1.21.

Новые анимации больше не загружаются на версиях, где отсутствуют необходимые API.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Витрина над кейсом

Витрина над кейсом стала безопаснее для разных версий Minecraft.

• На поддерживаемых версиях используется подходящий способ отображения предмета.

• Плагин больше не зависит напрямую от ItemDisplay на старых версиях.

• Несовместимые эффекты автоматически заменяются безопасными вариантами.

• При открытии кейса витрина корректно скрывается.

• После завершения анимации витрина появляется обратно.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Голограммы

pnCases поддерживает:

• FancyHolograms;

• DecentHolograms.

Если один из этих плагинов установлен, pnCases использует его для отображения голограмм над кейсами.

Если плагины голограмм отсутствуют, pnCases продолжит работать без ошибок. Кейсы, ключи, награды и анимации останутся доступными, но текст над блоком отображаться не будет.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Обновлённая команда /pncases

Команда:

Код:

/pncases

теперь показывает единое информационное меню.

В нём отображаются:

• установленная версия pnCases;

• версия сервера;

• статус доступного обновления;

• ссылка на поддержку;

• основные команды плагина.

Вся важная информация теперь собрана в одном сообщении.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Технические изменения

• Общая сборка переведена на Java 17 bytecode.

• В plugin.yml установлена версия API 1.19.

• Добавлено автоматическое определение версии Minecraft.

• Добавлен runtime-выбор системы анимаций.

• Анимации 1.21 не загружаются на старых серверах.

• Для материалов добавлены безопасные резервные варианты.

• Для частиц добавлены совместимые варианты.

• Для подсветки добавлены безопасные варианты отображения.

• Основная логика pnCases больше не зависит от новых классов Paper API.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Важно перед обновлением

Для pnCases 1.4.6 требуется сервер версии 1.19 или новее.

Перед установкой рекомендуется:

1. Полностью остановить сервер.

2. Удалить старый JAR-файл pnCases.

3. Поместить pnCases-1.4.6.jar в папку plugins.

4. Запустить сервер.

5. Проверить консоль на наличие предупреждений.

Не используйте PlugMan и другие плагины горячей перезагрузки для обновления pnCases.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Скачать pnCases 1.4.6

Скачать pnCases-1.4.6.jar

После замены JAR-файла полностью перезапустите сервер.

Paper / Purpur 1.19–1.21.11
Java 17 и Java 21​

Что нового

• Добавлена живая витрина над кейсом.

• Над свободным кейсом теперь может плавно парить и вращаться отдельный предмет.

• Предмет витрины можно настроить прямо через команду:

Код:

/pncases machine

• Чтобы изменить предмет витрины, возьмите нужный предмет на курсор и нажмите кнопку «Предмет витрины».

• ПКМ по кнопке «Предмет витрины» без предмета на курсоре возвращает стандартный предмет кнопки кейса.

• Эффекты вокруг витрины теперь включаются отдельно.

• Можно оставить только вращающийся предмет без частиц.

• В примеры кейсов добавлены готовые настройки витрины.


Что исправлено

• Исправлен краш частиц на новых сборках Paper и Purpur 1.21.11.

• Витрина стала спокойнее: уменьшено количество лишних визуальных эффектов и спама частиц.

• При открытии кейса витрина временно скрывается, чтобы не мешать анимации открытия.

• При выполнении команды:

Код:

/pncases reload

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

• При выключении сервера временные предметы витрины также корректно очищаются.

Поддержка pnCases​

Для пользователей pnCases доступен официальный Discord-сервер поддержки.

На сервере можно:

• получить помощь с установкой и настройкой плагина;
• сообщить о найденной ошибке;
• задать вопрос по конфигурации кейсов;
• предложить новую функцию;
• следить за выходом обновлений.

Discord-сервер поддержки:
Присоединиться к Discord

Страница pnCases на GitHub:
github.com/Dy6HiLa/pnCases​