ExcellentCrates Virtual Key Placeholder

ExcellentCrates Virtual Key Placeholder - это небольшой плагин-расширение для популярного плагина ExcellentCrates, который решает одну конкретную, но раздражающую проблему на серверах с кейсами. Если вы держите экономику и награды на ExcellentCrates, то наверняка сталкивались с тем, что показать игроку точное количество его ключей определенного типа в интерфейсе было целой задачей.

Зачем это нужно

ExcellentCrates - плагин для кейсов (сундуков с наградами), и на многих серверах ключи выдаются за голосование, за квесты, за донат или за события. При этом ключи бывают двух видов: виртуальные (хранятся в данных игрока, а не как предмет) и физические (лежат в инвентаре как предмет). Раньше нельзя было просто вывести, сколько у игрока виртуальных ключей конкретного типа - не было подходящего плейсхолдера. Этот расширенный плагин как раз добавляет такую возможность. Забудьте про костыли со скриптами и задержками при обновлении значений.

Плейсхолдеры

• %ec_keyz_<keyID>% - показывает количество виртуальных ключей указанного типа у игрока. Пример: %ec_keyz_virtualvote% вернет только виртуальные Vote Keys того игрока, для которого парсится плейсхолдер. Возвращает простое число.
• %ec_physicalkeyz_<keyID>% - добавлен в версии 2.1. Работает аналогично, но считает только физические ключи, которые лежат в инвентаре игрока.

То есть теперь можно одним взглядом в скорборде или на NPC-HUD отличить, сколько у человека виртуальных голосовательных ключей, а сколько физических, не путая их между собой. Раньше это приходилось делать вручную через проверки инвентаря, что на больших серверах давало лишнюю нагрузку.

Требования и совместимость

Плагин работает на серверах Bukkit, Paper, Purpur и Spigot. Актуальная версия - v1.0, лицензия MIT. На Modrinth указана поддержка Minecraft Java Edition 1.21.8-1.21.11.

Для работы обязательно нужны:

• ExcellentCrates - сам плагин кейсов, для которого это расширение;
• PlaceholderAPI - без него плейсхолдеры просто не будут парситься.

Сам ExcellentCrates использует библиотеку nightcore, а для голограмм могут понадобиться PacketEvents или ProtocolLib. Это стоит держать в голове, если вы настраиваете кейсы вместе с данным расширением.

Практический совет

Плейсхолдеры отлично заходят в TAB, FeatherBoard, DeluxeMenus и любые другие интерфейсы с поддержкой PlaceholderAPI. Например, в меню магазина ключей можно вывести %ec_physicalkeyz_vote% рядом с иконкой предмета, чтобы игрок сразу видел, сколько физических ключей у него в инвентаре. А в скорборде - %ec_keyz_virtualvote%, чтобы отслеживать виртуальный баланс. Это одна из тех мелочей, которая сильно улучшает UX на сервере с экономикой.

Если вы держите сервер на BungeeHost, оба плагина ставятся за пару минут через панель, и все зависимости вроде PlaceholderAPI подхватываются без возни с FTP. Игрокам ничего дополнительно качать не нужно - это чисто серверная утилита.

Важно знать

• Не пытайтесь использовать %ec_keyz_<keyID>% для физических ключей - он покажет только виртуальные. Для инвентаря есть отдельный %ec_physicalkeyz_<keyID>%.
• Проверьте, что ID ключей в плейсхолдере совпадает с настройками в ExcellentCrates, иначе вернется 0 или пустота.
• Плейсхолдер возвращает число, так что его удобно использовать в условиях (greater than, less than) внутри DeluxeMenus или в плагинах квестов.
• Плагин узконаправленный: если вы не используете ExcellentCrates, он вам не нужен. Но если используете - это фактически must-have для нормального отображения ключей в интерфейсах.