Оглавление


SportBot — Полное руководство по командам


Фитнес-RPG в Telegram с приключениями и гильдией
Превращай тренировки в эпическое приключение! Качайся, сражайся с боссами, проходи квесты и исследуй истории.



📋 Все команды


Mini App
/heroПрофиль героя — ранг, XP, статистика по упражнениям, отряд
/guildГильдия — квесты, магазин зелий, баланс золота
/adventureRPG-приключение — интерактивные истории с физическими испытаниями
/calendarКалендарь тренировок
/achievementsДостижения — прогресс по всем 110+
/programПрограмма тренировок — персональный план с прогрессией нагрузки
Тренировки
/startНачать путешествие — регистрация и первый шаг
/profileПрофиль пользователя (текстовый)
/graphГрафики тренировокУпражнения: pushups, pullups, squats, abs · Периоды: week, month, year
🎙️ ГолосЗапись тренировок голосом — скажи упражнения и повторения, бот распознает и сохранит
💬 ТекстЗапись через кнопки меню или текстом: «отжимания 30», «приседания 50» — бот распознает упражнение и число
Соревнования и социальное
/ratingЛидерборд с выбором периода — Сегодня / Неделя / Месяц / Всё время
/monsterСтатус текущей битвы с монстром или рейд-боссом
/subscribeУправление подписками — следи за тренировками других героев
/referalРеферальная программа — пригласи друга, получи XP и открой новых монстров
/arenaАрена PvP — дуэль 1v1, побеждает тот кто сделал больше повторений за 30 минут
Настройки
/settingsНастройки уведомлений
/languageСмена языка интерфейса (ru / en / uk)
/donateПополнить баланс золота
/helpСправка



1. Основные команды


1.1 Регистрация и профиль


👤 Регистрация


Автоматическая регистрация происходит при первом взаимодействии с ботом. Система создаёт профиль и назначает начальный ранг "Зерно" (Seed).


Что происходит при регистрации:





1.2 Запись тренировок


💪 Запись упражнений


Типы упражнений:


Что происходит после записи:

1. ✅ Подтверждение записи с общим количеством повторений за день

2. 🎖️ Проверка на новые достижения (если разблокированы)

3. ⚔️ Автоматическое нанесение урона активному монстру или рейд-боссу

4. 🔥 Обновление серии тренировок

5. 💎 Начисление опыта (повышение ранга при достаточном XP)

6. 📊 Обновление личных и глобальных статистик


Пример ответа бота:

Твоя тренировка на сегодня: Отжимания (50 раз). 
Всего повторений — 50.

🔥 Серия: 7 дней подряд!
💎 Опыт: 3,475/5,000

⚔️ Монстр: Слизень
❤️ HP: 35/50
💥 Нанесено урона: 15

🏆 Новое достижение: Поднял камень - Сделай 20 отжиманий за одну тренировку (Награда: 0.5 монеты)



2. Статистика и прогресс


2.1 Личная статистика


📊 Статистика за период


Что показывает:


Как получить:

Статистика доступна через профиль (/profile) или через графики (/graph)




2.2 Графики тренировок


📈 Команда `/graph`


Формат: /graph [упражнение] [период]


Доступные упражнения:


Доступные периоды:


Примеры использования:

/graph
/graph pushups
/graph pushups week
/graph pullups month
/graph squats year

Интерактивное меню:

1. Команда без параметров → выбор упражнения через кнопки

2. Команда с упражнением → выбор периода через кнопки

3. Команда с обоими параметрами → мгновенная генерация графика


Технология: Графики генерируются через Quickchart.io (Chart.js) и отправляются как изображения прямо в чат.




2.3 Календарь тренировок


📅 Команда `/calendar`


Описание: Открывает интерактивный Telegram Mini App с календарём тренировок.


Функции:


Как использовать:

/calendar

Бот отправит кнопку "📅 Календарь", которая откроет Mini App с интерактивным календарём.


Что показывается при выборе даты:




3. Система рангов и опыта


3.1 Иерархия рангов


30 уровней с прогрессией от новичка до легенды. Каждый ранг — уникальное славянское или мифологическое название: от Зерна до «Кто ты, тварь?!».


У каждого ранга есть класс (E → D → C → B → A → S) и уровень внутри класса — это позволяет видеть прогресс детально, даже когда до следующего ранга ещё далеко.


Прогрессия ранга: При накоплении достаточного опыта происходит автоматическое повышение с уведомлением:

Название (RU) Требуется XP 1 Seed Зерно 0 2 Sprout Росток 100 3 Youngster Малец 300 4 Novice Новичок 600 5 Youth Отрок 1,000 6 Man Мужик 1,500 7 Militiaman Ополченец 2,200 8 Decurion Десятник 3,000 9 Kozhemyaka Кожемяка 4,000 10 Warrior Ратник 5,200 11 Centurion Сотник 6,600 12 Druzhinnik Дружинник 8,200 13 Bogatyr Богатырь 10,000 14 Varangian Варяг 12,000 15 Body Smith Кузнец тела 14,500 16 Thousandman Тысячник 17,500 17 Master Хозяин 21,000 18 Voivode Воевода 25,000 19 Grey Wolf Серый волк 30,000 20 Bear Медведь 36,000 21 Fierce Beast Лютый зверь 43,000 22 Leshy Леший 51,000 23 Volkhv Волхв 60,000 24 Steel Bear Стальной Медведь 70,000 25 Son of Perun Сын Перуна 81,000 26 Cyber Knight Кибервитязь 93,000 27 Ancient Power Древняя мощь 106,000 28 Cyber Bear Кибер-медведь 120,000 29 Deity Божество 135,000 30 ??? Кто ты, тварь?! 150,000+

Прогрессия ранга: При накоплении достаточного опыта происходит автоматическое повышение с уведомлением:

Поздравляю! Твой ранг повышен: Ратник → Сотник.
До следующего ранга осталось набрать опыта: 1,400.



3.2 Как получить опыт


💎 Источники опыта


1. Тренировки (основной источник)

XP = количество_повторений × коэффициент_упражнения

Коэффициенты упражнений:


2. Рефералы (бонусный источник)


Пример расчёта дневного опыта:

Тренировка за день:
- 50 отжиманий = 50 × 1.0 = 50 XP
- 10 подтягиваний = 10 × 2.33 = 23 XP
- 100 приседаний = 100 × 0.72 = 72 XP
- 40 пресса = 40 × 0.63 = 25 XP

Итого: 170 XP за день



4. Достижения


4.1 Категории достижений


110+ уникальных достижений в 9 категориях:


🔥 Серии


Достижения за последовательные дни тренировок:


Название Описание Дней Награда
Искра 10 дней подряд без перерыва 10 1 монета
Пламя 20 дней стабильных тренировок 20 2 монеты
Пожар силы 50 дней настоящей силы 50 5 монеты

Важно: Серия сбрасывается при пропуске дня (более 24 часов без тренировки).




💪 Отжимания — Путь богатыря


Название Описание Всего повторений Награда
Оруженосец Первые шаги юного воина 100 0.5 монета
Дружинник Воин княжеской дружины 500 1 монета
Витязь Отважный воин Руси 1,000 2 монеты
Богатырь Легендарный силач былин 5,000 5 монеты
Кибер-воин Усилен технологиями 10,000 10 монет
Титан механики Человек-машина силы 50,000 25 монет
Квантовый колосс Превзошел физику 100,000 50 монет



💪 Отжимания — Испытание силы


Название Описание Макс. за тренировку Награда
Поднял камень Сделай 20 отжиманий 20 0.5 монета
Поднял бревно Сделай 50 отжиманий 50 1 монета
Поднял валун Сделай 100 отжиманий 100 2 монеты
Перевернул телегу Сделай 200 отжиманий 200 5 монеты
Сдвинул гору Сделай 500 отжиманий 500 10 монет



🦾 Подтягивания — Сила медведя


Название Описание Всего повторений Награда
Хватка медвежонка Детеныш учится хватать 50 0.5 монета
Лесной охотник Ловкий и сильный 250 1 монета
Медведь-воин Сила дикого зверя 500 2 монеты
Царь зверей Властелин тайги 2,500 5 монеты
Кибер-медведь Железные когти 5,000 10 монет
Страж небес Достиг облаков 25,000 25 монет
Покоритель галактик Космическая мощь 50,000 50 монет



🦾 Подтягивания — Испытание высоты


Название Описание Макс. за тренировку Награда
Залез на дерево Начало восхождения 1 0.1 монет
Забрался на холм 5 подтягиваний 5 0.5 монета
Покорил скалу 10 подтягиваний 10 1 монета
Взошел на гору 15 подтягиваний 15 2 монеты
Достиг облаков 25 подтягиваний 25 5 монеты



🦵 Приседания — Корни дуба


Название Описание Всего повторений Награда
Росток дуба Зарождение силы 200 0.5 монета
Молодой дуб Крепнущие корни 1,000 1 монета
Столетний дуб Несгибаемый вечный 2,500 2 монеты
Гора-богатырь Твердость камня 10,000 5 монеты
Стальной гигант Металлическая основа 25,000 10 монет
Колосс империи Фундамент миров 100,000 25 монет
Планетарный атлас Держишь планеты 250,000 50 монет



