📘 Полное руководство по командам бота: от новичка до профи
Обновлено: март 2026 г.
Добро пожаловать! Эта статья — твой главный помощник по всем командам бота. Здесь простым языком разобрано, какие команды есть, где и как их использовать, и что получишь в ответ. Сохрани страницу в закладки — с ней ты не заблудишься.
📑 Содержание
1. Старт и основы навигации (в т.ч. личка и группа)
2. Основные команды: экономика и профиль
3. Игры и развлечения
4. Настройки и персонализация
5. Модерация (для администраторов группы)
6. Браки, отношения и РП — только в группе
7. Полезные мелочи и подсказки
8. Добавление бота в группу
9. Для владельца бота
🚀 Раздел 1. Старт и основы навигации {#start}
Команда /start
Что делает: Запускает бота и открывает главное меню. При первом запуске бот поприветствует тебя и покажет кнопки: баланс, топ, команды, помощь и другие разделы. Чтобы пользоваться ботом, нужно подписаться на основную группу — после вступления нажми кнопку «Я подписался» в меню.
Пример: Ты только что открыл бота в личке. Напиши /start — появится приветствие и меню с кнопками. Если заходишь по реферальной ссылке (например, t.me/имя_бота?start=ref_123456789), пригласивший получит процент с твоих покупок.
Команда /help
Что делает: Показывает короткую справку (текст совпадает с блоком «Дословный текст…» ниже) и кнопку 📋 Полный список команд — ссылка на полный гайд на сайте бота (/commands). Ниже добавляются кнопки главного меню, как после /start. Команды в коде: /help, /h, /commands, /kom_help.
В группе команды не должны пересекаться с другими ботами. Поэтому в меню бота в группах отображаются только команды с префиксом kom_. Используй их, чтобы вызвать именно этого бота: /kom_help, /kom_start, /kom_balance, /kom_games и т.д.
Дословный текст справки в Telegram (как в боте)
Ниже — то же сообщение, которое бот собирает из строк локализации (help_title, help_intro, …) и показывает в личке при /help (Markdown: жирное — как в Telegram):
🤖 КОМАНДЫ БОТА
Полный список всех команд с описанием доступен на нашей странице:
📌 Быстрый доступ:
• /start — главное меню
🎮 Игры: /roulette, /dice, /duel, /duel_stats, /roll, /flip, /calc
• /ai — спросить у Кома
• /help — эта справка
Для просмотра всех команд нажми на кнопку ниже.
Режим PvP-only: если в окружении процесса бота задана переменная PVP_GAMES_ONLY (на VPS — в .env или в юните systemd), вместо строки «🎮 Игры: …» бот подставляет две строки (создание офферов в личке, публикация в группе — см. раздел про PvP ниже):
• /pvp_dice <сумма> — PvP кости (в личке)
• /pvp_coin <сумма> орёл/решка — PvP монета (в личке)
Кнопка под сообщением: 📋 Полный список команд.
Команды с префиксом /kom_ (для групп)
В группе в меню бота отображаются только эти команды — так они не конфликтуют с другими ботами. В личке в подсказках — обычные имена (/help, /balance и т.д.); после вступления в основную группу эти команды в ЛС работают (см. блок «Личка и группа» ниже).
Основные: /kom_start, /kom_help, /kom_lang, /kom_time, /kom_faq, /kom_ping, /kom_botcheck, /kom_feedback
Город и погода: /kom_city, /kom_weather, /kom_forecast, /kom_timezone
Экономика: /kom_balance, /kom_daily, /kom_shop, /kom_currency, /kom_buy, /kom_top
Игры и развлечения: /kom_games, /kom_flip, /kom_calc, /kom_joke, /kom_joke18, /kom_quote
Профиль: /kom_profile, /kom_whoami
ИИ и крипта: /kom_ai, /kom_crypto
Группа: /kom_rules, /kom_donate, /kom_donaters, /kom_groupstats, /kom_top (рейтинг групп)
Модерация (для админов): /kom_warn, /kom_mute, /kom_unmute, /kom_ban, /kom_unban, /kom_pin, /kom_unpin, /kom_kick
Управление группой (для админов): /groupadmin — без префикса, уникальная команда.
Личка и группа: как это устроено {#group-vs-dm}
1. Подписка на основной чат (только ЛС): пока ты не в основной группе бота, в личке по сути доступен только /start — остальные команды блокируются с напоминанием подписаться (у владельца и разработчиков ограничения нет).
2. Меню Telegram (подсказка при вводе «/»): в личке показываются команды без kom_; в группе — с префиксом kom_ и отдельно /groupadmin. Это нужно, чтобы в группе не пересекаться с другими ботами в подсказках, а не чтобы запретить обычные имена.
3. Набор с клавиатуры в группе: если в коде у команды есть и обычный, и kom_-алиас, в группе сработают оба (например /balance и /kom_balance, /help и /kom_help).
Исключение — столы и часть игр: у /roulette, /dice, /duel, /roll, /cpc, /кнб в обработчиках нет вариантов вроде /kom_roulette — в группе вводи именно /roulette, /dice, /duel, /roll, /cpc (полный список — в /kom_games). /flip и /calc в группе можно и как /kom_flip, /kom_calc.
4. Только группа: модерация (/warn и др.), игры на монеты (/roulette, /dice, …), полноценный вывод /games. В личке /games сообщает, что игры доступны в группе.
5. Только личка (создание PvP): /pvp_dice и /pvp_coin — оффер создаётся в ЛС; команду в группе бот не принимает для создания (ответит подсказкой).
Команды /faq и /faq2
Что делают: Ответы на частые вопросы: как зарабатывать монеты, как играть, как работает магазин. /faq — первая часть, /faq2 (или /faq_2) — вторая. Загляни сюда, прежде чем спрашивать в чате.
Команды /ping и /botcheck
Что делают: /ping — проверить скорость ответа бота (задержка в миллисекундах). /botcheck (или alive) — короткая проверка: бот на связи.
Кнопка «🏠 Главное меню»
Зачем нужна: Возвращает тебя к главному экрану с кнопками (баланс, топ, команды, магазин и др.), чтобы не вводить команды вручную. Нажал — и снова видишь все основные действия в одном месте.
Пример: Ты зашёл в магазин или в профиль и хочешь вернуться к выбору действий. Нажми «🏠 Главное меню» — откроется то же меню, что и после /start.
💰 Раздел 2. Основные команды: экономика и профиль {#main}
Команда /balance (или /bal)
Что делает: Показывает твой баланс — сколько у тебя сейчас монет (COM), сколько заработано и потрачено. Монеты нужны для игр, переводов и покупок в магазине.
Пример: Написал /balance — бот ответил: «💰 Баланс: 1 500 COM. Заработано: 3 200. Потрачено: 1 700.» В группе то же самое можно написать без слэша: бот баланс или .баланс.
Команда /daily
Что делает: Забрать ежедневный бонус — монеты раз в сутки. Если заходишь несколько дней подряд, бонус может расти. Если уже забрал — бот подскажет, когда следующий.
Команда /profile
Что делает: Показывает развёрнутый профиль: твоя карточка, ранг, достижения, статистика. В группе — ещё и статистика по этому чату. В личке — общие данные без привязки к группе.
* /profile — свой профиль.
* /profile (ответом на сообщение) — профиль того, кому ответили.
* /profile @username — профиль участника по юзернейму.
Текстовые команды без слэша (в группе):
* кто ты? (ответом на сообщение) — показать профиль того, кому ответили.
* кто это? (ответом на сообщение) — то же самое.
🔐 Просмотр чужих профилей может быть ограничен настройками группы (минимальный ранг).
Дополнительно: /whoami (или /me) — кратко «кто я»: имя, баланс, ранг. /achievements (или /ach) — список достижений: какие есть, какие ещё не получены.
Пример: Хочешь посмотреть, какой у тебя ранг и сколько достижений открыто. Напиши /profile — получишь сообщение с твоей карточкой и кнопками (например, «Мои отношения», «Моя семья» в группе). Чтобы посмотреть профиль другого участника — ответь на его сообщение фразой кто ты?.
Чем отличается /start от меню
/start — запуск бота и показ главного меню с кнопками. Меню (кнопка или те же кнопки после /start) — это и есть главный экран: баланс, топ, команды, помощь, магазин. Отдельной команды «меню» нет — главное меню открывается через /start или кнопку «Главное меню».
Режим без слэша: текст как команда
В группе бот понимает команды и без «/»: можно написать бот баланс, .дейли, ?топ — бот отреагирует так же, как на /balance, /daily, /top. Чтобы точно вызвать этого бота при нескольких ботах в чате, используй в группе команды с префиксом kom_: /kom_balance, /kom_daily, /kom_help и т.д. (см. блок выше).
Пример: В группе написал дейли или бот дейли — бот засчитает ежедневный бонус, как если бы ты отправил /daily. Либо /kom_daily — без пересечения с другими ботами.
🎮 Раздел 3. Игры и развлечения {#games}
Команды на монеты: рулетка, кости, дуэль
• /games — список доступных игр с описанием. Показывает, во что можно поиграть в этой группе.
• /roulette 100 — русская рулетка: ставка 100 монет, один «выстрел» из шести. В 5 из 6 случаев выигрыш ×2.
• /dice 100 5 — кости: ставка 100, загадываешь число от 1 до 6 (например, 5). Угадал — выигрыш ×6.
• /roll 4 или /roll 100 4 — кубик: без ставки просто угадываешь число; со ставкой — как в костях.
• /flip орёл или /flip 50 решка — монетка: угадал сторону — выигрыш ×2.
• /duel 200 3 — дуэль на монеты. Ответь на сообщение соперника этой командой (ставка 200, 3 раунда). Соперник принимает — по очереди кидаете кубики; кто выиграет больше раундов — забирает банк.
• /cpc 100 или /кнб 100 — камень, ножницы, бумага на ставки. Ответь на сообщение соперника или укажи @ник. Соперник принимает вызов (кнопка или /cpc_accept в ответ на сообщение бота). Оба выбирают ход в личке с ботом (✊✌️✋). Победитель забирает удвоенную ставку; ничья — возврат. /cpc_decline — отклонить вызов, /cpc_cancel — отменить свою игру.
• /duel_stats — твоя статистика дуэлей: сколько сыграно, побед и поражений.
Пример: Хочешь рискнуть 50 монет на орла. Напиши /flip 50 орёл — бот «подбросит» монету и напишет, выиграл ты или нет.
PvP-команды (игрок против игрока)
В режиме PvP в группе доступны команды только для дуэлей игрок против игрока. Такие офферы создаются в личке и публикуются в группе, а соперник принимает их кнопкой.
• /pvp_dice 100 — PvP кости. В личке создай оффер на ставку 100 и выбери группу для публикации. Соперник принимает — и бот разыгрывает по выброшенным значениям.
• /pvp_coin 100 орёл — PvP монетка. В личке создай оффер на ставку 100 и задай сторону (орёл/орёл или решка). Соперник принимает — бот сравнит выбор и определит победителя.
Команды без ставок
• /joke (или шутка, анекдот) — случайная шутка от бота.
• /quote (или цитата) — случайная цитата или мысль.
• /calc 2+2 или **/calc 10*3-1** — калькулятор: посчитать пример (+, −, *, /, скобки).
Пример: Нужно быстро посчитать, сколько будет 15% от 800. Напиши **/calc 800*0.15** — бот вернёт ответ.
⚙️ Раздел 4. Настройки и персонализация {#settings}
Команда /settings (или настройки)
Что делает: Открывает настройки: можно посмотреть и изменить параметры профиля, уведомления (если бот их поддерживает в этом разделе), язык и другие опции.
Пример: Напиши /settings — появится меню или сообщение с настройками. Часто там же доступна смена языка.
Команда /lang (или язык)
Что делает: Меняет язык интерфейса бота (русский или английский). Подсказки и сообщения бота будут на выбранном языке.
Пример: Ты в личке с ботом, всё на русском. Напиши /lang — бот предложит выбрать язык; выбери English — дальше интерфейс переключится на английский.
Команда /city (или город)
Что делает: Указывает или меняет твой город. Нужен для команд /time и /weather — бот покажет время и погоду для твоего города. Без аргументов — бот покажет, какой город сейчас записан.
Пример: Напиши /city Москва — бот сохранит город. Потом по /weather получишь погоду в Москве.
Команда /feedback
Что делает: Отправить фидбэк владельцу/админам: предложения, замечания, идеи по боту. Отличается от тикета поддержки — это для общих отзывов, а не для срочных поломок.
Пример: Хочешь предложить новую команду или сказать, что кнопка «Магазин» неудобная. Напиши /feedback и затем своё сообщение — оно уйдёт разработчику.
Команда /support (тикет поддержки)
Что делает: Написать в поддержку: создать обращение (тикет), описать проблему. Админы получат сообщение и ответят. Используй, если что-то сломалось или нужна помощь.
Команда /ad (реклама)
Что делает: Подать заявку на рекламу (размещение в чате). Работает в личке с ботом: напиши боту и выбери заявку. Админы рассмотрят и свяжутся. Алиасы: /ads, /reklama.
🛡️ Раздел 5. Модерация (для администраторов группы) {#moderation}
Эти команды работают только в группе и доступны владельцу группы, назначенным админам/модераторам (через панель «Роли и права») или тем, у кого в группе есть нужные права модерации в Telegram. Управление правами — в личке бота: /groupadmin в группе откроет ссылку на панель настроек группы.
Предупреждения (варны)
• /warn (или /kom_warn) — выдать предупреждение. Ответь на сообщение нарушителя и напиши /warn или /warn причина. Можно указать срок действия варна: /warn 7d причина (истечёт через 7 дней), /warn 30d или /warn 0 причина (варн без срока). При достижении лимита предупреждений пользователь может быть автоматически забанен на 7 дней.
• /unwarn (или /kom_unwarn, /снять_предупреждение) — снять одно предупреждение. Ответь на сообщение участника. Можно указать ID варна: /unwarn 123.
• /warnings (или /варны, /предупреждения) — показать свои предупреждения в этом чате: сколько всего и список последних.
Мут и размут
• /mute (или /kom_mute) — замутить участника. Ответь на его сообщение и укажи срок: /mute (по умолчанию из настроек), /mute 10m, /mute 1h, /mute 1d, /mute 7d и т.д. Единицы: m — минуты, h — часы, d — дни, w — недели. После срока можно добавить причину: /mute 1h спам.
• /unmute (или /размут, /kom_unmute) — снять мут. Ответь на сообщение участника. Можно добавить комментарий: /unmute причина.
Бан и разбан
• /ban (или /kom_ban) — забанить участника. Ответь на сообщение и укажи срок: /ban (неделя по умолчанию), /ban 10m, /ban 1h, /ban 7d, /ban 1w или /ban 0 / /ban forever — навсегда. Единицы: m, h, d, w. После срока — причина: /ban 1d нарушение.
• /unban (или /разбан, /kom_unban) — разбанить. Ответь на сообщение или укажи пользователя. Комментарий в лог: /unban причина.
Кик и прочее
• /kick (или /кик, /kom_kick) — исключить участника из чата (кик). Ответь на его сообщение. После кика пользователь может вернуться по ссылке; бан запрещает вход.
• /pin, /unpin — закрепить/открепить сообщение (ответом на сообщение).
• /clear (или /очистить, /очистка) — массовое удаление сообщений в группе (аналог «purge»). Нужны права администратора; точный синтаксис см. в /help по модерации.
• /filter, /ranks — фильтр слов, ранги (см. панель модерации в группе).
Репорт в личку бота
Если участник хочет пожаловаться на сообщение в группе, он может переслать это сообщение боту в личку — тогда все администраторы группы получат уведомление в ЛС с пересланным сообщением и комментарием. Либо отправить /report комментарий в ответ на пересланное в личку сообщение из группы — админы группы получат репорт.
🤖 Раздел 6. Браки, отношения и РП — только в группе {#social}
Эти команды и действия работают только в группе, не в личке с ботом.
Браки
• /marry (или брак, жениться) — предложить брак. Ответь на сообщение человека и напиши /marry — у него появится кнопка «Принять» или «Отклонить». Если примет — вы в браке в этом чате.
• /marriage (или брак_статус) — показать свой брак в этом чате: с кем и с какой даты.
• /divorce (или развод) — расторгнуть брак. После этого можно заключить новый.
• /marriages (или браки, пары) — список всех пар в браке в чате.
Пример: Ты в группе, ответил на сообщение подруги и написал /marry. Она нажала «Принять» — бот объявил вас парой в этом чате.
Отношения (не брак)
• /relationship (или rel, отношения) — ответом на сообщение предложить «быть в отношениях»; у человека появятся кнопки принять/отклонить. Без ответа — бот покажет, с кем ты в отношениях в этом чате.
• /breakup (или расстаться) — прекратить отношения в этом чате.
• /relations (или отношения_список) — список пар «в отношениях» в чате.
• /rp_commands (или /рп_команды) — показать свой уровень отношений в чате и полный список РП-команд по уровням. Работает только в группе.
РП-команды (обнять, поцеловать и т.д.)
Работают только в группе. Ответом на сообщение партнёра напиши слово действия: обнять, поцеловать, пожать руку и т.п. Бот отправит текст действия и начислит паре опыт (XP). Уровень отношений растёт — открываются новые команды. Свой уровень и список команд по уровням — команда /rp_commands.
Пример: В группе ответь на сообщение партнёра текстом обнять или бот обнять — бот напишет что-то вроде «Иван обнял Марию» и начислит паре XP.
Полный список РП-команд по уровням (ответом на сообщение напиши одно из слов, только русские команды):
• Ур. 1 — Знакомые: пожать руку, дать пять, ударить, пнуть
• Ур. 2 — Дружеские отношения: обнять, погладить, извиниться
• Ур. 3 — Тёплые отношения: укусить, щекотать, успокоить
• Ур. 4 — Симпатия: покормить, напоить, обидеться
• Ур. 5 — Флирт: поцеловать, лизнуть, подарить
• Ур. 6 — Ухаживания: романтический ужин, комплимент (18+: выебать, трахнуть)
• Ур. 7 — Отношения: цветы, признание
• Ур. 8 — Серьёзные отношения: кольцо, фото
• Ур. 9 — Любовь: предложение, помолвка
• Ур. 10 — Великая любовь: свадьба
Команда /rp_commands (или /рп_команды) покажет твой уровень в чате и доступные тебе команды.
📦 Раздел 7. Полезные мелочи и подсказки {#tips}
Магазин и инвентарь
• /shop — открыть магазин: товары (VIP, бонусы, снятие предупреждения и др.), цены, кнопки «Купить». Оплата с твоего баланса.
• /inventory (или /inv) — твой инвентарь: купленные и ещё не использованные предметы. У каждого — кнопка «Использовать».
Пример: Купил VIP в магазине. Зайди в /inventory и нажми «Использовать» у купленного VIP — он активируется.
Переводы и топ
• /send 100 — перевести монеты. Ответь на сообщение получателя и укажи сумму, либо напиши /send @ник 50.
• /top — рейтинг участников по монетам (и другие топы). Кто самый богатый в чате. В группе: /top или /top balance — по монетам; /top messages — топ по сообщениям (только в группе).
Вывод монет и P2P (только в личке с ботом)
• /withdraw (или /вывод) — меню вывода: прямой вывод (карта, крипта по шагам), P2P-маркет (продать монеты другим пользователям), экспресс-покупка. Дальше бот ведёт по кнопкам и запрашивает суммы и реквизиты в личке.
• /withdraw_status — статус заявок на вывод: на рассмотрении, выполнено, отклонено.
• Отмена несохранённого сценария: /cancel в личке сбрасывает шаги вывода и P2P.
Рейтинг групп по донатам и донаты
• /top, /top_groups, /rating_groups, /rating, /kom_top — открыть топ групп по донатам (рейтинг по очкам «Гром»). Показывает группы, в которые задонатили; у каждой группы в топе отображается название и уникальная ссылка-приглашение. Доступно в личке с ботом; язык интерфейса — по твоей настройке (русский или английский).
• /donate — донат в группу: списать монеты с баланса и зачислить группе очки в рейтинг; часть суммы (за вычетом комиссии) получает владелец группы. В группе можно нажать кнопку «Донатить» в статистике или в карточке группы в рейтинге.
• /groupstats (или /group_treasury, /статистика_группы, /казна_группы, /kom_groupstats) — в группе: статистика этой группы (рейтинг по Гром, топ донатеров, кнопки «Донатить» и «Рейтинг групп»). В личке: переход к просмотру рейтинга групп.
• /mydonates (или /мои_донаты) — твоя история донатов и общая сумма; только в личке с ботом.
Пример: Хочешь посмотреть, какие группы лидируют по донатам. В личке напиши /top или /rating — откроется страница рейтинга с группами и ссылками. Чтобы задонатить в группу — зайди в неё и используй /donate или кнопку в /groupstats.
Валюта и курсы
• /currency (или /валюта) — настроить валюту отображения: в какой валюте показывать баланс и цены (рубли, доллары, евро, TON и др.). Без аргументов — выбор из списка.
• /rate (или /курс, /курсы) — узнать текущий курс: 1 монета (COM) = сколько в выбранной валюте. Можно указать код валюты.
• /convert (или /конверт) — конвертировать сумму монет в выбранную валюту. Укажи количество COM и при желании код валюты.
Статистика
• /stats — твоя личная статистика: сообщения, команды, игры, переводы, серия ежедневных бонусов.
• /chatstats (или /cstats) — статистика чата: кто сколько написал за период, топ активных. Только в группе.
• /chatinfo — информация о чате: название, тип, количество участников.
• /top_activity (или /topactive) — топ самых активных за последние дни. По умолчанию — за неделю; можно указать период: /top_activity 14 — за 14 дней.
ИИ-помощник
• /ai (или /ask) — задать вопрос ИИ-помощнику (Ком). Есть лимит запросов в день; с VIP — больше. В группе Ком учитывает контекст беседы.
Время и погода
• /time (или время) — время по Москве, дата, день недели. Учитывает твой город из /city.
• /weather (или погода) — погода в твоём городе или в городе, который укажешь: /weather Казань.
Проверка бота
• /ping — проверить скорость ответа бота (задержка в миллисекундах).
• /botcheck (или alive) — короткая проверка: бот на связи, всё в порядке.
Если забыл команды
Всегда можно написать /help — бот покажет список команд по разделам. Полный список с описаниями также доступен по кнопке «📄 Команды» в меню (если владелец настроил страницу на Telegra.ph). Для владельца бота есть отдельная справка: /admin_help.
🤖 Раздел 8. Добавление бота в группу {#bot_add_to_group}
Если ты добавляешь бота в группу, после добавления бот попросит выдать ему права администратора. Чтобы бот мог полноценно работать (модерация, игры, экономика, инвайт-ссылки), включи в настройках группы для бота:
• Удаление сообщений
• Добавление участников (инвайт-ссылки)
• Ограничение участников (мут/бан)
• По желанию: Закрепление сообщений
Настройки группы → Администраторы → добавь бота (или нажми на него) → включи перечисленные права. После этого нажми кнопку «Я выдал права» в сообщении бота — он проверит и подтвердит.
👑 Раздел 9. Для владельца бота {#owner}
Этот блок — не для участников чата, а для владельца (тот же Telegram ID, что в настройках как админ бота).
• /dev, /admin — панель разработчика и настройки (доступ только владельцу).
• /admin_help — расширенная справка по админ-командам (отличается от обычного /help).
• /reload — горячая перезагрузка кода без остановки процесса. Работает, когда бот запущен как python main.py в режиме webhook (так и задумано на сервере). Если процесс запущен иначе, бот подскажет в ответе.
• /deploy — краткая подсказка по выгрузке на VPS; на практике файлы чаще копируют с компьютера скриптом deploy_to_vps.sh — см. в репозитории DEPLOY_VPS.md и CLI_DEPLOY.txt.
Страница команд на Telegra.ph: в админ-панели: Система → «Обновить Telegra.ph» (нужен токен Telegra.ph в настройках). Источник текста для публикации — файлы telegraph_guide_ru.md / telegraph_guide_en.md в проекте; детали — TELEGRAPH_README.txt.
Сервер и HTTPS: в продакшене бот принимает обновления только по webhook; в .env на VPS должны быть BOT_TOKEN и WEBHOOK_URL. Развёртывание и nginx (в т.ч. если на одном IP несколько сервисов на порту 443) — WEBHOOK.md.
Заключение
В этой статье разобраны основные команды бота: старт и меню, экономика и профиль, игры, настройки, модерация (для админов группы), браки и отношения (только в группе), рейтинг групп по донатам, магазин и инвентарь, добавление бота в группу; в разделе 9 — панель владельца, деплой и публикация гайда на Telegra.ph. Часть команд работает только в группе, часть — и в личке, и в группе. Если что-то забыл — нажми /help или открой главное меню через /start. Удачного использования!