Панель открывается по адресу https://marki-cm.online. Backend слушает только 127.0.0.1:7878, а Caddy принимает внешний HTTPS. В Compose backend-порт не публикуется. Настройте DNS и сертификат по SECURITY-PATCH.md из обновления.

В ЛС бота зарегистрируйте собственную учётную запись одним сообщением:

веб регистрация ваш_логин
ВашСобственныйПароль123!

Придумайте собственный пароль от 12 символов. Логин и защищённый хеш пароля связываются с Telegram ID отправителя. Пароль не показывается в ответах, а бот пытается удалить сообщение с учётными данными. Смена пароля: веб пароль НОВЫЙ_ПАРОЛЬ, логина: веб логин новый_логин; завершение всех сессий: веб выход. Настройка аккаунта — только в ЛС.

Панель показывает известные боту группы, где вы имеете ранг выше 0 или Telegram-админские права. В ней есть поиск участников, метки риска, ранги, наказания, профиль группы, правила, приветствие, защита, журнал и форма всех команд. Агент Марки из реестра поддержки видит также операторские функции: марки, локальные метки, обращения, возвраты, покупки и наследство.

Назначение рангов и Telegram-администраторов не требует регистрации WebUI. Учётная запись обязательна только операторам для их операторских команд. Администраторы создают её по желанию, когда хотят пользоваться браузерной панелью. Telegram-владение не передаётся через WebUI. Каждый запрос и исполнение команды заново проверяют права пользователя.

Обновление базы: обновить чат с ранга 5. Бот получает администраторов и перепроверяет все известные ID. Автоматический учёт запускается при входе/назначении самого бота и по новым событиям членства. Полный список группы через Bot API недоступен. Для известного числового ID молчащего участника есть добавить участника в базу ID с проверкой принадлежности группе.

HTTP по IP не шифрует обмен; используйте доверенную сеть, а для доступа из Интернета подключите HTTPS. Подробное руководство по WebUI находится в marki-bot/WEBUI.md в архиве выпуска.

Для участника

Откройте бота и отправьте /start. В главном меню есть кнопки для марок, РП, семьи, игр, администрации и справочника. Оператор видит дополнительную кнопку своего раздела.

Попробуйте по одной команде:

профиль
баланс
ачивки
рп каталог

В группе можно написать:

угостить кофе @user

Вместо @user укажите реального участника, которого бот уже знает, либо отправьте команду ответом на его сообщение. Отображаемое имя человека и его @username — разные вещи: произвольное имя без упоминания не определяет получателя.

Для владельца группы

Добавьте бота в группу, выдайте ему Telegram-права для нужных действий и отправьте /start. Владелец группы получает ранг 5 автоматически по текущему статусу в Telegram.

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

+модер 2 @moderator
+модер 5 @chief
ранг переименовать 5 Созидатель

Затем настройте правила, приветствие и защиту. Готовые многострочные примеры есть в конце статьи.

Ранг бота и права самого бота в Telegram проверяются отдельно. Ранг позволяет человеку обратиться к функции, но не даёт боту возможность удалять сообщения или банить без соответствующих Telegram-разрешений.

Префиксы

Обычно достаточно обычного текста. Следующие варианты равнозначны:

баланс
!баланс
.баланс
/balance
Марки баланс

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

Для обращения к конкретному боту в группе используйте, например, /balance@marks_cm_bot. Неизвестную команду без префикса бот обычно оставляет без ответа; неизвестная команда с префиксом вызывает подсказку.

Знак + или - в названии — часть команды, а не украшение. Например, +ссылки разрешает ссылки, а -ссылки запрещает их.

Как выбрать человека

Есть три основных способа:

Telegram-упоминание человека через сущность сообщения также поддерживается. Для @username и id:… в обычных командах пользователь должен быть известен локальной базе. Простое знание числового ID не регистрирует неизвестного человека.

В командах с целью удобнее указывать её явно. Если одновременно есть ответ и @username в тексте, сначала выбирается явно указанная цель.

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

Сроки и номера

Срок задаётся одним числом и одной единицей:

10 минут
2 часа
7 дней
1 неделя
1 месяц
1 год

Месяц в расчётах — 30 дней, год — 365 дней. Составные сроки вроде 1 час 30 минут не поддерживаются: пишите 90 минут. Допустимый диапазон зависит от функции: напоминание — до 30 дней, наказание или отложенная команда — до года.

Номера наград, жалоб и заявок берите из ответа бота. Для единственного предложения брака достаточно брак принять; несколько предложений выбираются кнопкой. Старый синтаксис брак принять 17 тоже поддерживается, без символа #.

