Реализация Battle Pass механики мобильной игры

Реализация Battle Pass механики мобильной игры

Battle Pass — один из самых технически объёмных элементов монетизации. Это не просто «показать список наград» — это сезонная система с прогрессией, двумя треками, таймером, покупкой через IAP и синхронизацией прогресса между устройствами.

Архитектура данных

Модель Battle Pass на сервере включает минимум три сущности:

Season — текущий сезон с датами start/end, список уровней (50–100) с наградами для free- и premium-трека.

PlayerSeasonProgress — прогресс конкретного игрока: текущий уровень, накопленный XP, флаг isPremium, список claimedRewards.

SeasonXPTransaction — лог начислений XP: источник (level_complete, daily_quest, mission), количество, timestamp. Нужен для аудита и anti-cheat.

struct BattlePassLevel: Codable {
    let level: Int
    let xpRequired: Int
    let freeReward: Reward?
    let premiumReward: Reward?
}

struct PlayerSeasonProgress: Codable {
    let seasonId: String
    let currentLevel: Int
    let currentXP: Int
    let isPremium: Bool
    let claimedRewards: [String] // "level_\(n)_free", "level_\(n)_premium"
}

Прогрессия XP и балансировка

Ключевой вопрос: сколько XP нужно на каждый уровень? Flat (одинаково на каждый) или scaling (возрастающая стоимость)?

Flat XP проще реализовать, но создаёт ситуацию, когда хардкор-игрок проходит весь Battle Pass за первую неделю и теряет мотивацию платить. Scaling XP удерживает интерес, но может стать слишком агрессивным.

Хорошо работает linear scaling с plateau: первые 20 уровней дёшево, уровни 21–80 равномерно растут, 81–100 — фиксированная высокая стоимость для «перфекционистов». Casual-игрок без покупки skip-levels доходит до 70–75 уровня к концу сезона — это правильный баланс.

Таблицу XP проектируем в spreadsheet: задаём ожидаемое количество XP за разные активности (прохождение уровня, дейли-квест, ивент) и считаем, сколько дней нужно casual-игроку для прохождения каждого уровня Battle Pass.

IAP: покупка Battle Pass

Battle Pass продаётся как non-consumable или auto-renewable subscription — в зависимости от модели:

• Разовая покупка на сезон (non-consumable) — проще для игрока, легче реализовать
• Подписка с авторенью — стабильный доход, но требует грамотного управления через StoreKit 2 (iOS) или Google Play Billing Library 6+

На iOS с StoreKit 2:

let products = try await Product.products(for: ["battle_pass_season_1"])
guard let battlePass = products.first else { return }
let result = try await battlePass.purchase()
switch result {
case .success(let verification):
    let transaction = try verification.payloadValue
    await transaction.finish()
    await unlockPremiumTrack(for: transaction.id)
case .pending: // ожидает подтверждения (например, Ask to Buy)
    break
case .userCancelled:
    break
}

Важно: валидация транзакции на сервере обязательна для premium-контента. Клиент передаёт transactionId, сервер верифицирует через App Store Server API или Google Play Developer API.

Skip Levels и Gifting

Skip levels (пропуск уровней за твёрдую валюту) — дополнительный источник дохода. Обычно 1 уровень = 100–150 gems, пакет из 10 уровней с небольшой скидкой. Технически: consumable IAP или списание gems из кошелька с серверной верификацией.

Подарить Battle Pass другу — фича, которую запрашивают часто, но реализовывают редко. Требует поддержки Gift Purchase от платформы: iOS поддерживает через StoreKit, Android — частично через Google Play Gifting API (в beta с 2023).

UI Battle Pass

Стандартный UI — горизонтальный скролл с уровнями, текущий уровень по центру, награды выше/ниже для free/premium треков. Кнопка «Получить» активна только для заработанных и не полученных наград.

Ключевые UI-состояния для каждого уровня:

• Locked (ещё не достигнут)
• Earned, not claimed (достигнут, награда не забрана)
• Claimed (забрана)
• Premium locked (только для premium, игрок не купил)

Анимация получения награды — полноэкранная, с партикалами. Это retention-момент: игрок должен чувствовать удовлетворение от прогресса.

Сезонный таймер и окончание сезона

Таймер обратного отсчёта нагнетает urgency. Отображается в главном меню и на экране Battle Pass. За 3 дня до конца — push-уведомление: «До конца сезона 3 дня, тебе осталось X уровней».

По истечении сезона: прогресс архивируется, не полученные награды сгорают (с предупреждением за 7 дней), запускается следующий сезон автоматически. Данные предыдущих сезонов храним для истории в профиле.

Сроки и этапы

1. Серверная модель данных: Season, PlayerProgress, XPLog
2. API endpoints: get season, claim reward, add XP, purchase premium
3. IAP интеграция: StoreKit 2 / Google Play Billing 6
4. Серверная верификация транзакций
5. Клиентская UI: список уровней, получение наград, таймер
6. Push-уведомления за 7/3/1 день до конца сезона
7. Аналитика: events для каждого earned/claimed reward

Базовая реализация (без подписки, без skip levels) — 5 дней. Полная система с подпиской, skip levels, gifting и аналитикой — 2–3 недели.