Telegram mini apps: разработка блокчейн-кликера

Клиенту требовался полноценный игровой продукт внутри Telegram — не MVP, а сразу коммерческий запуск с потенциалом масштабирования.

Формат — Telegram Mini App с глубокой игровой механикой, внутренней экономикой и заделом под Web3.

Цели проекта:

• привлечение трафика через Telegram
• удержание пользователей за счёт геймплея
• монетизация через внутриигровую экономику
• подготовка к возможной интеграции токена

На старте:

• отсутствовала сама платформа
• отсутствовала игровая логика
• не было технической базы

Мы реализовали продукт полностью с нуля: от дизайна до продакшена.

Разработана с нуля play-to-earn игра в жанре пошагового кликера. Игрок управляет сновидцем, перемещаясь по клеткам сна, отвечая на квесты, сражаясь с кошмарами и собирая ресурсы. Реализована клиентская часть для браузера, подключение криптокошельков, смарт-контракты для валюты люменов и игровых предметов. Созданы все визуальные элементы: карточки локаций с тремя вариантами ответа каждая, анимации ходов, боевых эффектов, изменения шкал стресса, удачи, концентрации и энергии. Дополнительно реализована админ-панель для управления балансом, ценами и пулом событий.

• ~30 000 пользователей на запуске
• ~ 1 000 000 пользователей в процессе роста
• регулярные всплески нагрузки (реклама / трафик)
• одновременная активность пользователей внутри игры

Поведение пользователей:

• 3–4 сессии в день
• 20–30 минут за сессию

Это уже не “мини-игра”, а полноценный engagement-продукт.

До проекта у клиента не было инструмента для:

• удержания аудитории внутри Telegram
• построения игровой экономики
• масштабируемого привлечения пользователей
• подготовки к Web3-модели

Задача — создать систему, в которой:

• пользователь регулярно возвращается
• внутренняя валюта имеет ценность
• действия игрока влияют на результат
• продукт можно масштабировать и монетизировать

Ключевой фокус: не просто игра, а инструмент роста аудитории и выручки.

Игровая концепция. В отличие от классических “tap-to-earn” решений, здесь реализована более сложная логика:

• пользователь управляет персонажем
• перемещается по игровому миру
• попадает в различные локации
• принимает решения
• получает награды, бонусы или штрафы

Это ближе к стратегии с элементами RPG, чем к примитивному кликеру.

Игровая система. Реализованы ключевые механики:

• система прокачки персонажа
• внутриигровая валюта
• баланс пользователя
• бустеры
• задания
• ежедневные награды
• сценарии выбора (decision-based механика)

Каждое действие влияет на:

• прогресс
• экономику
• дальнейшие сценарии

Экономика. Внутренняя экономика построена как управляемая система:

• начисление валюты за действия
• штрафы и риски
• балансировка доходов
• контроль инфляции

Реализована защита:

• антифрод
• контроль аномальной активности
• защита от накруток

Telegram Mini App. Ключевые особенности:

• Telegram Web Apps API
• авторизация через initData
• интеграция с Telegram-пользователем
• работа внутри WebView

Решённые проблемы:

• нестабильность WebView
• баги с сессиями
• особенности передачи данных из Telegram

Backend

• Python (FastAPI + Django компоненты)
• REST API (без WebSockets — осознанный выбор)
• Redis (rate limiting, кэш, работа с нагрузкой)

Frontend

• React (Telegram Mini App)
• адаптация под Telegram WebView
• оптимизация UX под ограничения платформы

Инфраструктура

• VPS
• масштабирование под нагрузку
• обработка пиковых обращений

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

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

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

Восстановление энергии в реальном времени.
Таймер восстановления должен работать даже при закрытом приложении. Реализовано через серверные воркеры и уведомления: при восстановлении каждой единицы энергии игрок получает пуш-уведомление.

Совместимость с мобильными кошельками.
Тестировали интеграцию с Tonkeeper, MetaMask, Trust Wallet. Пришлось адаптировать виджеты и глубину ссылок, чтобы после подписи транзакции игрок возвращался в игру.

Антифрод:

• защита от накруток
• контроль поведения
• фильтрация подозрительных действий

Разработка заняла ~6 месяцев.

• ~ 1 000 000 пользователей
• кратный рост с 30 000 на старте
• 3–4 сессии в день на пользователя
• 20–30 минут средняя сессия
• стабильная работа при нагрузках
• реализована полноценная игровая экономика

Клиент получил не просто Telegram Mini App.

Это:

• игровая платформа
• инструмент удержания аудитории
• канал привлечения пользователей
• система с внутренней экономикой

база для будущей Web3-интеграции