🦵 Приседания — Стойкость


Название Описание Макс. за тренировку Награда
Устоял под ветром 50 приседаний 50 0.5 монета
Выдержал бурю 100 приседаний 100 1 монета
Пережил землетрясение 250 приседаний 250 2 монеты
Держит небосвод 500 приседаний 500 5 монеты
Основа вселенной 1000 приседаний 1,000 10 монет



🛡️ Пресс — Доспехи духа


Название Описание Всего повторений Награда
Кольчуга ученика Первая защита тела 100 0.5 монета
Княжеская кираса Доспехи знатного воина 500 1 монета
Латы витязя Защита храброго 1,000 2 монеты
Доспехи богатыря Непробиваемая защита 5,000 5 монеты
Нано-броня Технологическая защита 10,000 10 монет
Титановый щит Металлическая стена 50,000 25 монет
Квантовое поле Энергетический щит 100,000 50 монет



🛡️ Пресс — Несгибаемый стержень


Название Описание Макс. за тренировку Награда
Гибкая лоза 20 повторений 20 0.5 монета
Стальной прут 30 повторений 30 1 монета
Меч-кладенец 100 повторений 100 2 монеты
Алмазный стержень 200 повторений 200 5 монеты
Ось мироздания 500 повторений 500 10 монет



⚔️ Закалка в кузне


Достижения за количество тренировок:


Название Описание Тренировок Награда
Первый удар молота Первая тренировка 1 0.1 монет
Ученик кузни Закалка начинается 10 0.5 монета
Подмастерье Обучение у мастеров 50 1 монета
Кузнец своего тела Выкован в огне испытаний 100 2 монеты
Мастер-оружейник Создаешь совершенство 250 5 монеты
Кибер-кузнец Сплав плоти и металла 500 10 монет
Архитектор эволюции Создаешь новое 1,000 20 монет
Творец бессмертных Божественный уровень 2,500 50 монет



🤝 Реферальная система


Достижения за приглашённых друзей:


Название Описание Рефералов Награда
Позвал товарища Пригласил первого друга 1 0.5 монета
Отряд формируется Трое уже с тобой 3 1 монета
Командир десятки Командуешь отрядом из 10 воинов 10 2 монеты
Сотник Под твоим началом 25 воинов 25 5 монеты
Воевода Ведёшь 50 бойцов 50 10 монет
Князь-собиратель Объединил 100 воинов 100 20 монет
Царь-объединитель Империя из 250 человек 250 50 монет
Создатель легиона Легендарная армия из 500 воинов 500 100 монет



🤝 Братство силы


Достижения за социальные действия:


Название Описание Условие Награда
Нашёл товарища Подпишись на 1 пользователя 1 подписка 0.5 монета
Дружина собрана Подпишись на 5 пользователей 5 подписок 1 монета
Уважаемый воин Получи 5 подписчиков 5 подписчиков 1 монета
Атаман ватаги Получи 25 подписчиков 25 подписчиков 5 монеты
Князь земли Получи 100 подписчиков 100 подписчиков 10 монет
Герой народа 10 подписчиков + топ-10 Комбо условие 20 монет



🏅 Пьедестал славы


Достижения за места в рейтинге:


Название Описание Условие Награда
Вступил в бой Попади в лидерборд Любое место 0.5 монета
Войско избранных Топ-10 по любому упражнению Топ-10 1 монета
Дружина князя Топ-5 по упражнению Топ-5 2 монеты
Серебряный щит 2 место в лидерборде 2 место 5 монеты
Золотая корона 1 место в лидерборде 1 место 10 монет
Триумфатор Первый в 3 упражнениях 3× 1 место 50 монет



4.2 Награды


💰 Все достижения награждают игровыми монетами



Суммарно доступно: 500+ монет за все достижения!




5. Боевая система


5.1 Монстры


Концепция: У каждого пользователя свой персональный монстр. Тренировки наносят урон монстру. Победа = наград монетамиа!


👹 Доступные монстры


Название Эмодзи HP Награда Срок на победу
Слизень 🟢 50 1 монета 24 часа
Гоблин 👺 75 2 монеты 48 часов
Зомби 🧟 100 3 монет 72 часа

🎯 Механика боя


1. Начало битвы:


2. Нанесение урона:

Урон = количество_повторений × коэффициент_упражнения

Пример:

Тренировка: 50 отжиманий
Урон монстру: 50 × 1.0 = 50 HP

