====================
1. No module named 'steamlib'
====================

Что значит:
В Python не установлена нужная библиотека для работы Steam.

Как починить на Windows:

1. Закройте Cardinal.

2. Откройте командную строку.

3. Перейдите в папку Cardinal:
cd C:\Users\Admin\Desktop\FunPayCardinal-main

4. Установите зависимости:
py -3.11 -m pip install --upgrade pip setuptools wheel

py -3.11 -m pip install --upgrade --force-reinstall "pydantic>=1.9,<2" "aiohttp" "rsa" "pyTelegramBotAPI" "pysteamauth>=1.1.2" "pysteamlib>=1.0.1"

5. Проверьте:
py -3.11 -c "from steamlib.api.trade import SteamTrade; print('steamlib ok')"

Если появилось:
steamlib ok

значит все установлено.

6. Запустите Cardinal заново.

Если py -3.11 не работает, используйте:
python -m pip install --upgrade pip setuptools wheel

python -m pip install --upgrade --force-reinstall "pydantic>=1.9,<2" "aiohttp" "rsa" "pyTelegramBotAPI" "pysteamauth>=1.1.2" "pysteamlib>=1.0.1"

python -c "from steamlib.api.trade import SteamTrade; print('steamlib ok')"

Как починить на Linux / Ubuntu:

1. Остановите Cardinal.

2. Перейдите в папку Cardinal:
cd /home/USER/FunPayCardinal-main

Замените USER на имя вашего пользователя.

3. Установите системные пакеты:
sudo apt update
sudo apt install -y python3 python3-pip python3-venv git

4. Установите зависимости:
python3 -m pip install --upgrade pip setuptools wheel

python3 -m pip install --upgrade --force-reinstall "pydantic>=1.9,<2" "aiohttp" "rsa" "pyTelegramBotAPI" "pysteamauth>=1.1.2" "pysteamlib>=1.0.1"

5. Проверьте:
python3 -c "from steamlib.api.trade import SteamTrade; print('steamlib ok')"

Если появилось:
steamlib ok

значит все установлено.

6. Запустите Cardinal заново.

Если на Ubuntu появляется ошибка externally-managed-environment:
python3 -m pip install --break-system-packages --upgrade pip setuptools wheel

python3 -m pip install --break-system-packages --upgrade --force-reinstall "pydantic>=1.9,<2" "aiohttp" "rsa" "pyTelegramBotAPI" "pysteamauth>=1.1.2" "pysteamlib>=1.0.1"

====================
2. Красный текст после установки зависимостей
====================

Что значит:
Чаще всего это предупреждение pip о конфликте версий, а не поломка плагина.

Что сделать:
Выполните проверку:

Windows:
py -3.11 -c "from steamlib.api.trade import SteamTrade; print('steamlib ok')"

Linux:
python3 -c "from steamlib.api.trade import SteamTrade; print('steamlib ok')"

Если появилось:
steamlib ok

значит все нормально, можно запускать Cardinal.

====================
3. 🛑 Ошибка - остановлен scheduler
====================

Что значит:
Плагин не прошел проверку лицензии или запущен не с того Telegram-аккаунта.

Как починить:

1. Убедитесь, что используете плагин с того же Telegram-аккаунта, с которого он был куплен.

2. Если аккаунт правильный, заново заполните:
license_key
telegram_id

3. После этого напишите в Telegram-бот Cardinal команду:
/restart

4. Дождитесь перезапуска Cardinal и снова откройте меню плагина.

====================
4. license_key или license_url не заполнены
====================

Что значит:
В настройках плагина не указан ключ лицензии или адрес проверки лицензии.

Как починить:

1. Откройте настройки QuantumRent.

2. Заполните:
license_key
license_url

3. Проверьте, что в ключе нет лишних пробелов.

4. Перезапустите Cardinal:
в Telegram-боте Cardinal напишите:
/restart

====================
5. telegram_id_mismatch
====================

Что значит:
Лицензия куплена на один Telegram ID, а плагин запускается с другого.

Как починить:

1. Проверьте, с какого Telegram-аккаунта была куплена лицензия.

2. Используйте именно этот Telegram-аккаунт в Cardinal.

3. Заново заполните license_key и telegram_id.

4. Напишите в бота Cardinal:
/restart

====================
6. Что прислать, если ничего не помогло
====================

