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

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

Исправлено​

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

Версия 1.4.2 — исправление ошибок после релизов 1.4 и 1.4.1.

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

- Кейсы больше не слетают после перезапуска сервера, если в config.yml указан мир, которого сейчас нет на сервере.
- Если block.world не найден, кейс всё равно загружается: настройки, награды, GUI и tab-complete остаются доступными.
- Отсутствующий мир теперь выводится как предупреждение, а не критическая ошибка config.yml.
- Голограммы безопасно пропускают кейсы без активного блока.

- Добавлена команда /pncases delcase <кейс>, чтобы убрать привязку кейса к блоку без удаления настроек.
- Добавлены алиасы удаления: /pncases deletecase, /pncases removecase, /pncases unsetcase.
- Исправлен tab-complete для команд удаления кейса.

- Исправлены старые анимации Наковальня, Динамит и Портал.
- Теперь в анимации, голограмме, истории и сообщении в чате показывается именно та награда, которая реально выпадает игроку.
- Исправлена проблема, когда в анимации мог показываться один донат, а после открытия выдавалась другая награда.

- Preview наград теперь может брать правильный предмет из animation.items для старых конфигов без visual.
- История открытий теперь старается показывать иконку самой награды, а не одинаковую книгу.
- У LuckPerms-наград из preview убраны технические строки group и node.
- Если у LuckPerms-награды нет своего имени, но найден visual-предмет, используется имя этого предмета. Если visual нет, показывается название “Привилегия”.

Что было исправлено в 1.4.1:

- Исправлена логика Vault-наград.
- Исправлена логика PlayerPoints-наград.
- Vault и PlayerPoints больше не используют display_name из настроек виртуальной валюты.
- Для отображения денежных и поинтовых наград используется только visual.
- Игроку больше не выдается visual-предмет вместо валюты.
- Если награда является Vault, игрок получает деньги.
- Если награда является PlayerPoints, игрок получает поинты.
- GUI, preview и анимации продолжают показывать красивый visual-предмет, но выдача остается чисто валютной.

Важно:
если в config.yml указан несуществующий мир, сам блок кейса не может быть активным. Настройки кейса не пропадут, но блок нужно перепривязать командой /pncases setcase <кейс>.

pnCases 1.4

Версия 1.4 - большое обновление pnCases: новый preview наград, поддержка валютных наград, SQLite-хранилище, улучшенные голограммы и новая анимация открытия.

Что нового:
- Новая анимация открытия: Астральный разлом.
- Preview наград в GUI: игрок видит все возможные награды, шансы и редкость.
- Награды через Vault и PlayerPoints.
- Редкости наград: COMMON, UNCOMMON, RARE, EPIC, LEGENDARY, MYTHIC.
- SQLite-хранилище data.db вместо keys.yml, player_prefs.yml, open_history.yml и pending_rewards.yml.
- Автоматическая миграция старых YAML-данных в SQLite.
- Поддержка FancyHolograms, DecentHolograms и TextDisplay fallback.
- Исправлен visual: для VAULT / PlayerPoints / LuckPerms, чтобы визуальный предмет не выдавался вместо валюты или прав.
- Улучшена валидация старых конфигов.
- Анимации стали тише и плавнее.

Скачать:

Загрузка...

github.com

Полный changelog:

Загрузка...

github.com

После замены JAR перезапустите сервер. Старые YAML-файлы данных pnCases будут перенесены в SQLite автоматически.

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

Что нового​

• Вернули выбор анимации открытия: Наковальня, Динамит, Портал и Отравление.
• Добавили красивое GUI-меню выбора анимации с отдельными звуками.
• Добавили историю последних открытий прямо в GUI кейса.
• Исправили отображение награды в анимациях: у каждой награды может быть свой base64.
• Улучшили broadcast после открытия кейса.
• Добавили нормальные уведомления об обновлениях с кликабельной ссылкой на скачивание.
• Добавили fallback-голограммы через Minecraft TextDisplay, если FancyHolograms недоступен.
• Добавили настройку направления слайма для анимации Отравление.

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

Вот сама анимация

https://youtu.be/0rvhgx-rbWQ
Видео ролик про изменения

Анимации:
Портал -> Чёрная дыра. Новая анимация. (Можно ознакомиться на видео)


Команды:
/pncases takekey <игрок> <ключ> <кол-во> - Можно забирать кейсы у игрока.


hotfix:
Было исправлено то, что если перезапустить плагин, а игрок открыл кейс, то награды не было.