Skip to content

Latest commit

 

History

History
322 lines (277 loc) · 11.3 KB

README-EN.md

File metadata and controls

322 lines (277 loc) · 11.3 KB
Raw

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

demo

⚙ 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: 535
  • 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: [2000,3300]
  • 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: 15
  • Default: 20
MIN_PROFIT - Minimum Upgrade Profit

Determines the minimum profit of the card that the bot will upgrade.

  • Example: 2500
  • Default: 1000
MAX_PRICE - Maximum Upgrade Price

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

  • Example: 20000000
  • 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: 2000
  • 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: 5
  • 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: 15000000
  • 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
SLEEP_MINI_GAME_TILES - Delay in the mini game TILES

Option to set a random delay from the start of the game to its end.

  • Example: [500,800]
  • Default: [600,900]
SCORE_MINI_GAME_TILES - Maximum score for the game TILES

Sets the random score that will be reached in the game.

  • Example: [250,600]
  • Default: [300,500]
GAMES_COUNT - Number of games in TILES

Defines the random number of games that the bot will play in one cycle.

  • Example: [3,15]
  • Default: [1,10]
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: [25,100]
  • Default: [10,50]
SLEEP_BETWEEN_TAP - Delay Between Taps

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

  • Example: [5,15]
  • 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,20]
  • 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": {
    "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 and session2 are example session names.
If headers or fingerprint are empty, default values will be used.
Field tonAddress connects TON wallet to game, if there is no connected.

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

Tip

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