Пришлите:

1. Скрин ошибки
2. Лог Cardinal
3. Вашу операционную систему: Windows или Linux
4. Версию Python

Windows:
python --version

Linux:
python3 --version

5. Результат проверки steamlib:

Windows:
py -3.11 -c "from steamlib.api.trade import SteamTrade; print('steamlib ok')"

Linux:
python3 -c "from steamlib.api.trade import SteamTrade; print('steamlib ok')"

Плагин открывается через команду /rent_menu и дальше работает как отдельная мини-панель управления прямо внутри Telegram-бота Cardinal.

Что умеет QuantumRent

Главная задача плагина — автоматизировать аренду Steam-аккаунтов на FunPay. В текущем виде он умеет:

• хранить Steam-аккаунты и управлять ими;
• автоматически выдавать аккаунты после оплаты заказа;
• поддерживать онлайн- и оффлайн-аккаунты;
• автоматически продлевать аренду;
• выдавать Steam Guard / SDA-коды;
• менять пароль после окончания аренды для онлайн-аккаунтов;
• управлять лотами и их доступностью;
• подсказывать покупателю, как продлить аренду;
• вести логи и показывать статус работы;
• работать через Telegram-меню без постоянной правки файлов руками.

Как устроено меню

После запуска /rent_menu открываются основные разделы:

• Статистика
• Аренда
• Аккаунты
• Лоты
• Игры
• Steam
• Логи
• Статус

Это и есть центр управления плагином.

Какие аккаунты поддерживаются

В плагине есть два типа аккаунтов.

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

Оффлайн — это аккаунты без ротации пароля. Они используются для оффлайн-активаций, когда покупатель играет в автономном режиме Steam.

При этом плагин не даёт смешивать онлайн- и оффлайн-аккаунты в одном лоте, чтобы не ломать логику выдачи.

Что нужно для работы с аккаунтами

Для каждого нового аккаунта нужен maFile. Это важно не только для онлайн-аккаунтов, но и для оффлайн тоже. Через него плагин может работать с Steam Guard / SDA-кодами и корректно обслуживать аккаунты.

Если говорить проще: сейчас maFile — это обязательная часть нормальной работы плагина.

Как добавляются аккаунты

В разделе Аккаунты можно добавлять новые аккаунты по шагам:

• выбрать тип аккаунта;
• указать логин;
• указать пароль;
• указать игру или категорию;
• загрузить maFile.

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

Кроме добавления, через раздел аккаунтов можно:

• смотреть список;
• открывать карточку аккаунта;
• редактировать данные;
• замораживать аккаунты;
• удалять их.

Как работают лоты

В разделе Лоты создаётся и настраивается вся логика выдачи. У каждого лота можно хранить:

• ID лота с FunPay;
• название;
• игру;
• список привязанных аккаунтов;
• активность;
• время аренды за 1 единицу товара;
• бонусные часы;
• автосмену пароля;
• автоподнятие лота.

Это означает, что плагин не просто “выдаёт что-то после оплаты”, а понимает, какой именно аккаунт относится к конкретному товару и как с ним дальше работать.

Привязка аккаунтов к лотам

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

Для этого в плагине есть отдельная логика привязок. Можно:

• привязывать аккаунты к лоту;
• отвязывать их;
• перепривязывать;
• использовать более удобную массовую привязку.

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

Настройки аренды

Для обычных арендных лотов можно задавать:

• сколько часов даётся за 1 штуку товара;
• сколько часов даёт бонус по команде !bonus;
• включена ли автосмена пароля;
• нужно ли автоматически поднимать и опускать лот в зависимости от наличия свободных аккаунтов.

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

Шаблонные лоты

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

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

Раздел “Игры” и продления

В текущей версии есть отдельный раздел Игры. Он нужен для продлений.

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

Это делает продление намного удобнее и для продавца, и для покупателя.

Как работает автовыдача

Когда на FunPay приходит оплата, плагин анализирует заказ и определяет, что именно нужно сделать.

Дальше возможны три основных сценария:

• выдать обычный арендный аккаунт;
• выдать оффлайн-аккаунт;
• продлить уже существующую аренду.

Если это обычная аренда, плагин берёт первый подходящий свободный аккаунт, считает срок и отправляет данные покупателю.

Если это оффлайн-лот, плагин выдаёт аккаунт с отдельным оффлайн-шаблоном.

