/FunPayCardinal

Консольное приложение с мощнейшим инструментарием для автоматизации рутинных действий на FunPay.

Primary LanguagePython

FunPay Cardinal

Консольное приложение для автоматизации рутинных действий на FunPay

Перед началом настоятельно рекомендую залететь в наш Telegram чат (клик). Тут и поможем чем сможем и посидеть можно.

📋 Содержание

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

🛒 FunPay

  • Авто-выдача товаров.
  • Авто-поднятие лотов.
  • Авто-ответ на заготовленные команды.
  • Авто-восстановление лотов после продажи.
  • Вечный онлайн.
  • Уведомления в телеграм.

🗨️ Уведомления в Telegram

  • Возможность установки нескольких чатов для уведомлений.
  • Уведомления о поднятии лотов.
  • Уведомления о новых заказах.
  • Уведомления о выдаче товара.
  • Уведомления о новых сообщениях
  • Возможность отвечать на сообщения прямо из Telegram.

⚙️ Дополнительные возможности

  • Использование переменных в тексте для авто-ответа / авто-выдачи.
  • Создание плагинов для кастомизации функционала без редактирования исходного кода самого Кардинала.

🥇 Преимущества

😀 Для пользователей

  • Больше, чем наличие самого нужного функционала.
  • Оптимизация. 20 МБ свободного места на диске, до 50 МБ ОЗУ, доступ в интернет - все что нужно для работы.
  • Возможность установить на любую платформу, которую поддерживает Python: Windows, Linux, IOS, Android и т.д.
  • Возможность установки плагинов дает огромную вариативность модификации стандартного функционала под самые разные нужды.
  • Гибкие и при этом простые конфиги, написанные в INI-формате.
  • Постоянные обновления, быстрое реагирования на баги / предложения о новом функционале.

💻 Для разработчиков

  • Выбран самый простой и при этом один из самых мощных языков для такого рода приложений - Python.
  • Полная документация кода. Все классы / методы / функции имеют док-строки, type-хинты.
  • Широкое использование ООП. Почти каждый эвент / сообщение / заказ и т.д. представляют собой экземпляр соответствующего класса, а не просто набор данных в JSON.
  • Возможность легкого создания плагинов.
  • Сконфигурированный логгер. Никаких принтов!
  • Собственный Python-пакет FunPayAPI, который никак не привязан к FunPay Cardinal.
  • Поддержка лично от меня :)

🔌 Плагины

  • FPC Newbie Greetings Plugin (отправляет приветственное сообщение пользователям, которые написали впервые)
  • FPC Lot Deactivate Plugin (деактивирует лот, если для него закончились товары)

⬇️ Установка

🔷 Windows

  1. Скачайте и установите Python.
    1. При установке поставьте галочку у Add python.exe to PATH на первом экране установки.
  2. Скачайте FunPay Cardinal
  3. Перенести папку FunPayCardinal-master в нужное вам место.
  4. Перейдите в папку FunPayCardinal-master.
  5. В адресной строке введите cmd и нажмите Enter.
  6. В открывшейся командной строке введите python setup.py. Дождитесь окончания загрузки пакетов.
  7. Закройте командную строку, настройте конфиги и запустите файл Start.bat.

♨️ Linux (Ubuntu)

  1. Введите следующие команды для установки Python 3.11.

    1. sudo apt update
    2. sudo apt install software-properties-common
    3. sudo add-apt-repository ppa:deadsnakes/ppa
    4. sudo apt update
    5. sudo apt install python3.11 python3.11-dev python3.11-gdbm python3.11-venv
    6. sudo apt install curl
    7. sudo apt install gcc
    8. curl -sS https://bootstrap.pypa.io/get-pip.py | python3.11
  2. Скачайте git с помощью команды sudo apt install git.

  3. Скачайте FunPayCardinal с помощью команды git clone https://github.com/woopertail/FunPayCardinal.

  4. Перейдите в папку FunPayCardinal с помощью команрды cd FunPayCardinal.

  5. Установите нужные пакеты с помощью команды python3.11 setup.py.

  6. Настройте конфиги и запустите FunPay Cardinal с помощью команды python3.11 main.py.

🛠️ Настройка конфигов

  1. Все конфиги находятся в папке configs
  2. Все инструкции по настройке конфигов находятся внутри самих конфигов.
  3. Основной конфиг со всеми переключателями: configs/_main.cfg
  4. Конфиг авто-ответчика: configs/auto_response.cfg
  5. Конфиг авто-выдачи: configs/auto_delivery.cfg

🔌 Установка плагинов

Установка плагинов крайне проста. Просто скопируйте файл плагина (с расширением .py) в папку plugins.

❓ Мне нужна помощь

Если у вас остались какие-либо вопросы, мы с радостью ответим на них в нашем Telegram чате. Там же вы сможете найти больше плагинов для FunPay Cardinal.

⭐ Star it!

Если вам удобно пользоваться FunPay Cardinal, не забудьте поставить ⭐ звезду ⭐ данному проекту :)