Номер платёжной операции CHARGE_ID и код чека — строки, а не эти числовые номера. Используйте их в том виде, в каком их выдал бот.

Переносы строк

Для правил, заметок, причин и шаблонов важен настоящий перенос строки. В таблицах ниже символ ↵ означает: нажать Enter и продолжить текст в том же сообщении. Сам знак ↵ отправлять не нужно. Точка с запятой между примерами означает разные сообщения.

мут 10 минут @user
Повторная реклама после предупреждения.

Нельзя заменять перенос двумя символами \n: это обычный текст, а не новая строка.

Стандартная лестница

Названия можно изменить. Переименование не меняет права. Личное звание +звание Герой и должность должность участника @user Хранитель тоже не повышают ранг.

Кто управляет пятым рангом

Текущий владелец Telegram-группы автоматически имеет ранг 5 и старшинство 1000. Он может выдать другому человеку назначенный ранг 5 со старшинством 500:

+модер 5 @user

Назначенный участник получает высшие права бота, но не становится владельцем Telegram. Он может назначать младшие ранги, однако не может выдавать пятый, снимать другого участника с пятым или менять ранг владельца.

Только Telegram-владелец:

• выдаёт, снимает и меняет назначенный ранг 5;
• переименовывает общую должность ранга 5;
• применяет тему, меняющую названия всех стандартных рангов;
• выполняет снять всех подтверждаю;
• управляет реальными администраторами через +тг админ / -тг админ;
• подтверждает свой автоматический статус командой восстановить создателя.

Некоторые функции дополнительно проверяют владение сетью, кланом, кружком или конкретным Telegram-чатом. Наличие пятого ранга не заменяет такие проверки.

Своя должность с собственным ID

ранг добавить 7 2 Почтальон
ранг назначить 7 @user
ранг переименовать 7 Старший почтальон
ранг порядок 7 275

Здесь 7 — ID должности, 2 — уровень её прав. Допустимы ID 7–99; уровень прав 0–4. Число 6 зарезервировано для настройки «команда отключена» и не является рангом для назначения.

Порядок определяет старшинство внутри уровня. Для уровня 2 он находится между 200 и 299. У стандартного ранга 2 порядок 200, у нового по умолчанию 250. Можно назначать только участников и должности, которые младше исполнителя.

Доступ к командам

дк бан 3
дк кубы 6
+дк кубы

Первый пример поднимает порог бана до ранга 3. Второй выключает кубы в группе. Третий возвращает исходный порог кубов.

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

В таблицах этой статьи указаны исходные минимальные пороги. Настройки конкретной группы могут требовать более высокий ранг или отключить команду. У оператора и владельцев есть дополнительные проверки внутри обработчиков.

Марки — внутренняя валюта этого бота. Личный кошелёк общий для его групп и ЛС. Семейные счета, казны кланов/кружков и резервы чеков/игр хранятся отдельно от свободного личного баланса.

Откуда берутся марки

Покупка за Stars

Курс: 1 Star = 10 марок. Это внутренний курс бота; стоимость приобретения самих Stars показывает Telegram.

В ЛС отправьте последовательно:

/terms
принимаю условия
купить марки 500

Каждая строка здесь — отдельное сообщение. Затем оплатите выставленный счёт через интерфейс Telegram. Марки зачисляются после события подтверждённой оплаты, а не после открытия счёта. Счёт связан с покупателем, пакетом и стоимостью; один и тот же платёж не должен начислять марки повторно.

Историю покажет мои покупки. Если есть проблема, создайте обращение:

/paysupport CHARGE_ID Оплата прошла, но марки не появились.

Возврат и долг

Возврат выполняет оператор. Telegram Stars возвращаются за всю выбранную покупку, а выданные по ней марки списываются.

Например, человек купил 500 марок, затем потратил 400, оставив 100. При возврате покупки бот снимает оставшиеся 100 и фиксирует 400 марок долга. Новые поступления сначала погашают долг. Пока долг есть, обычные расходы из кошелька блокируются.

Возврат не отменяет автоматически каждую ранее совершённую передачу или подарок. В реализации нет обратного обмена заработанных марок на деньги/Stars и нет команды вывода средств.

1. Общая локальная база риска

В боте есть локальная таблица отметок пользователей. В ней хранится:

База общая для всех групп этого экземпляра бота. Отметка привязана к ID, поэтому смена username её не снимает. Две категории могут существовать одновременно. Записи не имеют автоматического срока истечения.

Названия имеют такой смысл:

• Антиспам — ручная метка spam, например за повторную рекламу.
• Антискам — ручная метка scam, например за поддельный магазин.

Бот сам не решает по тексту сообщений, что человек мошенник. Он не анализирует сделки, не оценивает надёжность внешнего сайта и не получает закрытые базы Iris. Отсутствие метки означает только отсутствие записи здесь, а не подтверждение безопасности человека.