С активным зельем урона +100%:
Урон монстру: 50 × 2 = 100 HP

3. Победа:


4. Поражение:


📊 Отображение прогресса


После каждой тренировки показывается:

⚔️ Монстр: Слизень 🟢
❤️ HP: 25/50 ███████████░░░░░░░░░
💥 Нанесено урона: 25
⏰ Осталось: 18ч 23м



5.2 Рейд-боссы


Концепция: Кооперативные события, где все пользователи атакуют одного общего босса. Победа = награда для всех участников!


👾 Механика рейд-боссов


Рейд-боссы — это общее событие для всего сообщества. Пока активен босс, каждая твоя тренировка наносит ему урон вместе с остальными героями. Один тренируется — все побеждают.


Как это работает:


По пути бот подбадривает всех героев:


Победа — бот объявляет итоги всем с топ-3 героев по урону 🥇🥈🥉

Поражение — если время вышло, а HP не обнулили: «Босс выжил. 💀 Тренируйтесь лучше!»


🏆 Таблица лидеров


Отображается после каждой тренировки:

⚔️ Рейд-Босс: Король Лени 👑💤
❤️ HP: 180/500 ███████░░░░░░░░░░░░
⏰ Осталось: 8ч 12м

💥 Твой урон: 125 (🥈 2 место)

🏆 Все участники:
🥇 Иван - 150
🥈 Ты - 125
🥉 Пётр - 110
4. Мария - 95
5. Алексей - 80
...

⏰ Автоматическая проверка


Планировщик RaidBossScheduler:




6. Социальные функции


6.1 Лидерборды


🏆 Команда `/leaderboard`


Синонимы: /лидерборд, /lb, /rating, /рейтинг


Формат: /leaderboard [период]


Доступные периоды:


Типы лидербордов:


1. Общий рейтинг (по XP):

🏆 Рейтинг 🏆
(За всё время)

🥇 Иван Богатырь - 35,000 XP (Воевода)
🥈 Пётр Силач - 28,500 XP (Мастер)
🥉 Мария Воин - 22,100 XP (Тысячник)
4. Алексей - 18,700 XP (Кузнец тела)
5. Дмитрий - 15,200 XP (Варяг)

Ваше место: 12 (9,800 XP)

2. По упражнениям:

Отдельные топы для каждого упражнения:


⚡ Таблица лидеров ⚡
Отжимания (За неделю)

🥇 Иван - 1,250 повторений
🥈 Пётр - 980 повторений
🥉 Мария - 850 повторений
4. Алексей - 720 повторений
5. Дмитрий - 650 повторений

Всего пользователи сделали: 8,450 отжиманий.

Интерактивное меню:




6.2 Подписки


👥 Система подписок


Функция: Подписывайся на других пользователей и получай уведомления об их тренировках!


Как подписаться:

Через интерактивное меню с кнопками в боте


Что происходит при подписке:


Уведомления:

🔥 Твой друг Иван Богатырь побил личный рекорд в Отжимания: 95!

или

👥 Твой друг Пётр Силач выполнил тренировку:
• Подтягивания (15)
• Приседания (120)



6.3 Реферальная система


🤝 Приглашение друзей


Как получить реферальную ссылку:


Что даёт:


Как посмотреть список рефералов:

Информация доступна в профиле бота


Пример вывода:

Пользователей приглашено: 12

1. Иван Богатырь (Ратник, 5,200 XP)
2. Пётр Силач (Дружинник, 8,200 XP)
3. Мария Воин (Богатырь, 10,000 XP)
...



7. Система серий


7.1 Отслеживание серий


🔥 Что такое серия?

Количество дней подряд, когда вы делали хотя бы одну тренировку.


Условие продолжения:


Как отслеживать:

/profile — показывает текущую серию и рекорд

Примеры уведомлений:

🔥 Серия: 0. Начни сегодня!

🔥 Серия: 7 дней подряд. Рекорд: 15.

🔥 Серия: 20 дней подряд. (Новый рекорд! 🎉)

🔥 Серия потеряна. Лучший результат: 15 дней. 
Прошло дней без тренировки: 3.



7.2 Сохранение серии


💵 Функция страховки серии


Если вы пропустили 1 день (не более 48 часов с последней тренировки), можно купить продление серии за 1 монета.


Условия:


Как сохранить:

Используйте команду в боте для сохранения серии


Ответы:

✅ Серия сохранена за 1 монета.

❌ Серию нельзя сохранить, от последней тренировки прошло более 2-х дней.

❌ Недостаточно монет для сохранения серии.

Стратегия:

