SourceTrigger Guide

Для настройки параметров модуля используйте команду: .cfg SourceTrigger

Перейдите в канал, где будут храниться ваши триггеры и медиафайлы, и отправьте команду: .tsetsource
Также можно указать ID или юзернейм чата аргументом, например: .tsetsource @my_channel_triggers

Вам доступны следующие опции для кастомизации поведения юзербота:
• source_channel_id — ID канала-источника (донора), где хранятся триггеры и медиа. Начинается с -100.
• auto_parse_on_start (по умолчанию True) — автосканирование канала при старте или обновлении модуля.
• trigger_in_channels (по умолчанию False) — реагировать на триггеры при отправке в каналы.
• trigger_in_groups (по умолчанию True) — реагировать на сообщения в группах/супергруппах.
• trigger_in_pm (по умолчанию True) — реагировать на сообщения в личных сообщениях (ЛС).
• max_delay (по умолчанию 3.0 сек) — защита от спама после лагов интернета. Сообщения старше указанного времени игнорируются.

1. Отправьте в канал-источник сообщение с контентом (картинка, гифка, видео, аудио или текст).
2. Ответьте (Reply) на это сообщение текстом триггера, например: ~привет.
Модуль автоматически перехватит и сохранит триггер. Если этого не произошло, выполните команду .tparse для принудительного сканирования всего канала.

В любом чате:
1. Сделайте ответ (Reply) на сообщение с нужным контентом (текст или медиа).
2. Отправьте команду: .tadd <формат_триггера> (например, .tadd ~тест).
Бот перешлет контент в канал-источник, привяжет триггер и удалит вашу команду.

Сработает, только если сообщение пользователя полностью совпадает с триггером (без учета регистра).
• Триггер: ~привет
• Сработает на: привет, Привет

Сработает, если триггер содержится внутри текста сообщения.
• Триггер: ~~привет
• Сработает на: всем привет ребята, приветики

Точное совпадение, но после отправки ответа бот удалит исходное сообщение пользователя. Ответ всегда отправляется новым сообщением.
• Триггер: ~~~!тест
• Сработает на: !тест (и удалит его)

Сработает, если сообщение удовлетворяет правилам регулярного выражения.
• Триггер: ~|хочу \d+ бананов
• Сработает на: хочу 5 бананов, хочу 100 бананов

Срабатывает по регулярному выражению, отправляет ответ новым сообщением, а исходное сообщение пользователя удаляет.
• Триггер: ~~~|купить \d+
• Сработает на: купить 12 (и удалит его)

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

• \d+ — одна или более цифр (например, 5, 42).
• \w+ — любые буквы или цифры.
• . — любой одиночный символ.
• .* — любое количество любых символов.
• ? — делает предыдущий символ необязательным.
• [а-яА-Я]+ — любое русское слово.
• | — логическое "ИЛИ" (например, ~|(да|нет) сработает на да или нет).

Если вы хотите отключить срабатывание триггеров в конкретном чате:
• Отправьте в нужном чате команду .tignore (она добавит или удалит текущий чат из списка исключений).
• Вы также можете управлять списками удаленно, передав ID чата: .tignore <ID_чата>.

Помогает проверить, какой триггер сработает на определенную фразу:
.tsearch <текст_запроса>
Бот сымитирует отправку этого сообщения, найдет подходящие триггеры и выведет список со ссылками на сообщения-источники.

Вставляйте эти переменные в текст ваших триггеров, и бот заменит их при отправке:
• {hour}, {minute}, {second} — текущее время.
• {day}, {month}, {year} — текущая дата числом.
• Месяцы на русском: {month_short_lower} (июн), {month_full_title} (Июнь), {month_full_upper} (ИЮНЬ).
• Дни недели на русском: {weekday_num} (1-7), {weekday_short_title} (Вс), {weekday_full_lower} (воскресенье).

• {owner_username} — ваш юзернейм в Telegram.
• {cur_chat_name} — название текущего чата или имя собеседника.
• {cur_chat_username} — юзернейм чата (если публичный).
• {reply_username} — юзернейм пользователя, на чьё сообщение ответили.
• {reply_firstname} — имя этого пользователя.
• {reply_lastname} — фамилия этого пользователя.

• {total_triggers} — общее количество сохраненных триггеров.
• {sent_count} — сколько раз юзербот ответил на триггеры с момента установки.
• Кастомные плейсхолдеры Heroku: поддерживаются переменные, зарегистрированные другими вашими модулями (например, {uptime}, {now_playing} и др.).

Если данные получить не удалось, укажите резервный текст через двоеточие: {плейсхолдер:значение}.
Пример использования:

«Привет, {reply_firstname:друг}! Сейчас {hour}:{minute}, за окном {weekday_full_title}. Ты пишешь в чат {cur_chat_name}.»

Данные хранятся локально в файле sourcetrigger_data.json в папке установки модуля.
Для обеспечения отказоустойчивости на хостингах с эфемерной файловой системой (например, Heroku), база дублируется в системную базу данных Хероку (self.db). При удалении или сбросе файла JSON все триггеры автоматически восстановятся из бэкапа.