← К услугам

Общая инструкция

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

Пошагово: скачать ZIP, выбрать Python 3.11 или 3.12, распаковать в Cardinal, поставить зависимости и перезапустить. Подходит для Auto SMM и других плагинов KaDerix в ZIP.

Что приходит в ZIP

Плагин закрыт PyArmor. В архиве не один файл, а пакет:

  • имя_плагина.py — сам плагин (например auto_smm.py)
  • папка pyarmor_runtime_… — runtime (внутри linux_x86_64 / windows_x86_64)
Оба должны лежать рядом в папке plugins. Без папки runtime плагин не загрузится.

Узнай версию Python Cardinal

Runtime собран под конкретную версию. Если не совпадёт — будет undefined symbol: _PyThreadState_GetCurrent.

  1. 1

    Найди процесс Cardinal

    На Linux обычно так: /home/ИМЯ/pyvenv/bin/python …/FunPayCardinal/main.py

  2. 2

    Спроси версию у этого python

    /home/ИМЯ/pyvenv/bin/python --version

Нужна 3.11 или 3.12 — ровно та, что покажет эта команда. Системный python3 --version может врать (часто 3.12, а Cardinal в venv на 3.11).

Скачай нужный ZIP

  1. 1

    Профиль на сайте

    Войди тем же Telegram → Профиль → «Скачать в Telegram».

  2. 2

    Выбери Python в модалке

    Кнопки Python 3.11 / Python 3.12 — ту, что у твоего Cardinal.

  3. 3

    Забери файл в боте

    Открой чат @KaDerix_Shop_Bot — там придёт ZIP.

Куда распаковать

Корень Cardinal — папка, где лежат main.py / cardinal.py.

Путь плагинов:
…/FunPayCardinal/plugins/
  1. 1

    Распакуй ZIP прямо в plugins

    После распаковки должно быть так:

    plugins/auto_smm.py
    plugins/pyarmor_runtime_XXXXXX/
    plugins/pyarmor_runtime_XXXXXX/__init__.py
    plugins/pyarmor_runtime_XXXXXX/linux_x86_64/… (на Linux)

  2. 2

    Не клади runtime внутрь другой папки

    Неправильно: plugins/auto_smm/pyarmor_runtime_… — правильно: runtime рядом с .py в plugins/.

  3. 3

    Права на Linux

    Файлы должны читаться пользователем, под которым крутится Cardinal (часто chmod -R u+rX plugins/ от нужного юзера).

Библиотеки (requirements)

Файл requirements.txt — в корне Cardinal. Внутри две строки: pyarmor и deep_translator. Ставить через pip venv Cardinal.
  1. 1

    Куда писать зависимости

    Файл requirements.txt в корне Cardinal (рядом с main.py), не в папке plugins.

  2. 2

    Что писать

    В requirements.txt по строкам:

    pyarmor
    deep_translator

  3. 3

    Куда ставить pip

    Только в venv Cardinal, не в системный python:

    /home/ИМЯ/pyvenv/bin/pip install -r requirements.txt

    или из активированного venv: pip install -r requirements.txt

Перезапуск и проверка

  1. 1

    Перезапусти Cardinal

    Полный рестарт процесса / сервиса (не только /restart, если плагин не подхватился).

  2. 2

    Смотри лог

    Не должно быть Не удалось загрузить плагин …. В Telegram должна появиться команда плагина (у Auto SMM — /smm).

  3. 3

    Лицензия

    В меню плагина → «Лицензия» → «Проверить статус». Покупка должна быть с того же Telegram.

Частые ошибки

undefined symbol: _PyThreadState_GetCurrent

Скачан ZIP не под ту версию Python. Проверь …/pyvenv/bin/python --version и скачай 3.11 или 3.12 заново. Старый runtime удали из plugins.

No module named pyarmor_runtime_…

Папка runtime не рядом с .py или имя/номер папки не совпадает. Распакуй ZIP целиком в plugins.

Плагин «не видит» / нет в списке

Смотри traceback в логе Cardinal при старте — почти всегда ошибка import/runtime, а не «файл пропал».

Поставил pyarmor и deep_translator — плагин всё равно не грузится

Смотри traceback. Чаще всего неверная версия ZIP (3.11 vs 3.12) или нет папки pyarmor_runtime_… рядом с .py.

ModuleNotFoundError: какая-то библиотека

Добавь её в requirements.txt в корне Cardinal и поставь через pip venv Cardinal, затем рестарт.