Используйте для защиты длинных серий (20+ дней), когда достижения за серию дороже 1 монета.




8. Персональные настройки


⚙️ Команда `/settings`


Описание: Управление персональными уведомлениями после тренировок.


Доступные настройки:


Настройка Код Описание По умолчанию
🎯 Прогресс к рангу notification.rank_hints Показывать сколько XP до следующего ранга ✅ Включено
🏆 Достижения notification.achievement_hints Показывать следующее достижение и прогресс ✅ Включено
⚔️ Битвы notification.battle_info Информация о рейд-боссах и монстрах ✅ Включено
🔥 Серия notification.streak_info Статус текущей серии тренировок ✅ Включено

Как использовать:

1. Отправьте /settings

2. Бот покажет интерактивное меню с кнопками

3. Нажмите на настройку для переключения (вкл/выкл)

4. Статус сохраняется автоматически


Интерактивное меню:

⚙️ Персональные настройки уведомлений

🔔 Уведомления

🎯 Прогресс к следующему рангу
Показывать сколько XP осталось до повышения
[Включено ✅]

🏆 Достижения
Показывать следующее достижение и прогресс
[Включено ✅]

⚔️ Битвы
Показывать информацию о рейд-боссах и монстрах
[Выключено ❌]

🔥 Серия
Показывать информацию о текущей серии
[Включено ✅]

Система настроек:




9. Питание и макросы


🥗 Система питания


Функции:


📊 Создание профиля питания


Параметры для настройки:


Уровни активности:


Цели:


Скорость изменения:


Пример результата:

✅ Ваш персональный план создан!

📊 Ваши данные:
• Текущий вес: 80 кг
• Целевой вес: 75 кг
• Изменение: -5 кг

⏱ Прогноз достижения цели: 10 недель
Темп изменения: 0.5 кг в неделю

🎯 Ваша дневная норма:
🔥 Калории: 2,100 ккал
🥩 Белки: 150г
🥑 Жиры: 70г
🍞 Углеводы: 210г

📖 Расчёты основаны на:
• Формула Миффлина-Сан Жеора (1990)
• Ваш уровень активности: Умеренная
• Ваша цель: Снижение веса

Формула расчёта (Mifflin-St Jeor):

BMR (мужчины) = 10 × вес + 6.25 × рост - 5 × возраст + 5
BMR (женщины) = 10 × вес + 6.25 × рост - 5 × возраст - 161

TDEE = BMR × коэффициент_активности
Калории = TDEE ± дефицит/профицит (в зависимости от цели)

🍽️ Логирование приёма пищи


Что нужно указать:


Пример результата:

✅ Приём пищи записан!

🍽 Завтрак: овсянка с бананом
🔥 Калории: 350 ккал
🥩 Белки: 12г | 🥑 Жиры: 8г | 🍞 Углеводы: 60г

📊 Итого за сегодня:
850/2,100 ккал (40%)
Белки: 45/150г | Жиры: 28/70г | Углеводы: 110/210г

⚖️ Логирование веса


Пример результата:

✅ Вес зафиксирован: 78.5 кг (↓ -1.5 кг от начала)

📈 Итоги за период


Пример результата:

📊 Итоги за 15.01.2024:
🔥 Калории: 1,980/2,100 ккал (94%)
🥩 Белки: 145/150г
🥑 Жиры: 68/70г
🍞 Углеводы: 205/210г



10. Мультиязычность


🌍 Поддержка языков


Доступные языки:


Как изменить язык:

Используйте настройки бота для смены языка интерфейса


Что локализовано:


Источники локализации:


Автоопределение:




🚀 Начало работы


1. Найдите бота: [@SquatMasterBot](https://tg.pulse.is/SquatMasterBot?start=68272210e7d3bb3e50024c24|user_referrer_id=676150892)

2. Нажмите "Старт" — автоматическая регистрация

3. Запишите первую тренировку: 50 отжимания

4. Получите первое достижение и наград монетамиу! 🎉

5. Пригласите друзей по реферальной ссылке — +100 XP за каждого

6. Участвуйте в рейд-боссах — кооперативные события

7. Побеждайте монстров — личные челленджи

8. Стремитесь к рангу "Божество" — 29-й ранг




📞 Поддержка


Live Bot: [@SquatMasterBot](https://tg.pulse.is/SquatMasterBot?start=68272210e7d3bb3e50024c24|user_referrer_id=676150892)

Website: https://squatmasterbot.tg.pulse.is/

GitHub: DenKaydunov/SportBot




⚠️ Важные примечания


Приватность:


TON-токены:


Технические требования: