🇪🇳 README in english available here

⚙ Настройки

Настройка	Описание
API_ID / API_HASH	Данные платформы, с которой запускать сессию Telegram (сток - Android)
MIN_AVAILABLE_ENERGY	Минимальное количество доступной энергии, при достижении которой будет задержка (напр. 100)
SLEEP_BY_MIN_ENERGY	Задержка при достижении минимальной энергии в секундах (напр. [1800,2400])
AUTO_UPGRADE	Улучшать ли пассивный заработок (True / False)
MAX_LEVEL	Максимальный уровень прокачки апгрейда (напр. 20)
MAX_PRICE	Максимальная цена прокачки апгрейда (напр. 50000000)
BALANCE_TO_SAVE	Лимит баланса, который бот "не тронет" (напр. 1000000)
UPGRADES_COUNT	Количество карточек, который бот прокачает за 1 круг (напр. 10)
MAX_COMBO_PRICE	Максимальная цена покупки для покупки комбо при доступном балансе (напр. 10000000)
APPLY_DAILY_ENERGY	Использовать ли ежедневный бесплатный буст энергии (True / False)
USE_TAPS	Использовать ли тапы (True / False)
RANDOM_TAPS_COUNT	Рандомное количество тапов (напр. [50,200])
SLEEP_BETWEEN_TAP	Рандомная задержка между тапами в секундах (напр. [10,25])
USE_RANDOM_DELAY_IN_RUN	Использовать ли рандомную задержку при запуске (True / False)
RANDOM_DELAY_IN_RUN	Рандомная задержка при запуске (напр. [0,15])
USE_RANDOM_MINI_GAME_KEY	Использовать ли рандомный ключ для шифра мини игры (True / False)
USE_RANDOM_USERAGENT	Использовать ли рандомный User Agent при каждом новом запуске (True / False)

📕 Профили

Для каждой сессии можно создать профиль с уникальными данными:

{
  "session1": {
    "proxy": "socks5://yGow3a:[email protected]:9715",
    "headers": {"...": "..."},
    "fingerprint": {"...": "..."}
  },
  "session2": {
    "proxy": "socks5://yGow3a:[email protected]:9715",
    "headers": {"...": "..."},
    "fingerprint": {"...": "..."}
  },
  "...": {}
}

❕ Примечание: session1 и session2 - это примеры названий сессий.

⚡ Быстрый старт

1. Чтобы установить библиотеки в Windows, запустите INSTALL.bat.
2. Для запуска бота используйте START.bat (или в консоли: python main.py).

📌 Предварительные условия

Прежде чем начать, убедитесь, что у вас установлено следующее:

• Python версии 3.10 или 3.11.

📃 Получение API ключей

1. Перейдите на сайт my.telegram.org и войдите в систему, используя свой номер телефона.
2. Выберите "API development tools" и заполните форму для регистрации нового приложения.
3. Запишите API_ID и API_HASH в файле .env, предоставленные после регистрации вашего приложения.

🧱 Установка

Вы можете скачать Репозиторий клонированием на вашу систему и установкой необходимых зависимостей:

~ >>> git clone https://github.com/shamhi/HamsterKombatBot.git 
~ >>> cd HamsterKombatBot

# Linux
~/HamsterKombatBot >>> python3 -m venv venv
~/HamsterKombatBot >>> source venv/bin/activate
~/HamsterKombatBot >>> pip3 install -r requirements.txt
~/HamsterKombatBot >>> playwright install
~/HamsterKombatBot >>> cp .env-example .env
~/HamsterKombatBot >>> nano .env  # Укажите ваши API_ID и API_HASH
~/HamsterKombatBot >>> python3 main.py

# Windows
~/HamsterKombatBot >>> python -m venv venv
~/HamsterKombatBot >>> venv\Scripts\activate
~/HamsterKombatBot >>> pip install -r requirements.txt
~/HamsterKombatBot >>> playwright install
~/HamsterKombatBot >>> copy .env-example .env
~/HamsterKombatBot >>> # Откройте файл .env и укажите ваши API_ID и API_HASH
~/HamsterKombatBot >>> python main.py

Установка в качестве Linux службы для фоновой работы бота тут.

⏳ Также для быстрого запуска вы можете использовать аргументы, например:

~/HamsterKombatBot >>> python3 main.py --action (1/2)
# Или
~/HamsterKombatBot >>> python3 main.py -a (1/2)

# 1 - Создает сессию
# 2 - Запускает кликер