🚀 Boost Hub для Starvell — автовыдача Discord-бустов через NeverBoost и HoldBoost

Boost Hub — модуль StarvellBot для продажи бустов Discord-серверов на Starvell в автоматическом режиме. Он подключается сразу к двум поставщикам — NeverBoost и HoldBoost — и может работать с обоими одновременно: одни лоты выдаются через первый сервис, другие через второй. Покупатель оплачивает лот, бот берёт ссылку-приглашение, заказывает бусты у поставщика, отслеживает доставку и сообщает результат.

Что умеет модуль:

• 🔗 Привязка лотов Starvell к сервису и тарифу (1 или 3 месяца) — по ID, по ссылке или выбором из списка ваших лотов.
• 🔗 Ссылка из заказа. Если покупатель указал ссылку на сервер при оплате, бот использует её сразу; если ссылки нет или она не работает — попросит прислать в чат.
• 🔍 Проверка приглашения до заказа: неверная ссылка, вход по заявкам (Membership Screening).
• 🚚 Отслеживание доставки и сообщения покупателю о результате.
• ✅ Автоподтверждение выполнения на Starvell — после полной доставки (по умолчанию), сразу после создания заказа или выключено.
• 📦 Авто-наличие: лот выключается, когда бустов нет, и включается, когда они появились; по желанию бот выставляет и количество лота по остатку.
• 💰 Авто-цены по себестоимости с глобальной или индивидуальной наценкой и защитой от резкого снижения цены.
• ⏳ Экран заказов: кто ждёт ссылку, что доставляется, какие заказы требуют внимания.
• 🛠 Кнопки в уведомлениях об ошибке: повторить, запросить ссылку заново, вернуть деньги. По желанию — автовозврат при ошибке.
• ✉️ 9 редактируемых текстов с переменными и кнопкой возврата к стандартному.
• 🌐 Прокси для запросов к сервисам бустов и Discord.
• 💾 Ничего не теряется при перезапуске — ожидающие заказы и отслеживание доставки сохраняются на диск.

🔌 Включение

1. /menu → 🧩 Функции → Boost Hub → 🚀 Включить.
2. Меню модуля — команда /boost (синоним /boosthub) или ⚙️ Настройки в карточке модуля.

⚡ Быстрый старт

1. /boost → ⚙️ Настройки → введите ключ хотя бы одного сервиса.
2. Для HoldBoost задайте себестоимость (💵 Себест. 1м / 3м), если нужны авто-цены.
3. /boost → ➕ Привязать лот — привяжите каждый лот с бустами.
4. В карточке лота проверьте 📦 Бустов/ед. — сколько бустов выдаётся за 1 шт.
5. 📦 Проверить наличие — убедитесь, что бот видит остатки.
6. Настройте авто-наличие, авто-цены, тексты и режим автоподтверждения.
7. Сделайте тестовую покупку и проверьте весь путь до «бусты доставлены».

🏠 Главное меню /boost

Сводка: готовность сервисов (✅ — включён и задан ключ), баланс NeverBoost, число привязок, скрытые лоты, настройки наличия и цен.

💡 Когда бот ждёт ввод (ID, число, ключ, текст), отправьте значение следующим сообщением. Любое нажатие кнопки отменяет ожидание ввода.

🔑 Часть 1. Сервисы и ключи

🔶 HoldBoost. Зарегистрируйтесь и возьмите ключ на странице holdboost.store/dashboard/api. HoldBoost не отдаёт цены через API, поэтому себестоимость 1 буста для тарифов «1 месяц» и «3 месяца» задайте вручную — 💵 Себест. 1м / 3м (нужно только для авто-цен).

🔷 NeverBoost. Ключ выдаёт Telegram-бот @NeverBoostApi_bot. Цены NeverBoost модуль получает автоматически, а баланс показывается в главном меню.

/boost → ⚙️ Настройки:

⚠️ Ключ не проверяется в момент сохранения. Ошибку покажет 📦 Проверить наличие или 💰 Цены.