2. Кто добавляет и снимает отметки

Только действующий Агент Марки:

антиспам добавить @user Повторная рекламная рассылка
скам добавить @user Выдаёт себя за владельца магазина

Для удаления:

антиспам удалить @user
скам удалить @user

Первая команда удаляет только spam, вторая — только scam. Чтобы полностью очистить пользователя с двумя отметками, выполните обе. Повторное добавление выбранного типа заменяет его причину, оператора и время.

Обычный владелец группы и назначенный ранг 5 не получают доступа к этой базе, если они отдельно не назначены Агентами проекта.

3. Как посмотреть отметки

Любой участник может проверить известного пользователя:

проверить спам @user
проверить скам @user

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

Отдельной команды для выгрузки всех пользователей базы в текущей версии нет. Команда мой спам тоже не является списком меток: это старое название просмотра ваших активных банов, доступного в ЛС.

4. Проверка при обычном входе в группу

Администратор с рангом 3+ включает в нужной группе:

+антиспам

При входе участника с spam и включённом антиспаме бот исключает его через Telegram и объявляет об обнаружении спамера. Ограничение на один час для этой метки больше не используется. Для scam при включённом антискаме выводится предупреждение и рекомендация не совершать переводы; сама SCAM-метка не приводит к исключению. Нужны права бота на бан. Telegram-владелец и Telegram-администраторы защищены от исключения ботом.

Выключение:

-антиспам

Выключение относится только к группе и не удаляет отметки из общей базы. В 6.0 категории разделены: +антиспам / -антиспам управляют SPAM, +антискам / -антискам — SCAM. В 7.0 SPAM приводит к исключению и объявлению в чат; SCAM — к предупреждению, без исключения только за эту метку. При обновлении защита однократно включается во всех существующих группах; в новых включена по умолчанию.

После выдачи SPAM-метки бот также пытается исключить человека из всех известных активных групп с включённой защитой. SCAM-метка вызывает предупреждение в таких группах при включённом антискаме. Полное перечисление неизвестных участников через Bot API не выполняется. Временные ошибки исключения ставятся на ограниченные повторные попытки; при нехватке прав бот сообщает о проблеме.

Совпадение автора события и вошедшего не пропускает проверку SPAM/SCAM. Повторные события входа дедуплицируются. Работа защиты всё равно зависит от получения ботом событий Telegram и наличия необходимых прав.

Автоматические баны этого входного фильтра не добавляются в обычную таблицу санкций бота. Они могут не появиться в банлист и не попадут в его массовую амнистия. Для ручного снятия используйте разбан @user либо интерфейс Telegram, с учётом обычных правил прав и старшинства.

5. Проверка заявок на вступление

Автоматическая обработка заявок включается отдельно:

+автозаявки
+антиспам

Отклонение заявки — отдельное действие, не часовой бан. Оно не удаляет отметку. Нужны Telegram-права бота на обработку заявок и сами события заявок.

Обработчик заявок сейчас не применяет +минрег и запрет входа ботов -боты. Эти настройки проверяются в отдельном обработчике обычного входа. Поэтому не стоит включать автозаявки с ожиданием, что они используют все фильтры группы.

6. Безопасные переводы

Настройка безопасных переводов включена по умолчанию; посмотреть или включить её можно командой:

+безопасные переводы

Перед обычным переводом бот проверяет получателя: SPAM запрещает перевод, SCAM требует отдельного подтверждения отправителя. Эти проверки обязательны для текущего обработчика перевода и не обходятся выключением личного переключателя. До подтверждения SCAM-перевода списания нет; намерение действует 5 минут и связано с отправителем, получателем, суммой и чатом.

дать марки 100 @user

Проверка:

• касается получателя, а не отправителя;
• действует для обычного денежного перевода, включая его сокращения;
• не зависит от того, включён ли +антиспам в конкретной группе;
• не является общей проверкой каждого чека, подарка, биржевой операции или семейного действия.

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

Запретить входящие переводы от человека — другой механизм:

запретить переводы @user

Эта команда не заносит человека в спам-базу: она меняет только ваши настройки получения марок.

7. Фильтр ссылок — отдельная защита

-ссылки
-сайты
-теги
-чаты
-боты

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

Фильтр смотрит текст, подпись медиа и скрытые ссылки Telegram. При запрещённом домене сообщение удаляется целиком и появляется запись в журнале. Само удаление ссылки не выдаёт варн и не создаёт метку риска.

Участники с рангом бота выше 0 обходят этот текстовый фильтр. Владелец имеет ранг 5 автоматически. Telegram-администратор без назначенного ранга бота не получает такого исключения только из-за статуса администратора.

