> For the complete documentation index, see [llms.txt](https://0xcherrydocs.gitbook.io/0xcherry/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://0xcherrydocs.gitbook.io/0xcherry/softs/pudgy-world.md).

# Pudgy world

### 📚 Описание проекта <a href="#user-content-opisanie-proekta" id="user-content-opisanie-proekta"></a>

Pudgy World Bot - это специализированный софт для автоматизации действий в проекте **Pudgy World**. Софт полностью берет на себя рутину: от создания аккаунта и кастомизации игрового персонажа до автоматического выполнения всех доступных квестов.

Ключевая особенность бота - встроенная прозрачная интеграция с **iCloud**, что позволяет использовать одну единственную мастер-почту iCloud для приема кодов подтверждения всех создаваемых аккаунтов. Это полностью избавляет от необходимости генерировать и подключать десятки почт по протоколу IMAP.

***

### 🚀 Доступные активности <a href="#user-content-dostupnye-aktivnosti" id="user-content-dostupnye-aktivnosti"></a>

#### Основной функционал: <a href="#user-content-osnovnoi-funkcional" id="user-content-osnovnoi-funkcional"></a>

* **Автоматическая регистрация** аккаунтов на указанные почты;
* Извлечение кодов подтверждения напрямую с почты (или с [мастер-почты iCloud гайд можете найти тут](https://www.youtube.com/watch?v=A0QcWOUivoI\&t=2s));
* Автоматическая генерация и **установка уникальных Username**;
* Базовая **настройка персонажа** при первом входе;
* **Выполнение квестов**: Автоматическое прохождение сюжетных или ежедневных квестов;
* **Рыбалка (Fishing)**: Фарм рыбы в различных локациях с настройкой наживки и количества улова;
* **Аркада Polar Pair-up**: Прохождение уровней и автоматический клейм бейджей;
* **Аркада Rog Fish**: Аркадная рыбалка с клеймом бейджей;
* **Аркада Pengu Path**: Захват территории и клейм бейджей;
* **Аркада Belly Board**: Мини-игра на сноуборде и клейм бейджей;
* **Аркада Pudgy PI**: Детективная мини-игра и клейм бейджей;
* **Аркада Polar Roller**: Гонка на снежном шаре и клейм бейджей;
* **Сбор наград**: Массовый клейм всех доступных (незаклейменных) бейджей.
* Интеграция с Telegram для отправки отчетов о ходе работы.

#### Особенности: <a href="#user-content-osobennosti" id="user-content-osobennosti"></a>

* Поддержка интеграции с **CapSolver** для обхода капчи;
* Встроенный функционал **Redirect Mode** (идеально для работы через почты iCloud / catch-all);
* Настройка количества игр для каждой аркады в виде фиксированного числа или рандомного диапазона;
* Встроенная поддержка использования реферальных кодов;
* Автоматическая перестановка задач (retries) в случае ошибок и возможность многопоточной работы (поддержка до 50 аккаунтов параллельно);
* Уведомления об успехах и ошибках напрямую в Telegram.

***

### ⚙️ Установка <a href="#user-content-ustanovka" id="user-content-ustanovka"></a>

**Требования:**

* Установленный **Python 3.12** (рекомендуется для корректной работы всех библиотек). Скачать можно с [официального сайта](https://www.python.org/downloads/release/python-31210/).
* Валидные HTTP прокси для каждого аккаунта.

**Установка и запуск:**

1. Разархивируйте софт в удобное для вас место на вашем ПК.
2. Откройте терминал (или командную строку) в корневой папке с софтом.
3. Установите зависимости командой:

```
pip install -r requirements.txt
```

4. Переходите к настройке конфигов и подготовке файлов в папке `data`.

***

### ✅ Настройка и начало работы <a href="#user-content-nastroika-i-nachalo-raboty" id="user-content-nastroika-i-nachalo-raboty"></a>

#### 📁 config.py <a href="#user-content--configpy" id="user-content--configpy"></a>

Основные настройки софта осуществляются в файле `config.py`.

**🔑 Базовые настройки и Интеграции**

* `LICENSE_KEY` - Ваш лицензионный ключ (берется в боте).
* `LICENSE_USE_PROXY` - (`True`/`False`) Использовать ли прокси для проверки лицензии.
* `TG_BOT_TOKEN`, `TG_USER_ID` - Данные вашего Telegram-бота для получения отчетов.
* `CAPSOLVER_API_KEY` - Ваш API-ключ от сервиса Capsolver (обязателен для обхода капчи).
* `MAX_PARALLEL_ACCOUNTS` - Максимальное количество аккаунтов, работающих одновременно.
* `RETRIES` / `PAUSE_BETWEEN_RETRIES` - Сколько раз повторять зафейленное действие и задержка между попытками.

**📧 Настройки Redirect (почты iCloud)**

* `REDIRECT` - (`True`/`False`) Использовать ли редирект писем на единую мастер-почту.
* `MAIN_ICLOUD_EMAIL_LOGIN` - Логин мастер-почты.
* `APP_PASSWORD` - Специальный пароль приложения для мастер-почты iCloud.

**⚙️ Модули и Квесты**

* `PREPARE_PROFILE` - (`True`/`False`) Регистрация + установка юзернейма + настройка пингвина.
* `COMPLETE_QUESTS` - (`True`/`False`) Включить прохождение квестов.
* `CLAIM_BADGES` - (`True`/`False`) Только клейм незабранных бейджей для аккаунта.
* `REFERRAL_CODES` - Список реферальных кодов (`['code1', 'code2']`) или `None`.

**🎣 Настройки Рыбалки (ONLY\_FISHING)**

* `ONLY_FISHING` — (`True`/`False`) Запуск режима рыбалки.
* `NUM_FISHES` = `[10, 15]` - Количество вылавливаемой рыбы (число или диапазон `[min, max]`).
* `FISHING_LOCATION` - Настройка локации. `None` для случайной, укажите название (напр. `'pudgy-port'`) или список `['coral-cove', 'pudgy-port']`.
* `FISHING_BAIT` = `4` - Выбор наживки: 1=Worms, 2=Anchovies, 3=Spam, 4=Jerky, 5=Squid.

**🎮 Настройки Аркад (Мини-игр)**

* `ARCADE_PAIR_UP` - (`True`/`False`) Polar Pair-up + клейм бейджей.
* `ARCADE_ROG_FISH` - (`True`/`False`) Rog Fish + клейм бейджей.
  * `NUM_ROGFISH_GAMES` = `[3, 5]` - Количество игр.
* `ARCADE_PENGU_PATH` - (`True`/`False`) Pengu Path + клейм бейджей.
  * `NUM_PENGUPATH_GAMES` = `1` - Количество игр.
* `ARCADE_BELLY_BOARD` - (`True`/`False`) Belly Board + клейм бейджей.
  * `NUM_BELLYBOARD_GAMES` = `[2, 4]-` Количество игр.
* `ARCADE_PUDGY_PI` - (`True`/`False`) Pudgy PI (детектив) + клейм бейджей.
* `ARCADE_POLAR_ROLLER` - (`True`/`False`) Polar Roller (снежный шар) + клейм бейджей.
  * `NUM_POLAR_ROLLER_GAMES` = `[3, 5]` - Количество игр.

***

### 📂 Подготовка данных <a href="#user-content-podgotovka-dannykh" id="user-content-podgotovka-dannykh"></a>

Файлы с данными (почты и прокси) находятся в папке `data/`:

* `emails.txt` - список почтовых ящиков, на которые будут регистрироваться аккаунты. Формат ввода на каждую строку: `login:password`.
* `proxies.txt` - прокси для каждой почты. Формат `login:pass@ip:port`.

{% hint style="info" %}
**⚠️ Обязательно сохраняйте порядок строк в файлах `emails.txt` и `proxies.txt` одинаковым. Первая строка в файле почт всегда будет работать с первой строкой прокси!**
{% endhint %}

***

### ▶️ Первый запуск <a href="#user-content-pervyi-zapusk" id="user-content-pervyi-zapusk"></a>

1. Убедитесь, что вы заполнили папку `data` и настроили `config.py`. Выберите модули, которые вы хотите выполнить.
2. Откройте терминал в папке с проектом и запустите скрипт командой:

```
python main.py
```

3. После запуска софта появится консольное меню:
   * **`1) Generate new database`** - выбирайте этот пункт при первом запуске (или при добавлении новых почт/прокси) для генерации внутренней базы аккаунтов.
   * **`2) Work with existing database`** - выбирайте для старта работы по созданной базе в соответствии с выбранными в конфиге модулями.