🔗 Часть 2. Привязка лотов

/boost → ➕ Привязать лот:

1. Пришлите ID лота Starvell (число из ссылки starvell.com/offers/ID) или саму ссылку. Или нажмите 📋 Выбрать из моих лотов и выберите лот из списка.
2. Выберите сервис: 🔷 NeverBoost / 🔶 HoldBoost.
3. Выберите тариф: 1️⃣ 1 месяц / 3️⃣ 3 месяца.

Название лота бот запоминает сам. Заказ сопоставляется по ID лота: если ID в заказе есть, но не привязан — модуль заказ игнорирует. По названию бот ищет, только если ID в заказе нет вовсе.

Список привязок: строки вида ✅ 🔷[1m] Название — ✅ активна, ⏸ выключена вручную, ⛔ скрыта из-за отсутствия бустов; 🔷/🔶 — сервис; [1m]/[3m] — тариф.

Карточка привязки:

Бустов за единицу — множитель: покупатель взял 2 шт. лота с «5 бустов/ед.» → бот закажет 10 бустов. Он же участвует в расчёте цены: себестоимость лота = цена буста × бустов за единицу. Цена лота на Starvell должна соответствовать одной единице.

💬 Часть 3. Как проходит выдача

1. Ссылка. Если включено 🔗 Ссылка из заказа (по умолчанию ✅) и покупатель указал ссылку на сервер при оплате, бот сразу её проверяет. Иначе пишет покупателю «👋 Запрос invite». Если ссылка из заказа не работает — «🔗 Ссылка из заказа не работает» с просьбой прислать рабочую.
2. Проверка приглашения. Поддерживаются discord.gg/…, discord.com/invite/…, discordapp.com/invite/… — в любом месте сообщения.
   • нет Discord-ссылки → «❌ Неверный invite» (не чаще раза в 30 секунд);
   • на сервере включён вход по заявкам → «🚪 Вход по заявкам»;
   • если проверить ссылку технически не удалось, бот не блокирует покупателя и оформляет заказ.
3. Заказ у сервиса на нужный тариф и количество → «✅ Заказ принят».
4. Отслеживание: опрос каждые ~15 секунд до 25 минут.
   • 🎉 доставлено полностью → «🎉 Бусты доставлены» (по умолчанию со ссылкой на заказ и просьбой подтвердить выполнение);
   • ⚠️ частично (статус не менялся ~10 минут) → «⚠️ Доставлено частично»;
   • ❌ сервис не выполнил → «⚠️ Ошибка»;
   • ⏳ нет итога за 25 минут → вам уведомление с кнопкой 🔄 Продолжить отслеживание.

Если чата с покупателем ещё нет (у заказа Starvell нет своего чата), бот дождётся, пока покупатель напишет, и попросит ссылку. Возврат или закрытие заказа останавливают ожидание ссылки. Несколько заказов одного покупателя обрабатываются по очереди. Один заказ Starvell никогда не заказывается у сервиса дважды.

⏳ Часть 4. Экран заказов и ошибки

/boost → ⏳ Заказы:

• 👋 Ждут invite — с кнопками 📨 Напомнить про invite, 💸 Вернуть деньги, 🗑 Забыть;
• 🚚 Доставляются — сервис и номер заказа у него;
• ⚠️ Проблемные — «не создан», «не доставлен», «нет подтверждения».

В уведомлении об ошибке (и в карточке проблемного заказа) есть кнопки: 🔁 Повторить, 🔗 Запросить invite, 💸 Вернуть деньги, 🗑 Скрыть.

💸 Авто-возврат при ошибке (⚙️ Настройки, по умолчанию ❌) — если заказ не удалось создать или сервис не доставил ни одного буста, бот сам вернёт деньги и отправит покупателю «💸 Средства возвращены». При частичной доставке автовозврата нет.

📦 Часть 5. Наличие бустов

