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

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

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

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

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

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

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

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

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

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

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

Мини-игра с тремя баннерами — Genshin Impact («генш»/«геншин»), Honkai: Star Rail («хср») и Zenless Zone Zero («ззз»/«зенлес»). Работает через внешний gacha-сервис бота, а не через обычную экономику напрямую.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Вопрос ассистенту начинается с `?` или `??`. `?` каждый раз начинает с чистого листа, `??` учитывает контекст прошлых `??` в этом чате.

Если админы включили ответы участникам и добавили кличку, любой участник может написать «Селя, что думаешь?» — кличка должна стоять в самом начале сообщения. Ответ на реплику Selara продолжает разговор.

Питомец отвечает, если написать ему по имени («Мурка, как дела?») или ответить на его реплику. Включено в чатах по умолчанию (админ может выключить настройку `pets_enabled`); завести питомца и ухаживать за ним можно бесплатно. Сам питомец пишет только при включённой `pets_spontaneous_enabled` (по умолчанию выключена; ночью по умолчанию молчит).

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

Подписка оформляется на конкретный чат командой `/premium` в личке с ботом (оплата Telegram Stars).

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

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