CrazyCrates — плагин для добавления кастомных кейсов и сундуков с наградами в Minecraft

CrazyCrates — плагин для добавления кастомных кейсов и сундуков с наградами в Minecraft

CrazyCrates позволяет добавлять на сервер Minecraft крейты. Каждый крейт — это блок в мире или позиция в меню, которую игрок открывает ключом и получает случайный приз. Плагин предоставляет 11 различных типов анимаций, два вида ключей — физические (предметы в инвентаре) и виртуальные (хранятся в базе данных) — и систему весовых шансов вместо процентной. Распространяется бесплатно. 

Главное меню /crates с крейтами в виде предметов в инвентаре 

Типы крейтов 

Каждый крейт на сервере — это отдельный .yml-файл в папке crates/. В файле есть параметр CrateType, который определяет анимацию открытия.

При первом запуске плагин генерирует 6 готовых примеров, которые охватывают 5 подтвержденных типов. Открыть любой из них для теста без ключа можно командой /crazycrates forceopen <имя_файла> <ник>.

Все доступные базовые крейты 

Прокрутка - в инвентаре появляется горизонтальная лента предметов, которая прокручивается, постепенно замедляется и останавливается на выигрышном предмете посередине. Этот тип используют два примера — CrateExample.yml и AdvancedExample.yml.

Выполнение CrateExample — горизонтальная лента предметов прокручивается и останавливается на выигрышном

Cosmic — в инвентаре появляется несколько призов на выбор. Игрок кликает на тот, который хочет забрать. Если за 10 секунд ничего не выбрать, плагин выдает один приз автоматически. Casino — крейт с уровнями (tiers). Сначала анимация определяет уровень, затем внутри него — конкретный приз. 

QuadCrate — при открытии четыре физических блока-крейта спавнятся вокруг игрока в мире. Игрок подходит к каждому и открывает по очереди — каждый дает отдельный приз. 

Wonder — появляется окно с полным инвентарем из которого постепенно пропадают предметы, тот который останется и будет призом

Ключи

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

По умолчанию физический блок-крейт принимает оба типа. Поведение можно изменить в config.yml отдельно для каждой комбинации.

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

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

Физический ключ от крейта — предмет с кастомным описанием

Система шансов 

Вероятность каждого приза определяется не процентами, а весом — параметром Weight в файле крейта. Чем выше значение веса, тем чаще выпадает приз; чем ниже — тем реже.

Максимальный диапазон — это сумма всех в крейте. Если три приза имеют веса 10, 15 и 25, диапазон равен 50. Шанс первого — 20%, второго — 30%, третьего — 50%.

Преимущество такого подхода перед процентами: не нужно следить, чтобы сумма не превышала 100. Можно просто выставлять относительные значения и добавлять новые призы без перерасчета остальных.

Команды

Основная команда плагина — /crazycrates, с аналогами /crates и /cc. Игрокам доступны только /keys (просмотреть свои ключи) и /crates (открыть меню).

Админские команды:

• /crazycrates give и /crazycrates take — выдать или забрать ключ у конкретного игрока, в том числе офлайн.

• /crazycrates giveall — раздать ключ всем онлайн-игрокам одновременно.

• /crazycrates forceopen — открыть крейт для игрока бесплатно, без ключа.

• /crazycrates editor — режим размещения крейтов в мире: указываешь на блок и привязываешь к нему крейт.

• /crazycrates debug — получить все призы крейта сразу, чтобы проверить настройки.

• /crazycrates mass-open — массовое открытие указанного количества крейтов за раз.

• /crazycrates reload — перезапустить все конфигурации без рестарта сервера.

• /crazycrates migrate — импорт крейтов из других плагинов или конвертация устаревшего формата файлов.

Разрешения разбиты на три вайлдкарда: crazycrates.players.* для игроков, crazycrates.admin.* для админов, crazycrates.schematic.* для работы со схематиками. Игрока можно исключить из массовой раздачи /giveall через отдельное разрешение.

Настройки

Все файлы плагина находятся в папке plugins/CrazyCrates/. Главный — config.yml, где сосредоточены глобальные настройки сервера. Крейты хранятся в подпапке crates/ — каждый отдельным файлом. Папка examples/ содержит примеры от разработчиков, но редактировать их не стоит: она полностью перезаписывается при каждом /crazycrates reload. Все тексты сообщений вынесены в messages.yml и редактируются отдельно.

В config.yml стоит обратить внимание на несколько вещей. Голограммы над крейтами появляются автоматически, если на сервере установлен DecentHolograms, FancyHolograms или CMI — плагин сам их подхватит. Если ни одного нет, голограмм просто не будет. Сообщения игрокам можно направлять либо в чат, либо в action bar — в зависимости от того как устроен сервер. Логирование действий с ключами и крейтами включается отдельно для консоли и для файла; файловые логи архивируются в zip при перезапуске.

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

Вывод

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

Для PvP- и выживание-серверов с донат-системой CrazyCrates — удобный выбор. Для простого сервера, где нужен один крейт без анимаций, хватит QuickCrate и минимальной конфигурации.