Selara веб-панель
Документация

Документация пользователя

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

команды
reply-действия
игры + экономика

С чего начать

Базовая схема работы: что делается в группе, что приходит в личку и почему часть сценариев завязана на reply или кнопки.

Где писать команды
группа ЛС

Почти все повседневные команды работают в группе: статистика, экономика, отношения, семья, игры и reply-действия. Личный чат с ботом нужен для входа в веб-панель, скрытых ролей и deep-link переходов.

Команды
  • /help
  • /start
  • /login
  • /role
Как использовать
  • Откройте личный чат с ботом и нажмите Start, если хотите получать роли, карточки или код входа.
  • В группе вызывайте команды обычным slash-форматом или текстовыми триггерами, если они включены в чате.
  • Если игра использует скрытые роли, не закрывайте ЛС: бот шлёт важные подсказки именно туда.
Важно
  • Если бот молчит в группе, причина часто в отключённых текстовых командах, правах команды или Telegram privacy mode.
Что чаще всего делается через reply
reply группа

Часть сценариев завязана на ответ на чужое сообщение: так бот точно понимает цель действия без лишних аргументов.

Примеры
  • reply + /pair
  • reply + /marry
  • reply + /pay 100
  • reply + обнять
  • reply + соблазнить
Важно
  • Reply-действия работают только по чужому сообщению, не по своему и не по боту.
  • Предложения пары, брака, усыновления и статуса питомца подтверждаются кнопками согласия/отказа.
Быстрый вход в справку и панель
ЛС группа

Команда помощи показывает встроенное меню по разделам, а `/login` выдаёт одноразовый код для веб-панели `/app`.

Команды
  • /help
  • /login
Важно
  • Код входа выдаётся в личке, а не в группе.
  • На сайте `/app/docs/user` собрана расширенная версия пользовательской документации.

Статистика и статус

Команды, которые помогают понять своё положение в чате, посмотреть топы, роли и базовые публичные статусы.

Профиль, репутация и лидерборды
группа текстовые аналоги

Основной набор для повседневной активности: свой профиль, карма, общий рейтинг и отдельные топы по активности.

Команды
  • /me
  • /rep
  • /top [N]
  • /top karma [N]
  • /top неделя|сутки|час|месяц [N]
  • /active [N]
Триггеры
  • кто я
  • репутация
  • мой рейтинг
  • топ 10
  • топ карма 15
  • актив 20
Важно
  • В `/top` можно переключать режим и период через аргументы, а в части чатов ещё и через кнопки.
  • Лимиты списка зависят от настроек группы.
Когда пользователь был активен
группа reply

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

Команды
  • /lastseen [@username|user_id]
Триггеры
  • когда был
  • когда была
Примеры
  • /lastseen @username
  • reply + /lastseen
Публичные служебные команды
группа

Эти команды не меняют настройки, а помогают понять состояние группы: список ролей, moderation-статус и параметры чата.

Команды
  • /help
  • /settings
  • /roles
  • /modstat [@username|user_id]
Примеры
  • /modstat
  • /modstat @username
  • reply + /modstat
Важно
  • `/settings` показывает текущие настройки, но менять их могут только роли с правом управления.
  • `/roles` выводит назначенные роли бота в чате.
  • `/modstat` без аргументов показывает ваш собственный moderation-статус.

Игры

Как запускать игровые лобби, где смотреть скрытую роль и как участвовать в конкретных режимах.

Запуск лобби
группа

Команда `/game` открывает меню выбора. Если указать режим сразу, бот попробует создать лобби без дополнительных кликов.

Команды
  • /game
  • /game spy
  • /game whoami
  • /game mafia
  • /game dice
  • /game quiz
  • /game bredovukha
  • /game bunker
Триггеры
  • игра
Важно
  • Для запуска нужен доступ `manage_games` в конкретном чате.
  • Для новых запусков доступны `spy`, `whoami`, `mafia`, `dice`, `quiz`, `bredovukha`, `bunker`.
  • Режим `number` больше не запускается заново, но может встретиться как уже идущая старая партия.
