Skip to content

Latest commit

 

History

History
293 lines (250 loc) · 10.4 KB

README-EN.md

File metadata and controls

293 lines (250 loc) · 10.4 KB
Raw

demo

🇷🇺 README на русском доступен здесь

⚙ Settings

API_ID / API_HASH - Platform Data

These values are necessary for authorization and working with the Telegram API. Without them, the bot will not be able to connect to your account.

  • Example:
    • API_ID=2182472
    API_HASH=b592f0d605a1b67c20e8d1c7582f20
MIN_AVAILABLE_ENERGY - Minimum Energy Level

This setting determines the minimum energy level at which the bot will go idle to simulate human-like activity.

  • Example: 200
  • Default: 200
SLEEP_BY_MIN_ENERGY - Delay at Minimum Energy

Sets a pause in the bot's operation if the energy drops below the set minimum. This simulates human-like activity.

  • Example: [1800,3600]
  • Default: [1800,3600]
AUTO_UPGRADE - Auto Upgrade Passive Earnings

This parameter determines whether the bot will automatically upgrade your cards to increase passive income.

  • Example: True / False
  • Default: False
MAX_LEVEL - Maximum Upgrade Level

Determines the maximum level up to which the bot will upgrade your cards.

  • Example: 20
  • Default: 20
MAX_PRICE - Maximum Upgrade Price

Sets the limit on the amount the bot can spend on a single card upgrade.

  • Example: 50000000
  • Default: 50000000
BALANCE_TO_SAVE - Balance Limit

This parameter defines the minimum balance that the bot will guarantee to keep, without spending it on upgrades or purchases.

  • Example: 1000000
  • Default: 1000000
UPGRADES_COUNT - Number of Upgrades per Cycle

Specifies how many cards the bot will upgrade in one cycle to always choose the most profitable card.

  • Example: 10
  • Default: 10
MAX_COMBO_PRICE - Maximum Combo Card Purchase Price

Defines the maximum amount the bot can spend on purchasing combo cards when the balance is sufficient.

  • Example: 10000000
  • Default: 10000000
APPLY_COMBO - Use Combo Cards

Allows the bot to activate combo cards to gain bonuses.

  • Example: True / False
  • Default: True
APPLY_PROMO_CODES - Activate Promo Codes

Allows the bot to automatically enter and activate promo codes in the Playground section to obtain keys.

  • Example: True / False
  • Default: True
APPLY_DAILY_CIPHER - Enter Daily Cipher

Enables automatic entry of the daily Morse code cipher to obtain bonuses.

  • Example: True / False
  • Default: True
APPLY_DAILY_REWARD - Collect Daily Reward

The bot will automatically collect daily rewards if this parameter is enabled.

  • Example: True / False
  • Default: True
APPLY_DAILY_ENERGY - Activate Daily Energy Boost

Allows the bot to activate the daily energy boost to replenish energy.

  • Example: True / False
  • Default: True
APPLY_DAILY_MINI_GAME - Play Mini Game

Setting that allows the bot to automatically play daily mini-games to obtain keys.

  • Example: True / False
  • Default: True
USE_RANDOM_MINI_GAME_KEY - Use Random Mini Game Key

Option to use a random key when participating in mini-games. Necessary if you have many accounts running simultaneously to avoid overloading the system.

  • Example: True / False
  • Default: True
AUTO_COMPLETE_TASKS - Complete Tasks

This feature allows the bot to automatically complete tasks if they are available.

  • Example: True / False
  • Default: True
USE_TAPS - Use Taps

Determines whether the bot will use taps (clicks).

  • Example: True / False
  • Default: True
RANDOM_TAPS_COUNT - Random Taps Count

This parameter defines the range of random tap (click) counts the bot may use at once.

  • Example: [10,50]
  • Default: [10,50]
SLEEP_BETWEEN_TAP - Delay Between Taps

Sets the interval time between taps (clicks). This prevents too frequent tapping.

  • Example: [10,25]
  • Default: [10,25]
USE_RANDOM_DELAY_IN_RUN - Use Random Delay at Startup

This setting allows for random delays for each account before starting the bot, helping to start each account separately rather than simultaneously.

  • Example: True / False
  • Default: False
RANDOM_DELAY_IN_RUN - Random Delay at Startup

Defines the range of random delay applied to each account before starting the bot. This helps to start each account separately rather than simultaneously.

  • Example: [0,15]
  • Default: [0,15]
USE_RANDOM_USERAGENT - Use Random User Agent

When enabled, the bot will use random User-Agents for each account and save them in `profiles.json` for future use, to increase anonymity and protection against bans.

  • Example: True / False
  • Default: False

📕 Profiles

For each session, you can create a profile with unique data:

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

❕ Note: session1 and session2 are example session names. If headers or fingerprint are empty, default data will be used.

⚡ Quick Start

  1. To install the libraries on Windows, run INSTALL.bat or install.sh on Linux.
  2. To start the bot, use START.bat (or in the console: python main.py) if you use Windows or start.sh on Linux.

📌 Prerequisites

Before you start, make sure you have the following installed:

  • Python version 3.10 or 3.11.

📃 Getting API keys

  1. Go to my.telegram.org and log in using your phone number.
  2. Select "API development tools" and fill out the form to register a new application.
  3. Record the API_ID and API_HASH in the .env file, provided after registering your application.

🧱 Installation

You can download the Repository by cloning it to your system and installing the required dependencies:

~ >>> 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  # Enter your API_ID and 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 >>> # Open the .env file and enter your API_ID and API_HASH
~/HamsterKombatBot >>> python main.py

To install as a Linux service for background operation of the bot, see here.

⏳ For a quick start, you can also use arguments, for example:

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

# 1 - Creates a session
# 2 - Starts the bot