Правило: остаток по тарифу лота не меньше порога → лот включён; меньше → лот выключается. Когда бусты появятся, лот вернётся в продажу сам. Для NeverBoost остаток дополнительно ограничивается балансом на счёте — вы не продадите больше, чем сможете оплатить.

💡 Если лот выдаёт 5 бустов за единицу, порог ставьте не меньше 5.

📦 Проверить наличие — проверка прямо сейчас (даже при выключенном авто-наличии). Кнопка реально включает и выключает лоты и присылает отчёт: ✅ — сделано, ⚠️ — ошибка (например, нет ключа), 🔇 — привязка выключена.

⚠️ Бот управляет видимостью всех включённых привязок. Скрыли лот вручную, а бусты есть — при следующей проверке он включится. Чтобы держать лот скрытым, выключите привязку (⏸).

💰 Часть 6. Авто-цены

Себестоимость лота = цена буста × бустов за единицу Цена на Starvell = себестоимость + наценка (минимум 1 ₽)

Цена буста: NeverBoost — автоматически из сервиса, HoldBoost — из 💵 Себест.

⚙️ Настройки → 💰 Ценообразование:

Наценка лота из карточки (💰 Наценка) важнее глобальной.

Пример: буст стоит 20 ₽, 1 буст за единицу. Наценка 100 % → 40 ₽; фикс 15 ₽ → 35 ₽.

⚠️ Пока авто-цены включены, ручная цена на включённых привязках будет заменена расчётной при следующем пересчёте.

✉️ Часть 7. Тексты сообщений

⚙️ Настройки → ✉️ Тексты сообщений: 👋 Запрос invite · ✅ Заказ принят · 🎉 Бусты доставлены · ⚠️ Доставлено частично · ⚠️ Ошибка · ❌ Неверный invite · 🔗 Ссылка из заказа не работает · 🚪 Вход по заявкам · 💸 Средства возвращены.

Бот покажет текущий текст и попросит новый. ♻️ Вернуть стандартный восстанавливает исходный вариант. Чат Starvell не поддерживает форматирование — пишите обычным текстом.

Переменные: {order_id}, {order_link} (ссылка на заказ), {boosts}, {plan}, {service}, {delivered}, {total}, {invite}, {buyer}, {lot}.

🌐 Часть 8. Прокси

⚙️ Настройки → 🌐 Прокси — прокси для запросов к NeverBoost, HoldBoost и Discord (на Starvell не влияет): прокси бота (по умолчанию), ✍️ свой прокси (IPv4 HTTP/HTTPS) или без прокси. 🧪 Проверить — проверка соединения.

❓ Частые вопросы

Покупатель оплатил, а бот молчит. Проверьте: лот привязан и привязка включена; сервис лота ✅ (включён и есть ключ); ID купленного лота совпадает с привязанным. Если покупатель ещё ни разу не писал в чат, бот ждёт появления чата — посмотрите ⏳ Заказы.

Заказ не создаётся после ссылки. Проверьте ключ, баланс и наличие бустов у сервиса. Причина придёт вам в уведомлении с кнопками 🔁 Повторить / 💸 Вернуть деньги.

Бот отвечает «Неверный invite» на обычные сообщения. Пока заказ ждёт ссылку, бот реагирует на сообщения без неё (не чаще раза в 30 секунд). Смягчите текст ❌ Неверный invite, если нужно.

Лот постоянно выключается. Бустов по тарифу меньше порога или (для NeverBoost) не хватает денег на счёте. Проверьте кнопкой 📦 Проверить наличие, уменьшите порог или выключите авто-наличие.

Цена лота не меняется. Включены ли авто-цены, есть ли ключ, включена ли привязка, задана ли себестоимость HoldBoost. Если новая цена намного ниже текущей, её могла остановить 🛡 Защита — вы получите уведомление.

Статус доставки не пришёл. Через ~25 минут придёт уведомление. Проверьте заказ в кабинете сервиса или нажмите 🔄 Продолжить отслеживание.

Что будет после перезапуска бота? Ничего не потеряется: ожидающие заказы и отслеживание доставки продолжатся с того же места.