Скрытая роль, карточка и ЛС
ЛС группа

Игры со скрытой информацией присылают роль или личную карточку в приват. Если бот не может написать вам первым, роль вы не увидите.

Команды
  • /role [game_id]
  • /start
Как использовать
  • Перед первой партией откройте личный чат с ботом и нажмите Start.
  • Во время игры используйте `/role`, если нужно повторно посмотреть секретную роль или карточку.
  • Часть фаз `Мафии`, `Шпиона`, `Бункера` и `Кто я` сопровождается личными сообщениями и приватными кнопками.
Важно
  • Если `/role` ничего не показывает, скорее всего у вас сейчас нет активной секретной роли или ЛС с ботом не открыт.
Как играть в «Кто я»
группа ЛС

После старта каждый получает карточку в приват. Активный игрок задаёт в группу вопрос с ответом «да / нет / не знаю», после чего остальные отвечают кнопками.

Команды
  • /game whoami
Примеры
  • Я думаю, что я Шерлок Холмс
  • Моя догадка: Бэтмен
  • Кажется, я Ведьмак
Важно
  • Для догадки используйте естественную фразу вроде `Я думаю, что я ...`.
  • Тема `18+ и пикантное` видна и доступна только в чатах, где включён `actions_18_enabled`.
Как участвовать в остальных режимах
группа кнопки

`Шпион`, `Мафия` и `Бункер` используют роли, приватные подсказки и голосования. `Кости`, `Викторина` и `Бредовуха` активнее работают через кнопки и публичные ответы.

Команды
  • /game spy
  • /game mafia
  • /game dice
  • /game quiz
  • /game bredovukha
  • /game bunker
Важно
  • В `Бункере` часть раундов идёт через приватное раскрытие характеристик и приватное голосование.
  • В `Мафии` и `Шпионе` ключевые действия и роль приходят в личку.

Экономика и предметы

Все пользовательские сценарии экономики: баланс, фарм, рынок, переводы, рост, лотерея и предметы.

Панель экономики и базовый заработок
группа ЛС по настройкам

Экономический профиль открывается через `/eco`. Дальше от него идут клики, ежедневка, лотерея, статья дня и профиль роста.

Команды
  • /eco [global|local]
  • /tap
  • /daily
  • /lottery [free|paid|item|status]
  • /article
  • /growth
Триггеры
  • баланс
  • тап
  • дейлик
  • лотерея
  • рост
  • профиль
  • моя статья
  • статья
Важно
  • В личке `/eco local` имеет смысл только если для вас уже установлен local-контекст чата.
  • Режим экономики и доступность самих механик зависят от настроек конкретной группы.
Ферма
группа ЛС

Ферма умеет показывать статус, сажать культуры, собирать урожай, продавать его и покупать апгрейды уровня и размера.

Команды
  • /farm
  • /farm plant <культура> [грядка]
  • /farm harvest <грядка>
  • /farm sell <культура> <кол-во>
  • /farm upfarm
  • /farm upsize <средний|большой>
Триггеры
  • ферма
Примеры
  • /farm plant wheat
  • /farm harvest 2
  • /farm sell wheat 10
  • /farm upsize большой
Магазин, инвентарь и крафт
группа ЛС

Через магазин покупаются офферы, через инвентарь применяются предметы, а через крафт собираются новые вещи по рецептам.

Команды
  • /shop
  • /shop buy <номер_оффера>
  • /inventory
  • /inventory use <предмет> [грядка]
  • /craft
  • /craft <recipe_code>
Триггеры
  • магазин
  • инвентарь
  • крафт
Важно
  • Крафт может быть отключён настройками чата.
  • Названия предметов в командах можно писать как кодами, так и многими русскими алиасами.
Рынок, переводы и аукцион
группа

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

Команды
  • /market
  • /market sell <предмет> <кол-во> <цена>
  • /market buy <лот_id> <кол-во>
  • /market cancel <лот_id>
  • /pay @username 100
  • /auction
  • /auction start <item_code> <qty> <start_price> [minutes]
  • /auction cancel
  • /bid <сумма>
