Totoro2205/HamsterKombatBot

Bot that mines coins in HamsterKombat

🇪🇳 README in english available here

⚙ Настройки

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

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

• Пример:
API_ID=2182472
API_HASH=b592f0d605a1b67c20e8d1c7582f20

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Пример: 10000000
• Дефолт: 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Пример: [0,15]
• Дефолт: [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": {}
  }
}

❕ Примечание: 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

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

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

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

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