⏰ Планировщик поднятия лотов для Starvell — поднимайте товары в часы пик

Планировщик поднятия лотов — модуль StarvellBot, который поднимает ваши предложения на Starvell точно в заданное время по Москве, а не просто «как только сайт разрешит». Так поднятия приходятся на вечер, выходные и другие часы, когда покупателей больше всего, а не на 4 часа утра.

🚀 Возможности

• 🎮 Расписание по играм. На Starvell поднятие выполняется сразу для всей игры — со всеми её категориями. Поэтому единица расписания в модуле — игра.
• 🌍 Два режима:
  • Общее расписание — одно «время по умолчанию» для всех игр (любую игру можно исключить);
  • Индивидуальное — своё время для каждой игры.
• 📅 Пресеты в один клик: 2, 3, 4 или 6 поднятий в сутки с равными интервалами.
• ⏱ До 12 слотов на одну игру, точность — до минуты (проверка расписания каждые 20 секунд).
• 🧠 Слот не теряется из-за кулдауна. Если в плановое время Starvell ещё не разрешает поднятие, сайт сообщает, сколько ждать, — бот повторит попытку ровно тогда и дальше продолжит по графику.
• 📋 Журнал поднятий, ожиданий и задержек.
• 🔔 Уведомления об успешном поднятии и о слоте, который не удаётся выполнить больше 90 минут (приходят, только если в /menu → 🔔 Настройки уведомлений включено «Автоподнятие лотов» — см. часть 3).
• 🇷🇺 Московское время (UTC+3) — независимо от того, где работает сервер.

🔗 Как планировщик сочетается с обычным автоподнятием

В StarvellBot есть встроенное 📈 Автоподнятие лотов (/menu → ▶️ Далее), которое поднимает все игры раз в заданный интервал.

• Игры под расписанием планировщик забирает себе — обычное автоподнятие их пропускает.
• Игры без расписания поднимает обычное автоподнятие, если оно включено.
• Планировщик работает даже при выключенном обычном автоподнятии — тогда поднимаются только игры с расписанием, остальные не поднимаются вовсе.

🛠 Включение

1. /menu → 🧩 Функции → Планировщик поднятия лотов → 🚀 Включить.
2. Откройте меню командой /raise_schedule (или ⚙️ Настройки → ⏫ Расписание поднятия).

На главном экране: режим, сколько игр под расписанием, время по умолчанию, ближайшее плановое поднятие и что происходит с остальными играми. Кнопка 🔄 Обновить заново загружает список игр со Starvell, ❓ Как это работает — краткая справка.

⚡ Быстрый старт (2 минуты)

1. 🕒 Время по умолчанию → выберите пресет, например ×3/день, или введите свои времена.
2. 🎮 Игры → ☑️ Выбрать все — все игры будут подниматься по этому времени. Или откройте конкретную игру и нажмите 🟢 Включить расписание — под расписанием будет только она.
3. Включите уведомления: /menu → 🔔 Настройки уведомлений → 🔔 Автоподнятие лотов, чтобы видеть результат в Telegram.

💡 Когда игра только попала под расписание, бот не поднимает её сразу — он дождётся ближайшего времени из расписания.

🕒 Часть 1. Время по умолчанию

/raise_schedule → 🕒 Время по умолчанию. Используется в общем режиме и для игр, у которых нет собственного времени. Изначально: 09:00, 15:00, 21:00.

Пресеты:

✏️ Ввести вручную — пришлите время в формате ЧЧ:ММ через запятую, пробел или с новой строки: 10:00, 14:30, 19:15, 23:00. Подходят и записи 9:00, 09.00. Новый список полностью заменяет старое время по умолчанию; максимум 12 значений. Нераспознанные значения бот покажет и пропустит. 🗑 Очистить — удалить время по умолчанию. Внимание: игры, которые пользовались временем по умолчанию, получат статус ⚠️ и вернутся к обычному автоподнятию, пока вы не зададите время снова.

🎮 Часть 2. Игры

/raise_schedule → 🎮 Игры. В списке — игры, в которых у вас есть лоты:

• 🟢 — под расписанием;
• ⚪️ — обычное автоподнятие;
• 🚫 — исключена из общего расписания;
• ⚠️ — под расписанием, но время не задано (пока работает обычное автоподнятие).

Массовые действия:

• ☑️ Выбрать все — включает общий режим: все игры поднимаются по времени по умолчанию.
• ❌ Снять со всех — выключает расписание для всех игр.

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

• 🟢 Включить расписание / ⚪️ Выключить расписание (в общем режиме — 🚫 Исключить / 🟢 Вернуть в общее расписание);
• ➕ Добавить время — одно или несколько значений ЧЧ:ММ через запятую. Время добавляется к уже заданному личному времени игры (не заменяет его), всего до 12 значений. После первого добавления игра перестаёт использовать время по умолчанию и сразу включается под расписание;
• 🗑 14:00 — удалить конкретный слот;
• ↩️ Сбросить на время по умолчанию — убрать личный график игры.

📋 Часть 3. Журнал

/raise_schedule → 📋 Журнал — последние события по МСК:

• ⏫ — игра поднята по расписанию (с пометкой, если ждали кулдаун);
• ⏳ — слот наступил, идёт ожидание кулдауна Starvell, указано время следующей попытки;
• ⚠️ — слот задерживается больше 90 минут.

Кнопки 🗑 Очистить и 🔄 Обновить.

Уведомления. В главном меню переключатели 🔔 О поднятии (✅/❌) и ⚠️ О задержке (✅/❌) включают отдельные уведомления планировщика. Они отправляются в Telegram как тип «Автоподнятие лотов», который по умолчанию выключен — включите его в /menu → 🔔 Настройки уведомлений → Автоподнятие лотов (🔔). Иначе уведомления не придут, даже если переключатели в планировщике стоят на ✅. Журнал ведётся всегда.

🧠 Часть 4. Кулдаун Starvell и плотный график

У Starvell есть собственное ограничение на частоту поднятий. Если поставить слоты слишком близко (например, 12:00 и 13:00), второй слот может прийтись на кулдаун. Бот его не пропустит: сохранит слот, узнает у Starvell время ожидания и поднимет лоты сразу после окончания кулдауна.

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

❓ Вопросы

По какому времени задавать расписание? По московскому (МСК, UTC+3), где бы ни находился сервер.

Пришло «игра не поднимается по расписанию уже больше 90 минут». Чаще всего ещё идёт кулдаун — например, лоты недавно поднимали вручную на сайте или обычным автоподнятием. Бот продолжит попытки сам. Если задержки повторяются, проверьте прокси: /menu → ▶️ Далее → 🌐 Прокси → 🔎 Проверить активный прокси.

Выключил модуль — что будет с играми? Они вернутся к обычному автоподнятию (если оно включено).

Появилась новая игра — нужно что-то делать? В общем режиме она автоматически попадёт под время по умолчанию. В индивидуальном — откройте её в 🎮 Игры и включите расписание.