Триггеры
  • рынок
  • перевод
Примеры
  • /pay 123456789 250
  • reply + /pay 100
  • /market sell crop:wheat 20 15
  • /bid 5000
Важно
  • `/pay` можно сделать по `@username`, `user_id` или reply.
  • `/auction start` и `/auction cancel` требуют прав на управление настройками или аналогичного ранга команды.
Рост
группа ЛС 18+ по настройке

Команда `/growth` показывает профиль роста, стресс и доступные действия. Активное действие запускается отдельной командой.

Команды
  • /growth
  • /growth do
Триггеры
  • рост
  • профиль
  • дрочка
  • дрочить
  • подрочить
Важно
  • Само действие роста блокируется, если в чате выключен `actions_18_enabled`.
  • Команда без `do` открывает профиль и кнопки состояния.

Пары и брак

Как предложить отношения, какие действия доступны на каждой стадии и чем отличается пара от брака.

Как начать отношения
группа reply

Сначала откройте `мои отношения` или `/relation`, а для брака отдельно доступен `мой брак`. Предложение пары или брака отправляется через reply или `@username`, а подтверждение идёт кнопками.

Команды
  • /relation
  • /pair @username
  • /marry @username
Триггеры
  • мои отношения
  • мой брак
  • браки
  • отношения
  • брак
  • пара
  • жениться
  • предложить встречаться
  • предложить брак
Примеры
  • reply + /pair
  • reply + /marry
  • предложить встречаться @username
  • предложить брак @username
Важно
  • Срок ответа на предложение: 24 часа.
  • В `мои отношения` и `/relation` бот показывает текущий статус, партнёра, кулдауны и inline-кнопки действий.
  • `браки` показывает все активные браки беседы и их длительность.
Действия стадии пары
группа

Для пары доступны ежедневные или периодические действия, которые поднимают уровень отношений. Часть из них есть только до брака.

Команды
  • /care
  • /date
  • /gift
  • /support
  • /flirt
  • /surprise
Триггеры
  • забота
  • свидание
  • подарок
  • поддержка
  • флирт
  • сюрприз
Важно
  • `/flirt` и `/surprise` работают только на стадии пары.
  • Кулдаун на relation-действия составляет 30 минут, а точный остаток видно в `/relation`.
После свадьбы
группа

У брака остаётся базовый набор действий, но вместо флирта и сюрприза открываются собственные механики любви и клятвы.

Команды
  • /love
  • /care
  • /date
  • /gift
  • /support
  • /vow
Триггеры
  • любовь
  • забота
  • свидание
  • подарок
  • поддержка
  • клятва
Важно
  • `/love` и `/vow` доступны только в браке.
  • Если вы ответили reply не своему партнёру, бот отклонит действие.
Как завершить связь
группа

Пара и брак закрываются разными командами. После брака связь супруга также убирается из семейного графа.

Команды
  • /breakup
  • /divorce
Триггеры
  • расстаться
  • развод

Семья, титулы и имя

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

Нейминг
группа

Нейминг задаёт локальное имя, которым бот будет называть вас именно в этом чате. Это влияет и на игры, и на упоминания в некоторых механиках.

Команды
  • /naming <имя>
Триггеры
  • нейминг
Примеры
  • /naming Лорд Теста
  • нейминг Котик
  • нейминг сброс
Важно
  • Имя должно быть длиной от 2 до 32 символов.
  • Сбросить нейминг можно словами `сброс`, `reset`, `off` и похожими командами.
Титулы
группа экономика

Титул показывает префикс рядом с вашим именем в пределах чата. Первая установка платная, дальше титул можно менять или снять.

Команды
  • /title
  • /title buy <текст>
  • /title set <текст>
  • /title clear
Триггеры
  • титул
Важно
  • Титулы должны быть включены настройками чата.
  • Если экономика отключена, купить или поменять титул не получится.
Усыновление, питомцы и семейное древо
группа reply по настройкам

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

