Archive 006Telegram-бот

TGChatBot · Лагерь

Многопользовательская RPG в Telegram-чатах: ферма, походы, майнинг, кланы и Mini App «Лагерь» с общей экономикой и Stars

Смотреть галерею

01 /О проекте

Многопользовательская RPG в Telegram-чатах: ферма, походы, майнинг, кланы и Mini App «Лагерь» с общей экономикой и Stars.

02 /🎯 Суть проекта

01Игровой бот для групп и супергрупп Telegram — каждый чат = отдельный мир с собственной БД
02Команды с префиксом . или ! (например: .ферма, .поход, .клан) — игра прямо в переписке
03Telegram Mini App «Лагерь» — веб-интерфейс для сложных действий без спама в чате
04Мир Gradkia: ферма, шахта, походы, рейды на босса, банк, кланы, крафт и сюжетная хроника
05Монетизация через Telegram Stars: премиум, донат-шоп, бусты, острова и клановые слоты

03 /🏗️ Архитектура (app/ + web/)

01app/ — ядро: бот aiogram, игровая логика, каталоги, планировщики, платежи Stars
02web/backend/ — FastAPI REST API (/api/v1), переиспользует сервисы и ChatDatabaseManager из app/
03web/frontend/ — Vue 3 SPA: авторизация через initData, роутинг, экраны под TWA
04SQLite: registry.db (реестр чатов и пользователей) + отдельный файл БД на каждый telegram_chat_id
05Единые настройки через pydantic-settings (.env): баланс, кулдауны, Stars-цены, фичефлаги чата

04 /🌾 Ферма и прогрессия

01Команда .ферма — посев за 🪙, сбор урожая, кулдаун и шанс неудачи (настраивается админом)
02Цепочка построек: 🌱→💧→🏠→📦→🚜, XP за сбор, серии без сгорания
03Уровни фермы 2–5: навоз, капуста, картофель, чай, редкие культуры с грядки
04Культура недели — бесплатный посев семян из похода + бонус урожая
05Квест «Долг перед Империей» (Premium): 3 главы, штрафы, награды и лор в .хроника

05 /🗺 Походы и события

01.поход — экспедиции 3–8 ч: локации Gradkia, лут, XP фермы/майнинга, дневник
02До 4 случайных событий за поход с дедлайном ~10 мин; авто-скип из донат-шопа
03PvP-встречи на локациях (гонка на кнопку, +50🪙), защита для новичков (🌾 ур.1)
04Совместный поход с другом: время ÷1.5, награда ×1.2, XP связи
05Премиум-локации и «Мир II» за Stars; побег — штраф и потеря лута

06 /⛏ Майнинг

01.мшоп — пассивная добыча в фоне (даже во время похода, без управления)
02GPU-юниты, износ, ремонт за 🪙 или Stars, сбор с кулдауном
03Уровни майнинга, скидка на «электричество», премиум-скидки
04Алерты в чат при критическом износе оборудования

07 /🏰 Кланы

01.клан — создание за 🪙, премиум-клан за Stars, казна, уровни и слоты участников
02Клановые квесты, данжи с событиями, сюжетные ветки и общий склад (stash)
03Территории Gradkia: захват, войны, дань, бонусы к походам
04Инвестиции участников, роли, приглашения, смена лидера

08 /💰 Экономика и PvP

01.банк — вклад с процентами или «волатильным рынком»; грабёж только с наличных
02.дуэль — ставка с кошелька, ходы ⚔️/🛡/🎲, комиссия и таймауты
03.шоп / .дшоп — магазины за монеты и Stars; .крафт — мастерская и перекрафт
04.инвентарь — рюкзак, расходники, подарки предметов, энциклопедия в Mini App
05.ежедневка, .клад, .удар по боссу, .топ — циклы активности и рейтинги

09 /👥 Социальное

01.дружба — заявки, лимит друзей, совместные походы и бонус связи
02Профиль .я / .стата — баланс, баффы, статус, карточка игрока
03.премиум I/II — бонусы к монетам и дропу, отдельные UI в боте и Mini App
04Доставка личных уведомлений (DM) при привязке лички к боту

10 /🎮 Ивенты в чате

01Планировщик (тик ~30 с): босс-рейд, клады, таймеры походов и событий, майнинг
02Фазы босса: предупреждение → активный рейд → награды; крит-удары и буст за Stars
03Клановый босс в рейтинге урона; авто-сбор фермы и авто-удары (для подписчиков)
04Подсказки новым механикам, автоудаление панелей по настройкам чата

11 /📱 Mini App «Лагерь» (web/frontend)

01Хаб: профиль, ежедневка, босс, активный поход, квест хроники
02Экраны: ферма, шахта, поход, рюкзак, банк, магазин, крафт, клан, соцсеть, топ, помощь
03Vue 3 + vue-router, @twa-dev/sdk, тема под Telegram (color-scheme, safe-area)
04Сессия useGameSession: initData, выбор чата, автообновление профиля
05Bottom sheets, скелетоны, Cozy UI, RPG-иконки, сцены ArtPanel

12 /🔌 Web API (web/backend)

01FastAPI: /api/v1/me, profile, daily, boss, farm, mining, expedition, inventory, shop, craft, bank, clan, friends, story_quest, top, help, notifications
02Аутентификация: X-Telegram-Init-Data / Authorization: tma … (валидация подписи бота)
03Dev bypass для локальной разработки без Telegram-клиента
04CORS, lifespan с инициализацией ChatDatabaseManager и reload_star_prices
05Инвойсы Stars: буст босса, семена, экспедиции, клан, подарки — через общий ledger

13 /🛠️ Админ и Dev

01.настройки — inline-панель админа чата: экономика, банк, ивенты, фичефлаги
02Отключение шопа / походов / дуэлей / кланов per-chat
03Dev-панель, команды разработчика, /web и /start в личке для входа в Mini App
04Rate limit команд, antispam на callback, ExpeditionLock при активном походе
05Логирование апдейтов, безопасная отправка в чаты (FloodWait, недоступный чат)

14 /🧩 Технические особенности

01Python 3 + aiogram 3 (async), SQLAlchemy 2 async + aiosqlite
02Реестр команд (@game_command) с категориями и алиасами на кириллице/латинице
03Каталоги предметов в app/game/items/, миграции схем per-chat on-the-fly
04Платежи: pre_checkout, successful_payment, StarTransaction в registry
05Фронт: Vite 6, vue-tsc, без SSR — статика для Telegram WebApp

15 /Галерея