BattlePass - боевой пропуск на вашем сервере Майнкрафт

BattlePass - это плагин, который переносит в Minecraft механику боевого пропуска, знакомую всем по Fortnite, Dota 2 и другим живым сервисным играм. Игроки выполняют квесты, получают опыт, повышают уровень пропуска и забирают награды. Проект сделан под серверы Paper и Spigot 1.21+ (вплоть до 1.21.11) и требует Java 21 или новее.

Зачем это вообще нужно админу? Ответ простой - удержание аудитории. Классическая боль владельца сервера Майнкрафт: игрок заходит, неделю активно играет, закрывает все ванильные цели и пропадает насовсем. Сезонный пропуск ломает этот цикл. У человека всегда есть причина зайти снова: докачать тир, закрыть дейли, забрать награду в конце ветки. А премиум-трек - это еще и готовый инструмент монетизации, который мягко подталкивает к донату без всякого давления. Короче, система прогрессии и удержания в одном флаконе.

Отдельный плюс: игрокам ничего устанавливать не нужно. BattlePass - полностью серверный плагин, весь интерфейс построен на стандартных GUI-меню, так что зайти можно хоть с чистого ванильного клиента.

Основные возможности

Что вы получаете из коробки после установки:

• Система прогрессии на 50 тиров - полноценный сезонный пропуск с настраиваемой длительностью и кастомным названием сезона
• Две ветки наград - FREE-награды доступны всем игрокам, PREMIUM-трек только для владельцев платного пропуска
• Квестовая система - больше 12 типов заданий: добыча блоков, крафт, PvP, рыбалка, торговля с жителями и многое другое
• Интерактивные GUI - аккуратные и понятные меню как для игроков, так и для админов
• Управление сезонами - легкая ротация сезонов, можно задавать имя вроде "Сезон 1 - Зима 2024" и менять сроки

По факту это закрывает сразу два запроса: чем занять игроков на дистанции и как организовать сезонный контент без программиста в штате.

Инструменты для администратора

Вот где BattlePass реально приятно удивляет. Большинство подобных плагинов заставляют править конфиги руками, а тут есть внутриигровой редактор:

• Редактор тиров прямо в игре - настраивайте награды через GUI, не открывая конфиги вообще
• Добавление предметов из руки - берете предмет в руку, и он со всем NBT (чары, лор, атрибуты) уходит в награду. Поддерживаются ванильные предметы, а также кастомные из Oraxen и ItemsAdder
• Управление игроками - выдача опыта, установка тира, выдача и снятие премиум-доступа парой команд
• Мониторинг производительности - встроенная статистика кэша и индикаторы здоровья плагина
• Live-перезагрузка - правки конфига применяются через /bpadmin reload без рестарта сервера

Совет из практики: функция добавления предметов из руки экономит кучу времени. Не надо вспоминать айди предмета из ItemsAdder или ковырять NBT-теги - просто держите нужную штуку в руке и добавляйте её в награду через редактор. С кастомными мечами и ресурсами из Oraxen это работает без сбоев, NBT сохраняется полностью.

Производительность

Плагины прогрессии часто грешат одним: постоянные записи на диск убивают TPS. Тут разработчики подошли к вопросу серьезно:

• Асинхронная система сохранения - записи не блокируют основной поток, никаких просадок TPS
• LRU-кэш - эффективное управление памятью, рассчитан на 500+ игроков
• Пакетная обработка - снижает дисковые операции примерно на 90% по сравнению с мгновенными сохранениями
• Рейт-лимитинг - защита от спама и абуза механик
• Корректное завершение работы - данные не потеряются при рестарте сервера

Заявленные цифры тоже приличные: плагин спокойно держит 200+ одновременных игроков, время выдачи награды меньше 1 мс, а автосохранения вообще не бьют по TPS. Для экономического или мини-игрового проекта этого запаса хватит с головой.

Гибкая система наград

Что можно положить в награду за тир:

• Предметы - ванильные и кастомные, с полным сохранением NBT (чары, лор, атрибуты)
• Команды - выполнение любой консольной команды при получении награды
• Деньги - выдача валюты через Vault (понадобится сам Vault и любой экономический плагин вроде EssentialsX)

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

Разнообразие квестов

Типов заданий хватает, чтобы сезон не превратился в рутину:

Ломать/ставить блоки     Убивать мобов/игроков    Крафтить предметы
Рыбачить                 Зачаровывать предметы    Разводить животных
Торговать с жителями     Повторяемые квесты       Кастомные задания

Повторяемые квесты - вообще must-have для долгих сезонов: игроки могут гриндить опыт без потолка, а вы спокойно балансите экономику сезона.

Установка

1. Скачайте свежий .jar файл плагина
2. Закиньте его в папку plugins вашего сервера
3. Перезапустите сервер
4. Настройте config.yml, quests.yml и rewards.yml под себя
5. Примените изменения командой /bpadmin reload

Если только поднимаете сервер для друзей или своего комьюнити, BattlePass отлично заработает на BungeeHost (https://bungee.host) - устанавливается в один клик, Java 21 и Paper уже есть из коробки, так что танцы с настройкой окружения не понадобятся.

Команды

Команды игроков

• /bp или /battlepass - открыть GUI боевого пропуска
• /bp quests - посмотреть активные квесты
• /bp info - ваша статистика

Команды администратора

• /bpadmin reload - перезагрузить все конфиги
• /bpadmin setexp <игрок> <количество> - установить опыт игрока
• /bpadmin settier <игрок> <тир> - установить уровень пропуска
• /bpadmin givepremium <игрок> - выдать премиум-пропуск
• /bpadmin removepremium <игрок> - забрать премиум-пропуск
• /bpadmin editor [тир] - открыть GUI-редактор тиров
• /bpadmin stats - статистика кэша и производительности
• /bpadmin forcesave - принудительное сохранение всех изменённых данных

Права

• battlepass.use - доступ к боевому пропуску (по умолчанию: у всех)
• battlepass.admin - админские команды (по умолчанию: op)
• battlepass.premium - доступ к премиум-наградам (по умолчанию: выключено)

Важный нюанс: если вы как-то наткнётесь на первую версию 1.0, знайте - в ней был баг с выдачей премиум-наград через право battlepass.premium, плюс криво отображались цветовые коды в заголовке интерфейса. Оба косяка исправлены в обновлении 1.0.1, так что качайте именно свежую сборку, чтобы не ловить жалобы от донатеров на "не пришла награда".

Конфигурация

Настройка ведётся через три файла:

• config.yml - параметры сезона, требования к опыту, все сообщения плагина
• quests.yml - определения квестов, награды за них и требования
• rewards.yml - награды за тиры, предметы, команды

Пример настройки сезона:

season:
  name: "Season 1 - Winter 2024"
  max-tier: 50
  exp-per-tier: 1000

Совместимость

Параметр	Требование
Версия Minecraft	1.21+ (заявлена поддержка вплоть до 1.21.11)
Ядро сервера	Paper (рекомендуется), Spigot
Версия Java	21+
Опциональные зависимости	Oraxen, ItemsAdder, Vault

Vault нужен не обязательно, но без него вы потеряете денежные награды - а это один из самых простых способов мотивировать игроков на экономических серверах. Oraxen и ItemsAdder тоже опциональны: без них плагин работает на ванильных предметах, просто кастомные штуки добавить не получится.

Стоит ли ставить BattlePass

Если держите выживание, гриферский или экономический сервер и хотите, чтобы игроки возвращались дольше одной недели - однозначно ставьте. БатлПасс даёт готовую сезонную RPG-прогрессию без программирования: квесты, уровни, две ветки наград, GUI-редактор и нормальная оптимизация под онлайн в 200+ человек. Донатеры получают красивый премиум-трек, фритуплейщики - бесплатные награды и причину зайти завтра.

Скачайте плагин BattlePass, настройте первый сезон за вечер и смотрите, как растёт онлайн. На хостинге BungeeHost плагин ставится буквально в один клик - останется только придумать название сезона.