Команды
  • /adopt @username
  • /pet @username
  • /family
  • /family @username
Триггеры
  • усыновить
  • стать питомцем
  • семья
Примеры
  • reply + /adopt
  • reply + /pet
  • /family @username
Важно
  • Если семейное древо отключено в чате, все три команды ответят отказом.
  • `/family` без аргумента показывает ваши связи, а с аргументом или reply — связи выбранного участника.

Социальные действия и мемы

Карма, reply-действия, 18+ фразы, объявления и маленькие рандомные команды для чата.

Карма
reply группа

Самый быстрый социальный сигнал: ответьте на сообщение знаком `+` или `-`, чтобы отдать голос кармы.

Триггеры
  • +
  • -
Важно
  • Карма учитывается в рейтингах и в `/rep`.
  • Лимиты и точная механика зависят от настроек чата.
Reply-действия без 18+
reply группа

Эти действия запускаются обычной фразой в ответ на сообщение участника. Бот генерирует готовую RP-реплику и упоминания.

Триггеры
  • шлепнуть
  • убить
  • ударить
  • обнять
  • поцеловать
  • пожать руку
  • дать пять
  • погладить
  • пощекотать
  • ткнуть
  • подмигнуть
  • потанцевать
  • поклониться
  • подбодрить
  • угостить
  • похвалить
  • дать кулак
Примеры
  • reply + обнять
  • reply + дать пять
  • reply + подмигнуть
18+ reply-действия
reply группа 18+ по настройке

Пикантные действия работают тем же способом, но отдельно завязаны на `actions_18_enabled`.

Триггеры
  • трахнуть
  • соблазнить
  • засосать
  • провести ночь с
Примеры
  • reply + трахнуть
  • reply + соблазнить
  • reply + провести ночь с
Важно
  • Если 18+ выключен, бот покажет прямой отказ и подскажет, какая настройка отвечает за доступ.
Объявления, подписка и чатовые мемы
группа текстовые фразы

Кроме строгих команд есть набор бытовых фраз: объявление с тегами, шипперинг, рандом «кто сегодня ...», статья дня и жмых для фото.

Команды
  • /article
Триггеры
  • объява
  • рег
  • анрег
  • шипперим
  • кто сегодня легенда
  • моя статья
  • статья
  • жмых
Примеры
  • объява "Собираемся через 10 минут"
  • рег
  • анрег
  • кто сегодня легенда
  • жмых 4
Важно
  • `объява` доступна только тем ролям, которым в чате разрешена эта команда.
  • `рег` и `анрег` включают или выключают ваш пинг в объявлениях.
  • `жмых` используется как подпись к фото: чем выше уровень 1..6, тем сильнее искажение картинки.

Текстовые аналоги и ограничения

Какие фразы заменяют slash-команды и почему бот иногда не реагирует даже на правильный ввод.

Основные текстовые триггеры
группа текстовые команды

Если в чате включены текстовые команды и русский locale, многие сценарии можно вызывать без `/`.

Триггеры
  • кто я
  • помощь
  • бот
  • актив 10
  • топ неделя 15
  • баланс
  • магазин
  • рынок
  • отношения
  • семья
  • нейминг Имя
Важно
  • Администраторы могут включить кастомные алиасы или полностью отключить стандартные текстовые триггеры.
  • Отдельно от общего текстового роутинга обрабатывается только нейминг; остальные текстовые фразы и их slash-аналоги зависят от того, пропускает ли чат этот маршрут.
Почему команда не сработала
проверка

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

Как использовать
  • Проверьте, где должна работать команда: в группе, в личке или только по reply.
  • Убедитесь, что нужная механика включена в чате: экономика, титулы, семейное древо, 18+ режим, текстовые команды.
  • Если это игра со скрытой ролью, откройте ЛС с ботом и нажмите Start.
  • Если команда ранговая, бот обычно прямо пишет ваш текущий ранг и какой требуется.
Важно
  • Для модерации, настройки, алиасов, смарт-триггеров и кастомных RP-действий есть отдельная админская документация `/app/docs/admin`.