Исключение домена:

разрешить ссылку https://example.com

Оно относится к точному имени домена. sub.example.com нужно разрешать отдельно. Бот не проверяет содержимое разрешённого сайта и безопасность его владельца.

Фильтр не распознаёт все возможные способы записи ссылки: например, произвольный голый домен без протокола/www., обходные написания и простой @username не являются универсально обнаруживаемыми ссылками.

8. «Минимальная регистрация»

+минрег 3
минрег
-минрег

Число — минимум дней с первого появления у этого бота, а не возраст Telegram-аккаунта. Если бот впервые видит старый Telegram-аккаунт сегодня, для него это всё равно новое знакомство.

Настройка проверяется в обработчике обычного входа и может отклонять новых для бота участников часовым баном. Она зависит от получения события Telegram; проверки локальных SPAM/SCAM-меток описаны отдельно выше.

9. Жалоба не равна метке

Последовательность работы администрации может быть такой:

1. Участник отправляет репорт @user Причина.
2. Модератор открывает репорты, изучает сообщения и контекст.
3. При необходимости выдаёт местный варн, мут или бан.
4. Оператор отдельно решает, нужна ли общая метка spam / scam.
5. После проверки модератор закрывает жалобу: репорт закрыть 8.

Сам репорт не включает автоматическое наказание и не меняет общую базу. В коде нет автоматического определения флуда по частоте всех сообщений, проверки вредоносных файлов или интеллектуального распознавания мошенничества.

Агент — пользователь из постоянного реестра поддержки. При первом запуске настроенные OWNER_IDS переносятся в реестр. Первый ID — защищённый владелец проекта; он управляет составом Агентов через WebUI или +агент / -агент. Снятые Агенты не получают права снова после перезапуска. Владелец группы и оператор — разные статусы; у одного человека могут быть оба.

Глобальная роль оператора сама по себе не назначает ранг 5 в чужих группах и не открывает все действия местной модерации. Настройка доступа команды в группе может также выключить её даже для оператора.

Основные операторские действия

Владелец проекта назначает и снимает Агентов через +агент @user / -агент @user либо WebUI. Новый Агент сначала создаёт WebUI-учётную запись в ЛС. Консоль сервера существует только в WebUI владельца, выключена по умолчанию и требует кода, повторного пароля и настраиваемого защищённого транспорта. Произвольного исполнения shell из Telegram нет. Пакеты и курс задаются в коде/настройках.

Сценарий: проверка обращения об оплате

Откройте обращения оплаты, сопоставьте номер обращения с указанным покупателем и идентификатором оплаты. Если принято решение о возврате, выполните возврат покупки CHARGE_ID. Это денежное действие; повторно уже возвращённую покупку команда не возвращает. Затем закройте обращение по его номеру, а не по CHARGE_ID.

Сценарий: наследство

Пользователь заранее назначает наследника через +завещание @user. Наследник в ЛС подаёт вступить в наследство @owner. Оператор рассматривает заявку и подтверждает её только после проверки обстоятельств и владельца. Переводится текущий личный баланс; Telegram-владение, роли групп и имущество в иных механиках автоматически не передаются.

До следующего обновления прежние марки называются тыковками. Это тот же баланс, те же покупки и курс, без конвертации и обнуления. Telegram-эмодзи валюты: 5298569611111848065; если Telegram отклоняет кастомный эмодзи, сообщение повторяется с обычным 🎃. Для возврата прежних названий задайте HALLOWEEN_MODE=0. Старые команды с «марками» и новые с «тыковками» работают параллельно.

Ферма использует семечки 🌱 — отдельную бесплатную валюту. ферма, ферма помощь, ферма магазин, ферма собрать, ферма бонус. Земля, амбары, курицы, коровы и мельницы увеличивают производство; амбар вмещает 10 куриц и 4 коровы. Амбары/мельницы занимают участки. Покупка автоматически собирает старый доход за целые часы и начинает новый час роста; новая покупка не увеличивает доход задним числом. После простоя накапливается максимум 24 часа. Прокачка даёт опыт и уровни, мельница открывается на уровне 3.

орел 20 / решка 20 и казино 20 — ставки только в семечках, без вывода и обмена на тыковки/Stars. Платная валюта не создаётся фермерством и играми. Одиночные старые кубы остаются бесплатным броском без денежной выплаты.

У браков есть GIF, кнопки принятия/отклонения и команда брак принять без номера, если входящее предложение одно. При нескольких используйте брак предложения и кнопку конкретного предложения. Получатель принимает, автор отменяет, чужие кнопки не передают права. РП выполняются сразу; личные блокировки и выключение получения действий остаются. Добавлено 18 запрошенных действий и 5 дополнительных романтических без графических сексуальных описаний.

