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

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​

pnCases 1.4.4

Небольшой hotfix после версии 1.4.3​

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

Версия 1.4.4 исправляет работу элементов истории в GUI и добавляет полноценную настройку нижних подсказок на кнопке кейса.

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

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

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

• Исправлено удаление истории в разметке GUI.

• Если в Machine GUI удалить все слоты истории, часы больше не возвращаются после обновления меню.

• Удалённые слоты истории не восстанавливаются после команды:

Код:

/pncases reload

• Слоты истории также не возвращаются после полного перезапуска сервера.

• Пустой список:

YAML:

history:
  slots: []

теперь считается корректной настройкой.

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

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

Настройка подсказок GUI

Нижний блок подсказок на кнопке кейса теперь полностью настраивается через файл:

Код:

plugins/pnCases/messages.yml

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

• строку с количеством ключей;

• подсказку для левой кнопки мыши;

• подсказку для правой кнопки мыши;

• подсказку для средней кнопки мыши;

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

• пустые разделительные строки;

• любой дополнительный текст.

Чтобы полностью отключить нижний блок подсказок, используйте:

YAML:

gui:
  case-button:
    extra-lore: []

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

Новые плейсхолдеры

В подсказках GUI теперь доступны следующие плейсхолдеры:

Код:

{have}

Количество ключей, которое сейчас есть у игрока.

Код:

{need}

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

Код:

{levels}

Стоимость покупки ключа в уровнях опыта.

Код:

{key}

Внутренний ID используемого ключа.

Код:

{key_name}

Красивое название ключа.

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

Код:

{key-name}

Код:

{material}

Материал кнопки кейса.

Код:

{keys-balance}

Готовая строка с текущим балансом и требуемым количеством ключей.

Код:

{left-click}

Подсказка с действием левой кнопки мыши.

Код:

{right-click}

Подсказка с действием правой кнопки мыши.

Код:

{middle-click}

Подсказка с действием средней кнопки мыши.

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

Сообщение при отсутствии ключей

Описание временного barrier-предмета, который появляется при попытке открыть кейс без ключей, теперь также настраивается через messages.yml.

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

• заголовок ошибки;

• строку с балансом ключей;

• дополнительную подсказку;

• порядок строк;

• оформление и цвета текста.

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

Пример настройки

YAML:

gui:
  open:
    no-keys-lore:
      - "&cНедостаточно ключей"
      - "{keys-balance}"
      - "&7Получите ключ и попробуйте снова."

  case-button:
    extra-lore:
      - ""
      - "{keys-balance}"
      - ""
      - "{left-click}"
      - "{right-click}"
      - "{middle-click}"

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

Пример без нижних подсказок

Чтобы убрать с кнопки кейса строки с балансом ключей и действиями мыши, укажите пустой список:

YAML:

gui:
  case-button:
    extra-lore: []

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

Совместимость со старыми настройками

Старые файлы messages.yml продолжают поддерживаться.

При запуске pnCases автоматически добавит отсутствующие параметры для новых подсказок GUI.

При этом:

• уже изменённые администратором строки не перезаписываются;

• пользовательские переводы сохраняются;

• старое оформление сообщений не сбрасывается;

• добавляются только отсутствующие настройки.

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

Обновление

1. Остановите сервер.

2. Замените старый JAR-файл на pnCases 1.4.4.

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

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

Код:

plugins/pnCases/messages.yml

5. При необходимости измените блоки no-keys-lore и extra-lore.

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

Что нового​

• Добавлено меню настройки кейса через /pncases machine.
• В machine-меню появились разделы: анимация, голограмма, внешний вид меню, покупка ключа за опыт и разметка слотов.
• Многие настройки теперь можно менять прямо в игре, без ручного копания в config.yml.
• Добавлена настройка разметки меню кейса: декор, кнопка открытия, история, кнопка анимации и другие элементы.
• Добавлена настройка покупки ключа за опыт: можно включать, отключать и менять цену.
• Добавлена новая анимация открытия: Круг фортуны.
• Один и тот же кейс теперь можно поставить на несколько блоков командой /pncases setcase <кейс>.
• Примеры кейсов вынесены в отдельные файлы plugins/pnCases/cases/.
• Добавлены готовые примеры кейсов для денег, PlayerPoints, предметов и LuckPerms.

Улучшено​

• /pncases setcase <кейс> теперь добавляет новый блок к кейсу, а не заменяет старый.
• /pncases delcase <кейс> оставлен как одна понятная команда для удаления блоков кейса.
• Лишние варианты команд удаления убраны, чтобы не было путаницы.
• Содержимое кейса теперь удобнее открывать через основную кнопку кейса.
• Если покупка ключа за опыт отключена, игрок видит подсказку для просмотра содержимого, а не текст про отключенную покупку.
• Если у игрока нет ключей, в меню теперь нормально написано Недостаточно ключей.
• Старые настройки кейсов читаются аккуратнее.
• Поддерживается старый формат block: и новый формат blocks:.

Исправлено​

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