PrismBattlePass
Custom Battle Pass with tasks, levels, statuses and reward shop
Custom Battle Pass with tasks, levels, statuses and reward shop
PrismBattlePass - это плагин на полноценный боевой пропуск для Minecraft-сервера.
Игроки выполняют ежедневные и еженедельные задания, получают опыт пропуска, повышают уровни, забирают награды и тратят боевой баланс в магазине.
Возможности
- Боевой пропуск через команды /bp и /battlepass
- Ежедневные и еженедельные задания
- Поддержка заданий: прыгать, сдать предметы, сломать блоки, скрафтить предметы
- Прогресс заданий прямо в меню
- Цветовая индикация заданий и прогресса через кожаную броню
- Система уровней боевого пропуска
- Отдельные награды для статусов Обычный, Премиум и Суприм
- Настройка каждой награды каждого уровня отдельно
- Выдача боевого баланса и выполнение команд при получении награды
- Покупка статусов за PlayerPoints
- Боевой магазин с полностью настраиваемыми товарами
- Случайные варианты товаров: кирки, зелья, стрелы и любые другие предметы
- Команды для каждого товара и каждого случайного варианта отдельно
- Поддержка кастомных голов, цветов зелий, зачарованных книг, potion effects и stored enchants
- Полностью настраиваемые меню через YAML
- Настраиваемые стекла, предметы, названия, lore, слоты, цвета и действия
- Поддержка SQLite и MySQL
- Сезонный wipe прогресса уровней, заданий и забранных наград
Задания
Плагин поддерживает ежедневные и еженедельные задания.
Количество активных заданий зависит от статуса игрока.
- Обычный - 3 ежедневных и 3 еженедельных задания
- Премиум - 5 ежедневных и 5 еженедельных заданий
- Суприм - 7 ежедневных и 7 еженедельных заданий
Поддерживаемые типы заданий:
- JUMP - прыгнуть нужное количество раз
- TURN_IN - сдать нужные предметы
- BREAK - сломать нужные блоки
- CRAFT - скрафтить нужные предметы
Задания полностью настраиваются в tasks.yml.
Уровни и награды
Каждый уровень может иметь отдельную награду для каждого статуса:
- normal - обычная награда
- premium - награда Премиум статуса
- supreme - награда Суприм статуса
Для каждой награды можно настроить:
- включена ли награда
- сколько боевого баланса выдать
- что показывать в меню наград
- какие команды выполнить при получении
Все награды настраиваются в levels.yml.
Боевой магазин
Магазин работает через battlepass-shop.yml.
В конфиге можно полностью менять товары, слоты, предметы, цену, название, lore, команды и случайные варианты.
Поддерживаются:
- обычные предметы
- кастомные головы через base64
- зелья и стрелы с цветом и эффектами
- зачарованные книги
- stored enchants
- glint эффект
- give-item режим
- команды при покупке
- случайные варианты товара через variants
Для случайных товаров команды указываются внутри каждого варианта отдельно.
Например, случайная кирка или случайное зелье могут иметь разные команды для каждого выпавшего варианта.
Команды
| Команда | Описание | Право |
|---|---|---|
| /bp | Открыть главное меню боевого пропуска | - |
| /battlepass | Алиас команды /bp | - |
| /prismbp addexp <ник> <кол-во> | Выдать опыт боевого пропуска | prismbattlepass.admin |
| /prismbp addbalance <ник> <кол-во> | Выдать боевой баланс | prismbattlepass.admin |
| /prismbp status <ник> <default/premium/supreme> <31d> | Изменить статус игроку | prismbattlepass.admin |
| /prismbp wipe | Сезонный сброс прогресса, требуется ввести два раза | prismbattlepass.admin |
| /prismbp reload | Перезагрузить конфиги плагина | prismbattlepass.admin |
| /prismbp info <ник> | Посмотреть информацию о боевом пропуске игрока | prismbattlepass.admin |
Права
Код:
prismbattlepass.adminprismbattlepass.admin - доступ к админским командам /prismbp.
Конфиги
- config.yml - основные настройки, бренд меню, цены статусов, лимиты уровней
- messages.yml - все сообщения плагина
- sql.yml - настройка SQLite/MySQL
- tasks.yml - пул ежедневных и еженедельных заданий
- levels.yml - награды каждого уровня и каждого статуса
- battlepass-shop.yml - товары боевого магазина
- menu/main.yml - главное меню
- menu/status.yml - меню статусов
- menu/tasks/main.yml - меню выбора заданий
- menu/tasks/daily.yml - меню ежедневных заданий
- menu/tasks/weekly.yml - меню еженедельных заданий
- menu/levels/main.yml - меню уровней
- menu/levels/rewards.yml - меню получения наград уровня
- menu/shop/main.yml - меню магазина
- menu/shop/confirm.yml - подтверждение покупки товара
Хранилище
Плагин поддерживает два типа хранения:
- SQLite - для одного сервера, используется по умолчанию
- MySQL - для сетей и проектов, где нужна внешняя база данных
Настройки находятся в sql.yml.
PlayerPoints
PlayerPoints является обязательной зависимостью.
Через PlayerPoints игроки покупают статусы Премиум и Суприм.
WorldGuard
WorldGuard является необязательной зависимостью.
Если WorldGuard установлен, плагин может учитывать ограничения регионов для отдельных действий, где это предусмотрено настройками.
Совместимость
- Minecraft: 1.16.5+
- Java: 8+
- Сервер: Spigot / Paper
- Зависимость: PlayerPoints
- Softdepend: WorldGuard
Установка
- Поместите PrismBattlePass.jar в папку plugins.
- Убедитесь, что на сервере установлен PlayerPoints.
- Перезапустите сервер.
- Настройте файлы config.yml, messages.yml, sql.yml, tasks.yml, levels.yml и battlepass-shop.yml.
- Настройте меню в папке menu.
- Выдайте администраторам право prismbattlepass.admin.
- Используйте /prismbp reload после изменения конфигов.
Автор
PrismDeveloper
PrismBattlePass - гибкий боевой пропуск с заданиями, уровнями, статусами и магазином под экономику вашего сервера.