Бот объявляет о выходе участника с упоминанием. Сервисное сообщение и chat_member одного события не создают два объявления. Выключение: -выходы, включение: +выходы. Bot API по-прежнему должен доставлять события, бот должен иметь нужные права.

SPAM при включённой защите: исключение сразу при входе или после выдачи отметки известному активному участнику, плюс объявление. Telegram-администраторов бот исключить не может; при нехватке прав появляется объяснение. SCAM: предупреждение при входе/выдаче отметки, рекомендация отказаться от сделок. Перевод скамеру сначала создаёт предупреждение с кнопками; подтвердить его может только отправитель в том же чате и в течение 5 минут. Заморозка карты, баланс, долг и новые SPAM-метки проверяются повторно. Повторная кнопка деньги не списывает. Это локальная база проекта, не закрытые базы Telegram/Iris и не автоматическое распознавание всех мошенников.

Оригинальные GIF используются для свадьбы, урожая и переводов. BOT_GIFS=0 выключает их. Если GIF нельзя отправить в группу, бот пробует отправить текст и кнопки. У длинной подписи приоритет у текста. Кнопки работают через обычные проверки команд, без обхода рангов и приватности.

У каждого известного боту участника есть виртуальная карта с уникальным номером. карта отправляет персональную PNG-картинку, реквизиты показывает номер, баланс — доступные марки, выписка — денежный журнал. Кошелёк остаётся прежним: миграция не меняет существующие балансы и не начисляет новых марок.

перевод 100 @user / дать марки 100 ответом и на карту 100 9900000000000000 выполняют перевод. Получатель должен быть известен боту. Квитанция содержит отправителя, получателя, последние четыре цифры обеих карт, сумму, нулевую комиссию, статус, номер операции и время МСК. Повторное Telegram-событие не повторяет списание. Номера относятся только к внутренним картам проекта.

карта заморозить останавливает личные списания; карта разморозить возвращает их. Входящие поступления и обязательные возвраты остаются возможны. Все новые пользователи получают пустую карту. Полный список неизвестных участников через Bot API по-прежнему недоступен.

В 6.0 антиспам, антискам и безопасные переводы однократно включаются для всех существующих записей, включая прежние выключенные настройки. Затем ими можно управлять обычными командами. Новые чаты и пользователи получают включённую защиту по умолчанию. Антискам проверяет локальные служебные отметки, не определяет мошенников автоматически по любому тексту.

WebUI полностью переоформлен: тёмная тема, анимации с поддержкой reduced motion, обзор со статистикой, поиск сверху, Марки Банк, выписки, переводы и отдельный раздел Агентов. Первому OWNER_IDS доступно назначение/снятие поддержки. Рядовой Агент не управляет составом и не получает серверную консоль. Регистрация по-прежнему не нужна для назначения администратора чата, но нужна для входа в WebUI.

Консоль владельца: настройте сервер по CONSOLE.md, введите в поиске > СЕКРЕТНЫЙ_КОД и подтвердите пароль WebUI. Это локальная PTY-оболочка с правами процесса, без повышения до root. Максимум 5 минут; Публичная веб-консоль отключена и закрыта proxy; для приватного доступа обязательны HTTPS и отдельный IP allowlist. Старый флаг OWNER_CONSOLE_REQUIRE_HTTPS=0 больше не разрешает HTTP. Секрет никогда не добавляется в URL. Консоль отключена до явного включения в .env.

Администрация с ранга 3 задаёт цену: вип 500 — 500 марок за 30 дней. вип 0 выключает продажи. Без настроенной цены продаж нет. купить вип покупает статус только для текущей группы, подарить премиум @user оплачивает его другому участнику. Продление добавляет 30 дней к оставшемуся сроку. Вся сумма поступает в кубышка, без создания новых марок. Старые оплаченные VIP сохраняют оставшийся срок; их прежние платежи в кубышку повторно не начисляются.

Эксклюзивы: отдельное имя, значок и подпись РП, 6 эффектов, ещё 50 личных шаблонов для текущего чата и статистика за 7 дней. Начните с премиум помощь. PREMIUM не выдаёт модераторских прав. После истечения оформление и дополнительные действия выключаются, шаблоны остаются сохранены.

кубышка история доступна с ранга 3. кубышка выплатить 100 @user доступна только настоящему Telegram-владельцу группы, списывает существующие средства и пишет журнал. Назначенный ранг 5 не позволяет выводить кубышку.

