HamsterKombatBot: A Python repository from shamhi

🇪🇳 README in english available here

⚙ Настройки

API_ID / API_HASH - Данные платформы

Эти значения необходимы для авторизации и работы с Telegram API. Без них бот не сможет подключиться к вашему аккаунту.

Пример:

API_ID=2182472

API_HASH=b592f0d605a1b67c20e8d1c7582f20

MIN_AVAILABLE_ENERGY - Минимальное количество энергии

Эта настройка определяет минимальный уровень энергии, при котором бот будет уходить в сон, чтобы повторить человеческую активность.

Пример: 535
Дефолт: 200

SLEEP_BY_MIN_ENERGY - Задержка при минимальной энергии

Устанавливает паузу в работе бота, если энергия опускается ниже установленного минимума. Это повторить человеческую активность.

Пример: [2000,3300]
Дефолт: [1800,3600]

AUTO_UPGRADE - Улучшение пассивного заработка

Этот параметр определяет, будет ли бот автоматически прокачивать ваши карты для повышения пассивного дохода.

Пример: True / False
Дефолт: False

MAX_LEVEL - Максимальный уровень апгрейда

Определяет максимальный уровень, до которого бот будет прокачивать ваши карты.

Пример: 15
Дефолт: 20

MIN_PROFIT - Минимальная прибыль карты

Определяет минимальную прибыль карты, которую прокачает бот.

Пример: 2500
Дефолт: 1000

MAX_PRICE - Максимальная цена апгрейда

Устанавливает лимит на сумму, которую бот может потратить на одно улучшение карты.

Пример: 20000000
Дефолт: 50000000

BALANCE_TO_SAVE - Лимит баланса

Этот параметр определяет минимальный остаток на балансе, который бот гарантировано сохранит, не тратя его на улучшения или покупки.

Пример: 2000
Дефолт: 1000000

UPGRADES_COUNT - Количество апгрейдов за один круг

Задает, сколько карт бот будет прокачивать за один цикл работы, чтобы каждый раз выбирать самую выгодную карту из всех.

Пример: 5
Дефолт: 10

MAX_COMBO_PRICE - Максимальная цена покупки комбо карт

Определяет максимальную сумму, которую бот может потратить на покупку комбо-карт при достаточном балансе.

Пример: 15000000
Дефолт: 10000000

APPLY_COMBO - Использование комбо карт

Настройка позволяет боту активировать комбо-карты для получения бонусов.

Пример: True / False
Дефолт: True

APPLY_PROMO_CODES - Активация промокодов

Позволяет боту автоматически вводить и активировать промокоды на игры в разделе Playground для получения ключей.

Пример: True / False
Дефолт: True

APPLY_DAILY_CIPHER - Ввод ежедневного шифра

Включает возможность автоматического ввода ежедневного шифра азбуки морзе для получения бонусов.

Пример: True / False
Дефолт: True

APPLY_DAILY_REWARD - Сбор ежедневной награды

Бот будет автоматически собирать ежедневные награды, если этот параметр активен.

Пример: True / False
Дефолт: True

APPLY_DAILY_ENERGY - Активация ежедневного буста энергии

Позволяет боту активировать ежедневный буст энергии для ее восполнения.

Пример: True / False
Дефолт: True

APPLY_DAILY_MINI_GAME - Прохождение мини игры

Настройка, позволяющая автоматически проходить ежедневные мини-игры для получения ключей.

Пример: True / False
Дефолт: True

SLEEP_MINI_GAME_TILES - Задержка в мини игре TILES

Опция для установления рандомной задержки от начала игры до ее конца.

Пример: [500,800]
Дефолт: [600,900]

SCORE_MINI_GAME_TILES - Максимальный счет для игры TILES

Устанавливает рандомный счет, который будет достигнут в игре.

Пример: [250,600]
Дефолт: [300,500]

GAMES_COUNT - Количество игр в TILES

Определяет рандомное количество игр, которые сыграет бот в одном цикле.

Пример: [3,15]
Дефолт: [1,10]

AUTO_COMPLETE_TASKS - Выполнение заданий

Эта функция позволяет боту автоматически выполнять задачи, если они доступны.

Пример: True / False
Дефолт: True

USE_TAPS - Использование тапов

Определяет, будет ли бот использовать тапы (клики).

Пример: True / False
Дефолт: True

RANDOM_TAPS_COUNT - Рандомное количество тапов

Этот параметр определяет диапазон случайного количества тапов (кликов), которые бот может тапнуть за один раз.

Пример: [25,100]
Дефолт: [10,50]

SLEEP_BETWEEN_TAP - Задержка между тапами

Устанавливает интервал времени между тапами (кликами). Это предотвращает слишком частое нажатие.

Пример: [5,15]
Дефолт: [10,25]

USE_RANDOM_DELAY_IN_RUN - Использование рандомной задержки при запуске

Эта настройка позволяет использовать случайные задержки для каждого аккаунта перед началом бота, что помогает запустить каждый аккаунт по отдельности, а не одновременно.

Пример: True / False
Дефолт: False

RANDOM_DELAY_IN_RUN - Рандомная задержка при запуске

Определяет диапазон случайной задержки, которая применяется для каждого аккаунта перед началом бота. Это помогает запустить каждый аккаунт по отдельности, а не одновременно.

Пример: [0,20]
Дефолт: [0,15]

USE_RANDOM_USERAGENT - Использование рандомного User Agent

При активации этого параметра бот будет использовать случайные User-Agent для каждого аккаунта и сохранит их в `profiles.json` для дальнейшего использования, чтобы повысить уровень анонимности и защиты от блокировок.

Пример: True / False
Дефолт: False

📕 Профили

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

{
  "session1": {
    "tonAddress": "UQCvE0cNCpBoD6JQ0tFSIGXVissDQGNk6OoBQ8UTlkaQ5lLB",
    "proxy": "http://yGow3a:uBro3wL@58.195.21.83:9715",
    "headers": {},
    "fingerprint": {}
  },
  "session2": {
    "tonAddress": "UQCvE0cNCpBoD6JQ0tFSIGXVissDQGNk6OoBQ8UTlkaQ5lLB",
    "proxy": "socks5://yGow3a:uBro3wL@58.195.21.83:9715",
    "headers": {},
    "fingerprint": {}
  }
}

Note

session1 и session2 - это примеры названий сессий.
Если headers или fingerprint пусты, то возьмутся дефолтные значения.
Поле tonAddress подключает TON кошелек к игре, если нет подключенного.

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

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

📌 Зависимости

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

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

📃 Получение 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 >>> # Откройте файл .env и укажите ваши API_ID и API_HASH
~/HamsterKombatBot >>> python main.py

Tip

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

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

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

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