Battlepass (Батлпасс, TheFroggy)

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

Возможности

• Для сезона задаются название, количество уровней и кривая опыта; завершённые сезоны сохраняются в истории.
• Наградами могут быть предметы с именем, описанием, зачарованиями и собственной моделью, обычный опыт, опыт пропуска, деньги через Vault, права и команды консоли. На одном уровне можно выдать несколько наград.
• Есть ежедневные, еженедельные и сезонные задания: убийства мобов, добыча и сбор ресурсов, крафт, переплавка, рыбалка, путешествия, посещение биомов, получение опыта и достижения.
• Опыт пропуска начисляется за убийства, добычу, фермерство, рыбалку, разведение животных, переплавку, крафт и исследование мира. Для каждого действия настраиваются награды и дневные лимиты.
• Блоки, поставленные игроками, мобы из спавнеров и яиц призыва, предметы других игроков, мгновенно разрушаемые блоки, обратимые рецепты, АФК и полёт не учитываются.
• Меню показывает прогресс, задания, статистику и доступные награды. При полном инвентаре предметы можно отправить в хранилище наград, выбросить или не выдавать.
• Уведомления в чате, надписи, заголовки, звуки и частицы настраиваются.
• Данные хранятся в SQLite, MySQL или MariaDB.

Команды

• /battlepass или /bp — открыть боевой пропуск.
• /bp quests, /bp stats, /bp claimall — задания, статистика и получение всех наград.
• /bpa startseason <id>, /bpa endseason — управление сезонами.
• /bpa givexp, /bpa setlevel, /bpa reset, /bpa premium, /bpa info — управление игроками, включая офлайн-игроков.
• /bpa reload — перезагрузить конфиги.

Права

Административные команды используют права с префиксом battlepass.admin.*.

Настройка

Сезоны и уровни настраиваются в seasons.yml, а задания — в quests.yml. Все сообщения можно изменить; поддерживаются форматирование MiniMessage и цветовые коды &.

Для вывода данных в другие плагины доступны плейсхолдеры PlaceholderAPI: %battlepass_level%, %battlepass_xp%, %battlepass_xp_required%, %battlepass_progress%, %battlepass_season%, %battlepass_premium%, %battlepass_quests_completed%, %battlepass_claimable%.

Требования

Нужен сервер Paper или его форк, например Purpur. PlaceholderAPI и Vault подключаются при необходимости; Vault требуется для денежных наград и наград-прав.