pnCases - Плагин на кейсы 1.21.x 2026-07-02

Поддержка 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:
Было исправлено то, что если перезапустить плагин, а игрок открыл кейс, то награды не было.