Если это лот продления, время аренды добавляется автоматически.

Что получает покупатель

После выдачи покупатель получает понятное сообщение с данными аккаунта и подсказками.

Для аренды это обычно:

• логин;
• пароль;
• срок аренды;
• команды:
• !код
• !аренда
• !bonus
• !продлить

Для оффлайн-активации сообщение отдельное: там не только логин и пароль, но и инструкция, как перевести Steam в автономный режим и как пользоваться таким аккаунтом.

Команды покупателя в чате

Плагин умеет обрабатывать команды в чате FunPay.

Основные команды:

• !аренда — показывает справку;
• !аккаунты — показывает свободные аккаунты;
• !код [логин] — выдаёт Steam Guard-код;
• !bonus — добавляет бонусные часы, если это разрешено;
• !продлить — показывает, как продлить аренду, и подсказывает нужный лот.

То есть после продажи покупатель не остаётся “один на один” с аккаунтом: у него есть понятные команды для взаимодействия.

Что происходит после окончания аренды

После завершения срока плагин автоматически обрабатывает аренду.

Для онлайн-аккаунтов он может сменить пароль и вернуть аккаунт в работу.

Для оффлайн-аккаунтов логика другая: пароль не ротируется, потому что сам формат товара другой.

Также перед окончанием аренды плагин может заранее предупредить покупателя и подсказать вариант продления.

Раздел “Steam”

В разделе Steam доступны два главных инструмента:

• смена пароля;
• получение Steam Guard-кода.

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

Логи и статус

В разделе Логи можно смотреть записи плагина и разбирать проблемы, если что-то пошло не так.

В разделе Статус можно проверить, работает ли scheduler, жив ли обработчик сообщений FunPay и в целом всё ли в порядке с рабочим циклом плагина.

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

Почему это удобно

Главная сила QuantumRent в том, что он превращает аренду Steam-аккаунтов из хаотичной ручной работы в понятную систему:

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

Что нужно знать перед установкой

В исходной инструкции указано, что GPT Feedback использует API сервиса io.net. Для работы плагина нужен FunPay Cardinal и API key. Там же отдельно отмечено, что в плагине уже может быть встроенный ключ, но он в любой момент может перестать работать, поэтому лучше сразу использовать свой собственный.

Важно: перед началом убедитесь, что у вас уже установлен Cardinal и есть возможность получить собственный API-ключ для io.net.

Как установить плагин и добавить его в Cardinal

Сначала скачайте GPT Feedback @QuantumDealsBot. После этого откройте своего бота Cardinal, перейдите в меню, затем в раздел «Плагины», нажмите «+ Добавить плагин» и загрузите туда скачанный файл. После установки обязательно выполните команду /restart — в исходной инструкции это отдельно подчёркивается как самый важный шаг после установки.

Что нужно сделать после установки

После перезапуска снова зайдите в «Плагины» и выберите GPT Feedback. Далее откройте «Настройки», перейдите в пункт «API Ключ», после чего в исходной инструкции предлагается зарегистрироваться на io.net через кнопку Get Started. Затем нужно перейти на сайт ai.io.net, нажать Create New Secret Key, создать свой ключ и вставить его в Cardinal.

Главное меню плагина

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

Основные пункты меню

«Вкл/выкл» — отвечает за включение и отключение всего плагина.

«Звезды» — открывает меню настройки, при каких рейтингах плагин будет отвечать.

«Поля» — отвечает за то, что именно будет написано в ответе.

«API Key» — раздел для управления API-ключом, который нужен для работы плагина.

«Тест API» — проверка работы самого плагина: можно быстро понять, отвечает он или нет.

Как удалить плагин

Чтобы удалить GPT Feedback, нужно вернуться в самое начало карточки плагина — туда, где отображаются его название, версия и создатель. Там находится кнопка «Удалить плагин». В исходной инструкции сказано, что дальше система сама подскажет, что именно нужно сделать после нажатия.

Заключение

Если пройти все шаги по порядку, схема выглядит так: сначала вы скачиваете и устанавливаете плагин в Cardinal, затем делаете /restart, после этого открываете настройки, создаёте или вставляете свой API key и уже потом настраиваете ответы плагина через главное меню. В самой исходной статье также сказано, что инструкция может обновляться в будущем, если что-то изменится.