Только Агенты выдают +олд @user, +разраб @user, +основатель, +дизайнер, +тестер, +меценат, +легенда, +помощник. Снять — тот же вариант с минусом. ачивки @user показывает отметки во всех группах. «🕵️‍♂️ Агент Марки» возникает из настоящего операторского доступа, а не произвольного звания.

агенты и помощь показывают активность Агента по всем чатам, ЛС и WebUI; зелёный статус означает действие за последние 5 минут. Это не точный онлайн Telegram. кто спам показывает известных участников этого чата с красными SPAM/SCAM-пометками и указанием, остались ли они в группе; кто скам фильтрует SCAM.

Бесплатная выдача платной валюты через бонусы и одиночные кубы отключена. Ферма и новые игры начисляют только отдельные бесплатные семечки. Новые марки появляются после оплаты Stars; служебная выдача оператором сохранена для корректировок с журналом. Переводы и выплаты из внесённых резервов остаются.

Встроенные действия бесплатны. Любое действие адресуется другому человеку в группе; можно использовать ответ или известный username. Для просмотра набора в ЛС есть /rp, но сами действия работают в группе.

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

угостить кофе @user
прикрыть щитом @user
поцеловать @user

Все РП-действия выполняются сразу, без подтверждения получателем. Старые ожидающие запросы отменяются при обновлении и не проигрываются заново. Имена автора и цели — ссылки-упоминания Telegram. Уведомление на устройстве зависит от настроек Telegram: бот не может принудительно включить push.

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

Личный шаблон

мой рп создать помахать шляпой | дружба
🎩 {автор} приветствует {цель} и машет шляпой. {комментарий}

Использование:

помахать шляпой @user Хорошего дня!

Личные шаблоны использует только автор, до 50 на человека; выполняются сразу без запроса. Личные шаблоны имеют приоритет над одноимёнными шаблонами чата, затем идёт встроенный набор.

Шаблон всей группы

+мрп встречать у ворот | приключения
🏰 {автор} открывает ворота для {цель}. {комментарий}

Создание доступно с ранга 3; до 200 шаблонов на чат. Название — до 40 символов, текст — до 1000. Обязательны {автор} и {цель}, необязателен {комментарий}. Комментарий пользователя — до 300 символов.

Категория после | необязательна; по умолчанию дружба. Нельзя перекрывать служебные команды. Романтическое встроенное имя нельзя превратить в дружеское переопределением. Для произвольного нового шаблона чата категорию выбирает модератор; пользователь может выключить получение РП или заблокировать отправителя.

Это игровая семья внутри конкретного чата, не юридическая регистрация брака. На одного участника — один действующий брак в данной группе. В другой группе могут быть независимые пары.

Свадьба

Первый участник:

брак предложить @user
Давай создадим наш уютный дом.

Получатель, увидев номер предложения:

брак принять 17

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

Общие решения

Изменение семейного имени, описания, дома, выплату и свидание подтверждает второй супруг:

семья фамилия Почтовые
семья принять 8

Первая команда создаёт запрос. Вторую отправляет другой супруг, используя номер, выданный ботом. До 5 ожидающих решений одновременно; срок сутки.

Как считаются доли

Предположим, Аня внесла 100, Борис — 300. На семейном счёте 400 марок; остаточные доли — 100 и 300.

Если Аня запросила выплату 150, а Борис подтвердил, Аня получает 150. Сначала расходуется её доля 100, затем 50 из доли Бориса. На счёте остаётся 250; доли — 0 у Ани и 250 у Бориса. Именно они вернутся при разводе, если до него ничего больше не изменится.

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

Подарки и свидания

Каждый семейный подарок даёт 5 опыта, между подарками одного дарителя нужно ждать 30 секунд.

Подтверждённое свидание даёт 30 опыта. семья день добавляет 10 опыта раз на семью за день по МСК; обычные марки за него не начисляются. Уровень семьи рассчитывается как 1 + целая часть опыта / 100.

Развод и приватность

развод показывает расчёт. развод подтверждаю завершает брак по заявлению одного супруга и возвращает оставшиеся доли. История сохраняется; повторный возврат долей невозможен.

семья приватность закрыть скрывает подробную карточку от посторонних. Открытие требует общего решения. Это не удаляет уже опубликованные сообщения. В закрытой семье автоматическое публичное поздравление с годовщиной не отправляется.

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

профиль — компактная анкета: должность, ранг, сообщения текущего чата, брак, клан, достижения и уровень. Уровень профиля — 1 + целая часть количества сообщений в этом чате / 100; уровень семьи по-прежнему растёт за каждые 100 опыта. Эти показатели не дают модераторских прав. Возраст перенесённого брака не придумывается. Скрытый кошелёк не показывается другим.

