DonateCase - Донат-кейсы для сервера

DonateCase - это плагин для серверов Minecraft, который добавляет систему донат-кейсов. Если вы держите свой проект и хотите монетизировать его без костылей из кучи разных плагинов, это как раз тот случай. Игрок покупает или получает ключ, подходит к кейсу, смотрит красивую анимацию открытия и забирает приз. Всё просто и понятно даже новичкам.

По факту, кейсы давно стали стандартом для выживаний, анархий, гриферских и мини-игровых серверов. Они дают игрокам понятную цель - накопить ключи и испытать удачу, а админу - рабочий инструмент для доната, ивентов и наград за активность. Скачать DonateCase стоит хотя бы ради того, чтобы не собирать эту механику из командных блоков и скриптов.

Что умеет плагин

Функционал тут довольно широкий, и это не просто "открыл сундук - получил предмет":

• Оптимизированный код - плагин не будет грузить сервер даже при большом онлайне
• Выдача любых призов - предметы, команды, валюта, права, что угодно
• Полная локализация - переводите все сообщения под свой сервер
• Полная кастомизация кейсов - создавайте свои кейсы с нуля с любым содержимым
• Настройка GUI - меню открытия и просмотра кейсов можно изменить полностью
• Красивые анимации открытия с тонкой настройкой
• История открытий - видно, кто, когда и что выбил

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

Совместимость и интеграции

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

• MySQL - хранение данных в базе, удобно для сетей серверов
• Vault - экономика и права
• LuckPerms - выдача прав через призы
• PlayerHeads, Custom Heads, HeadDataBase - кастомные головы в призах и GUI
• ItemsAdder - кастомные предметы из этого плагина можно класть в кейсы
• PlaceholderAPI - плейсхолдеры для таба, скорборда и голограмм
• CMI - интеграция с популярным многофункциональным плагином
• HolographicDisplays, DecentHolograms, FancyHolograms - голограммы над кейсами
• PacketEvents - работа с пакетами для анимаций

То есть если у вас уже стоит стандартный набор вроде LuckPerms, Vault и PlaceholderAPI, DonateCase встанет без проблем и подхватит всё сам.

Команды плагина

Управление кейсами происходит через команды /dc. Вот основные:

• /dc help - помощь по плагину
• /dc keys (игрок) - показать количество ключей
• /dc cases - список всех кейсов
• /dc opencase (тип кейса) - открыть кейс
• /dc create (тип) (название) - создать кейс (нужно смотреть на блок)
• /dc delete (название) - удалить кейс (смотря на него)
• /dc givekey (игрок) (кейс) (количество) - выдать ключи игроку
• /dc setkey (игрок) (кейс) (количество) - установить количество ключей
• /dc delkey (игрок) (кейс) - убрать все ключи у игрока
• /dc delkey all - удалить все ключи у всех игроков
• /dc reload - перезагрузить конфиг
• /dc reload cache - перезагрузить кэш
• /dc addons - список загруженных аддонов
• /dc addon (enable/disable | load/unload) - управление аддонами
• /dc registry (animations|actions|materials) - список зарегистрированных анимаций, действий и материалов

Создание кейса через взгляд на блок - удобная штука. Просто ставите сундук или другой блок в спавне, смотрите на него и вводите команду. Никаких координат в конфиге вручную.

Права (permissions)

Разграничение доступа сделано грамотно, на три уровня:

• donatecase.player - для обычных игроков (/dc help, /dc keys, /dc opencase)
• donatecase.mod - для модераторов (/dc keys (игрок), /dc givekey/setkey/delkey)
• donatecase.admin - полный доступ ко всем командам

Советую сразу прописать эти права в LuckPerms и не давать админку модераторам - так безопаснее, особенно на проектах с большим составом персонала.

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

Для вывода статистики в таб, скорборд, голограммы или меню есть готовые плейсхолдеры:

• %donatecase_keys_<casename>% - количество ключей от конкретного кейса
• %donatecase_keys_<casename>_format% - то же самое, но в форматированном виде
• %donatecase_keys% - общее количество ключей от всех кейсов
• %donatecase_keys_format% - общее количество ключей с форматированием
• %donatecase_open_count% - сколько всего кейсов открыто на сервере
• %donatecase_open_count_format% - то же с форматированием
• %donatecase_open_count_<casename>% - количество открытий конкретного кейса
• %donatecase_open_count_<casename>_format% - то же с форматированием
• %donatecase_history_<casetype>_<index>_<value>% - данные из истории открытий конкретного кейса

Форматированные варианты удобны тем, что большие числа выводятся красиво, например 1.5K вместо 1500. Для топа в голограмме - самое то.

Аддоны для DonateCase

Экосистема аддонов - одна из главных фишек плагина. Вот что можно подключить:

• FreeCases - игроки получают бесплатные ключи, например раз в сутки. Отличный способ вернуть онлайн
• DCEventManager - управление ивентами, связанными с кейсами
• DCPhysicalKey - физические ключи в виде предметов, которые можно передавать и продавать
• DCWebHook - уведомления об открытиях кейсов через вебхуки в Discord
• FriendCase - игроки могут дарить ключи друзьям
• DCPrizePreview - предпросмотр призов кейса до открытия
• DCBlockAnimations - дополнительные анимации открытия
• DCHistoryEditor - редактирование истории открытий

По опыту, FreeCases и DCPrizePreview - почти обязательный минимум. Первый держит ежедневный онлайн, второй снимает кучу вопросов от игроков вроде "а что вообще может выпасть".

Кому подойдёт DonateCase

Если коротко - любому серверу, где есть донат или система наград. Выживание, анархия, мини-игры, RPG-проекты. Плагин одинаково хорошо работает и как магазин привилегий через кейсы, и как развлекательная механика для ивентов.

Важный момент: для полноценной работы вам понадобится хостинг серверов Майнкрафт с нормальной производительностью и доступом к MySQL, если планируете сеть серверов. На BungeeHost (https://bungee.host) плагин установится в один клик, а арендовать сервер Майнкрафт там можно буквально за пару минут - удобно, если хотите быстро запустить проект с донат-кейсами и не возиться с настройкой железа. Создать сервер Майнкрафт с DonateCase на таком хостинге - дело получаса вместе с настройкой первого кейса.

Ну и классика: перед запуском в прод обязательно протестируйте призы на тестовом аккаунте. Особенно если в кейсе команды или выдача прав через LuckPerms - одна опечатка в конфиге, и игрок получит не то, что ожидал. Скачать плагин DonateCase и настроить под себя несложно, но внимательность при редактировании конфигов никто не отменял.