🎮 Playerok Auto-Helper

🇷🇺 Русский | 🇬🇧 English

Бесплатное расширение для Chrome (Manifest V3), автоматизирующее продажу игровых аккаунтов на playerok.com.

Автовыдача 2FA-кодов через SteamPass, автоподнятие лотов, массовая публикация товаров, генератор карточек — всё в одном.

Автор: @dehughuglight (Telegram) · leeds.eha@gmail.com По всем вопросам, предложениям, коммерческому использованию — пишите в Telegram в ЛС.

---

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

Модуль	Что делает
⚡ Автовыдача	Сканирует новые заказы, автоматически отправляет приветствие, логин/пароль и 2FA-код покупателю
🚀 Автоподнятие	Бампит ваши лоты по истечению кулдауна (7 дней), скрытое окно, рандомные задержки
📝 Автопубликация	Массово выкладывает товары из SteamPass в ваш профиль Playerok
🖼️ Редактор шаблонов	Генератор карточек-превью для лотов (canvas-рендер)
📋 История заказов	Локальная БД всех выданных аккаунтов с поиском
📊 Сводка	KPI-дашборд: выдачи/бусты/очередь в реальном времени

---

🛠 Установка

Способ 1 — из исходников (рекомендуется)

1. Скачай репозиторий:

   git clone https://github.com/linlovedead/playerokbot.git

2. Открой chrome://extensions/ в браузере
3. Включи «Режим разработчика» (правый верхний угол)
4. Нажми «Загрузить распакованное расширение» → выбери папку с репозиторием
5. Закрепи иконку на панели инструментов

Способ 2 — собрать ZIP

.\build.ps1

Создаёт playerok-bot-release.zip в корне проекта — можно раздавать/устанавливать как архив.

---

🚀 Быстрый старт

1. Авторизуйся на playerok.com и steampass.gg в обычных вкладках
2. Открой расширение (иконка в панели или side panel)
3. Перейди в «Автовыдача» → укажи свой ник Playerok → START
4. Бот сам сканирует заказы и отправляет коды

Для бампа лотов — отдельная кнопка «Автопубликация».

---

📂 Структура проекта

├── background.js              # Service worker entry point
├── bg_constants.js            # Общие константы
├── bg_tab_manager.js          # Менеджер вкладок
├── bg_playerok_api.js         # GraphQL мост к Playerok
├── bg_dashboard.js            # Сканер заказов + 2FA мониторинг
├── bg_fulfill.js              # State-machine автовыдачи
├── bg_boost.js                # Цикл автоподнятия лотов
├── bg_publisher.js            # Массовая публикация
│
├── content.js                 # DOM-сканер на playerok.com
├── content_bridge.js          # GraphQL proxy (isolated world)
├── content_bridge_main.js     # Apollo cache reader (main world)
├── content_greeting.js        # Автоматизация чата/2FA
├── content_steampass.js       # SteamPass JWT extractor
│
├── popup.html / popup.js      # Боковая панель
├── auto_fulfill.*             # Окно автовыдачи
├── auto_boost.*               # Окно автоподнятия
├── auto_publisher.*           # Окно автопубликации
├── dashboard.*                # Окно сводки
├── orders_history.*           # История заказов
├── card_generator.*           # Редактор карточек
│
├── manifest.json
├── rules.json                 # declarativeNetRequest правила
└── build.ps1                  # Скрипт сборки ZIP

---

🔑 Ключевые механики

Автовыдача — конечный автомат заказа

NEW → GETTING_DATA → DATA_READY → GETTING_CREDENTIALS
    → SENDING_GREETING → WAITING_2FA → GETTING_2FA → COMPLETED

• Heartbeat 7 сек, лимит 24 выдачи в день (лимит SteamPass)
• До 3 параллельных заказов (1 активный + 2 в WAITING_2FA)
• Триггеры на сообщения клиента по regex-паттернам

Автоподнятие

• Опен-таб сканер → находит просроченные лоты → бампит по одному
• Cooldown 7 дней (processedListingAt Map)
• Случайные задержки 3–6 сек между действиями

Concurrency controls

• _storeMutexQueue — последовательные записи в chrome.storage
• _apiMutexQueue — один GraphQL-запрос в полёте
• _startBotLock — защита от двойного запуска

---

📋 Требования

• Chromium-браузер с поддержкой Manifest V3 (Chrome 114+, Edge 114+)
• Активные аккаунты на Playerok и SteamPass
• Залогиненная сессия в обоих сервисах

⚠️ В браузерах без chrome.sidePanel API (старые версии Яндекс/Opera) панель может не открываться по клику на иконку — открывайте окна напрямую через chrome-extension://{id}/popup.html.

---

🐛 Известные особенности

• Service Worker может засыпать — heartbeat держит его активным только во время работы бота
• При первом запуске нужно хотя бы раз вручную зайти на SteamPass, чтобы расширение получило JWT-токен
• Расширение работает только с русской локалью Playerok (регексы триггеров)

---

🤝 Вклад

Issues и PR приветствуются. Расширение ships в открытом виде без минификации — для прозрачности и удобства дебага.

---

📄 Лицензия

Проект распространяется по двойной лицензии:

🟢 Open Source — AGPL-3.0

Свободно использовать, форкать, модифицировать при условии:

• Исходный код форка открыт и доступен публично
• Производные проекты тоже под AGPL-3.0
• Авторство сохранено

🔵 Коммерческая лицензия

Если вы хотите:

• Использовать код в закрытом коммерческом продукте
• Встроить в SaaS без открытия своего кода
• Перепродавать под своим брендом
• Получить индивидуальные условия и поддержку

→ Свяжитесь со мной в Telegram @dehughuglight или по почте leeds.eha@gmail.com

Подробности — в файле LICENSE.

---

💬 Контакты

Любые вопросы, баги, предложения, коммерческое использование:

• Telegram: @dehughuglight ⭐ (предпочтительно, пишите в ЛС)
• Email: leeds.eha@gmail.com
• GitHub Issues: для публичных багов и фич

---

⚠️ Дисклеймер

Расширение предназначено для личного использования владельцами аккаунтов-магазинов. Автоматизация может противоречить правилам сервисов — используйте на свой страх и риск. Автор не несёт ответственности за блокировку аккаунтов Playerok/SteamPass, Steam или любые финансовые потери.