профиль настройки — видимость анкеты и кошелька, личный режим РП, романтика и блокировки. Кнопки настроек привязаны к владельцу. Звуками и пушами управляет сам Telegram: кнопка уведомлений объясняет, где их настроить.

баланс показывает текущий остаток, долг, зарезервированные собственные ставки и три последние операции. В магазине действует цена PREMIUM текущего чата. Подарок сначала показывает подтверждение и привязан к текущей семье; смена супруга делает старую кнопку недействительной. Реальную оплату Stars, как и раньше, нужно подтвердить в окне счёта Telegram. В магазине пакеты сначала показывают предложение без создания счёта; затем «Оплатить» создаёт счёт в ЛС. Команда купить марки 500 по-прежнему сразу отправляет счёт после проверки согласия с условиями.

игры открывает действующие игры, ферму и розыгрыши. Кнопки парных вызовов привязаны к конкретной игре и адресату. Ставка соперника не резервируется заранее: она списывается при принятии. Турниры и отдельные накопительные цели дома из примера макета не добавлены как игровая механика; интерфейс показывает реальные доступные функции.

В каждой таблице «Доступ» означает исходный минимум: 0+ — любой участник, 1+ — ранг 1 и выше и т. д. «Группа/ЛС» означает, что регистрация обработчика допускает оба места, но конкретное действие может иметь более строгие ограничения, описанные справа. Например, история покупок — только ЛС, сами РП — только группа.

Примеры с @user, номерами и кодами — шаблоны: замените значения своими. ↵ — перенос внутри одного сообщения; ; — разные примеры.

Разделы каталога: Основы · Анкета · Марки · Покупки · Оператор · Защита · Ранги · Модерация · Чат · Активность · Награды · Игры · РП · Семья · Отношения · Кланы · Кружки · Заметки · Сети · Биржа · Наследство · WebUI

🧭 Основы

👤 Анкета

💰 Марки

⭐ Покупки

⚙️ Оператор

🛡 Защита

🎖 Ранги

⚖️ Модерация

🏡 Чат

📊 Активность

Быстрые текстовые оценки

Эти формы обрабатываются отдельно от реестра; отправляйте их ответом на сообщение:

Максимальная величина оценки: max(1, ранг×2), не более 100 по формату числа. На одного получателя — раз в сутки для каждого типа оценки. Самооценка запрещена. Для ЛС оценки не работают. Репутация и звёзды — разные счётчики.

🏅 Награды

🎲 Игры

🎭 РП

💍 Семья

💞 Отношения

Старая дружеская пара

Для дружеской пары используйте отношения предложить @user, затем получатель отвечает отношения принять @sender (либо ответом на отправителя). В этой старой механике нужен пользователь, а не числовой номер свадебного предложения. Предложение действует сутки. отн нет отклоняет дружеские предложения, отношения расторгнуть удаляет свою дружескую пару.

🏰 Кланы

🎬 Кружки

📝 Заметки

🌐 Сети

📈 Биржа

📜 Наследство

🌐 WebUI

Каждую строку можно использовать как отдельную команду. Вместо @user подставьте известного участника или отправьте только название ответом на его сообщение. Действие выполняется сразу, без запроса подтверждения; личные блокировки и выключение РП учитываются.

В шаблоне {автор} и {цель} заменяются именами. Комментарий можно дописать после цели; если для него нет подстановки в шаблоне, бот добавит его отдельной строкой. Все действия бесплатны.

Дружба · 51 действий

Романтика · 42 действий

Приключения · 30 действий

Быт · 30 действий

Праздник · 20 действий

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

Правила группы

+правила
🤝 Уважайте друг друга.
🚫 Не отправляйте спам и чужие персональные данные.
🛡 По вопросам модерации обращайтесь к администрации.

Приветствие

+приветствие
📮 Добро пожаловать, {имя}!
Загляни в правила и устраивайся поудобнее.

Наказание с причиной

варн 7 дней @user
Повторная реклама после просьбы остановиться.

мут 30 минут @user
Флуд, мешающий общению.

Награда с ограниченным сроком

наградить 2 удалить через 7 дней @user
🏅 За помощь новым участникам.

Степень 2 требует соответствующего ранга или отдельного допуска награждающего. Срок начинается после выдачи.

Личная заметка

заметка Покупки
Чай
Кофе
Печенье

Читать: заметка Покупки. Редактировать:

~заметка Покупки
Чай
Кофе
Печенье
Молоко

Заметки принадлежат автору и текущему чату. При вызове в группе ответ видят её участники; для личных записей удобнее ЛС.

Обычное напоминание

таймер 20 минут
💧 Пора выпить воды и немного размяться.

Этот таймер публикует текст, не запускает его как команду.

Отложенная команда

