Skip to content

shamhi/HamsterKombatBot

Repository files navigation

🇪🇳 README in english available here

demo image

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 кошелек к игре, если нет подключенного.

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

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

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

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

  • 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 >>> 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 - Запускает бота