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

Мы разрабатываем механику Battle Pass как один из самых технически объёмных элементов монетизации. В одном из проектов по мобильной RPG с 500 тыс. DAU мы внедрили Battle Pass с пятиуровневой прогрессией. Первая версия привела к тому, что 30% игроков прошли его за первую неделю, что потребовало пересчёта XP кривой. На основе этого опыта мы выработали архитектуру, которая повторно используема и масштабируется.

Наша реализация охватывает не просто список наград — это сезонная система с прогрессией, двумя треками, таймером, покупкой через IAP и синхронизацией прогресса между устройствами. Мы гарантируем стабильную работу даже при высоких нагрузках и предоставляем полную документацию.

Как сбалансировать прогрессию Battle Pass?

Один из ключевых вопросов — выбор между flat и scaling XP. 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.

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

Модель 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"
}

Как интегрировать IAP для Battle Pass?

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

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

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

На 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:
        break
    case .userCancelled:
        break
}

Механика Battle Pass описана в Wikipedia, но наша реализация включает ряд дополнительных фич.

Когда использовать подписку вместо разовой покупки?

Разовая покупка на сезон подходит для классической модели. Подписка с автореньем увеличивает LTV в 2 раза по сравнению с разовой покупкой, но требует тщательной реализации: необходимо грамотно обрабатывать отмены, возобновления и возвраты. Наш опыт показывает, что подписка даёт более предсказуемый доход.

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 дней), запускается следующий сезон автоматически. Данные предыдущих сезонов храним для истории в профиле.

Что входит в работу

В процессе реализации мы предоставляем:

• Полную серверную документацию по API
• Код клиентской интеграции на Swift и Kotlin
• Инструкцию по настройке IAP в консолях App Store и Google Play
• 30-дневную поддержку после релиза

Сроки и этапы

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

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