таймер через 10 минут
пинг

таймер на 01.12.2026 18:00
пинг

Отложенные команды работают в группе с ранга 1. При исполнении снова проверяются присутствие автора и права. Некоторые действия исключены из планировщика: сами отложенные команды, покупка марок, возврат оплаты, операторская выдача, создание/назначение/удаление рангов, массовое снятие, амнистия, кик неактивных и биржа. Не используйте планировщик как обход проверок.

Триггер

+триггер доброе утро
☀️ Доброго утра! Пусть день будет спокойным и тёплым.

Сработает на точную фразу доброе утро без различий регистра. Это сохранённый ответ, а не цепочка выполняемых команд.

Опрос

опрос Какой фильм смотрим вечером?
Комедия
Фантастика
Приключения

Кружок

кружок создать Вечернее кино
Смотрим фильмы и обсуждаем любимые сцены.

Предложение брака

брак предложить @user
💍 Давай создадим нашу маленькую почтовую семью.

«Бот не понимает @username»

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

«Мне выдали Telegram-администратора, но команда запрещена»

Telegram-права и ранги бота независимы. Владелец должен назначить вам нужный ранг через +модер. Автоматически ранг 5 получает только текущий Telegram-владелец.

«Я оператор — почему не могу забанить человека?»

Операторские полномочия дают доступ к обслуживанию валюты, платежей, локальных меток и наследства. Для местных наказаний нужен соответствующий ранг в данной группе; у самого бота должны быть Telegram-права.

«Почему нельзя наказать другого администратора?»

Обычные наказания бота защищают самого исполнителя, равных/старших по порядку и Telegram-администраторов. Отмена чужого наказания дополнительно учитывает старшинство его автора. Это не обходится простым переименованием должности.

«Почему антиспам не удаляет повторяющиеся сообщения?»

В текущей версии +антиспам включает проверку вручную поставленных меток при входе/заявке. Общего счётчика флуда, автоопределения рекламы и автоматической постановки меток нет. Для текста со ссылками существует отдельный фильтр.

«Отмеченный человек уже в группе — его сразу выгонит?»

Для SPAM бот сразу пытается исключить отмеченного пользователя из известных активных групп с включённым антиспамом. Для SCAM отправляет предупреждение при включённом антискаме. Нужны права Telegram; администратора Telegram исключить нельзя. Перевод получателю с SPAM запрещён, а SCAM-перевод требует отдельного подтверждения отправителя.

«Снял метку — почему человек всё ещё заблокирован?»

Удаление записи из базы не вызывает Telegram-разбан. Если бан ещё действует, снимите его отдельно с нужными правами. И наоборот, локальный разбан не снимает общую метку.

«Где мои марки: я внёс их в клан?»

Вклад ушёл из свободного личного кошелька в казну. Обратный вывод вкладов клана/кружка участниками не реализован. При удалении владельцем оставшаяся казна возвращается владельцу. Семейный счёт использует другую механику — учёт остаточных долей супругов.

«Шиппинг создал брак?»

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

«Сработает ли напоминание, когда компьютер выключен?»

Бот должен быть запущен и иметь доступ к Telegram. На компьютере сон, выключение или отсутствие сети мешают обработке; на сервере процесс также должен оставаться запущенным. Просроченные напоминания и задания обрабатываются после возобновления работы; права отложенной команды проверяются на момент её фактического исполнения.

«Есть ли данные о старых сообщениях, онлайне и всех участниках Telegram?»

Статистика строится по сообщениям и событиям, которые увидел бот. Он не импортирует всю старую историю, не определяет точные онлайн-статусы и не умеет произвольно перечислять неизвестных пользователей Telegram. Настройки видимости и Telegram-разрешения влияют на доступные события.

Зарегистрированные сокращения с ограничениями

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

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

Команды управления реакциями зарегистрированы, но успешное выполнение в настоящем Telegram зависит от поддержки используемых полей/методов API; наличие строки в справочнике само по себе не подтверждает работу внешнего вызова. Использование этих команд в живом Telegram в рамках подготовки статьи не проверялось.

Что именно входит в полноту статьи

Список сверён с текущим реестром обработчиков: все 338 групп команд присутствуют, все 859 зарегистрированных названий перечислены в строках или РП-каталоге. Все 173 встроенных РП-действия приведены со своим текстом и примером. Дополнительно описаны текстовые оценки +, -, +число, -число, *число, которые распознаются до обычного реестра команд.

Руководство составлено по исходному коду версии 7.1. Оно не содержит токенов, данных пользователей, платёжных идентификаторов реальных покупателей или содержимого рабочей базы. При следующем обновлении синтаксис, доступ и возможности могут измениться.