ButCheR-PRO/HamsterKombatBot

🇪🇳 README in english available here

Функционал

Функционал	Поддерживается
Многопоточность	✅
Привязка прокси к сессии	✅
Авто-покупка предметов при наличии монет (tap, energy, charge)	✅
Рандомное время сна между кликами	✅
Рандомное количество кликов за запрос	✅
Поддержка tdata / pyrogram .session / telethon .session	✅

Настройки

Настройка	Описание
API_ID / API_HASH	Данные платформы, с которой запускать сессию Telegram (сток - Android)
MIN_AVAILABLE_ENERGY	Минимальное количество доступной энергии, при достижении которой будет задержка (напр. 100)
SLEEP_BY_MIN_ENERGY	Задержка при достижении минимальной энергии в секундах (напр. [1800,2400])
ADD_TAPS_ON_TURBO	Сколько тапов будет добавлено при активации турбо (напр. 2500)
AUTO_UPGRADE	Улучшать ли пассивный заработок (True / False)
MAX_LEVEL	Максимальный уровень прокачки апгрейда (напр. 20)
MAX_UPGRADE_PRICE	Максимальная цена покупки апгрейда (напр. 1000000)
BALANCE_TO_SAVE	Лимит баланса, который бот "не тронет" (напр. 1000000)
UPGRADES_COUNT	Количество карточек, который бот прокачает за 1 круг (напр. 10)
APPLY_DAILY_ENERGY	Использовать ли ежедневный бесплатный буст энергии (True / False)
APPLY_DAILY_TURBO	Использовать ли ежедневный бесплатный буст турбо (True / False)
RANDOM_CLICKS_COUNT	Рандомное количество тапов (напр. [50,200])
SLEEP_BETWEEN_TAP	Рандомная задержка между тапами в секундах (напр. [10,25])
USE_PROXY_FROM_FILE	Использовать-ли прокси из файла `bot/config/proxies.txt` (True / False)

Быстрый старт 📚

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

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

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

Python 3.10.9.

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

Перейдите на сайт my.telegram.org и войдите в систему, используя свой номер телефона.
Выберите "API development tools" и заполните форму для регистрации нового приложения.
Запишите 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 >>> 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 >>> copy .env-example .env
~/HamsterKombatBot >>> # Указываете ваши 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 - Запускает кликер