This repository has been archived by the owner on Sep 22, 2024. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 89
/
Copy pathREADME.MD
125 lines (80 loc) · 5.98 KB
/
README.MD
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
# Master Hamster Kombat Bot!
[](https://github.com/masterking32/MasterHamsterKombatBot/stargazers)
[](https://github.com/masterking32/MasterHamsterKombatBot/issues)
<hr>
Master Hamster Kombat Bot is a Python-based automation tool specifically designed for the game Hamster Kombat. This bot can perform all in-game tasks, such as auto-tapping, cipher tasks, and purchasing the best cards on your behalf. It's a free and fully automated farming bot that enhances your Hamster Kombat gaming experience. Additionally, it supports multi-accounts and is 100% open-source and free. If you find it useful, you can consider donating to support us.
❌ This project is intended for testing purposes only. Please refrain from abusing it. ❌
⚠️ Please use GitHub [Discussions](https://github.com/masterking32/MasterHamsterKombatBot/discussions) and [Issues](https://github.com/masterking32/MasterHamsterKombatBot/issues) to report problems and engage in discussions with others about the project. Don't forget to star and watch the project to receive notifications for new updates. ⚠️
<hr>
✅ Tested and confirmed to work as of `23 August 2024`. ✅
<img align="center" src="https://raw.githubusercontent.com/masterking32/MasterHamsterKombatBot/main/screenshot.png" alt="Screenshot" />
#### ⭐ If you find this project useful, please consider giving it a star! ⭐
<a href="https://github.com/masterking32/MasterHamsterKombatBot/stargazers"><img align="center" src="https://raw.githubusercontent.com/masterking32/MasterHamsterKombatBot/main/github_star.png" alt="github_star" /></a>
<hr>
## 🗒️ Features
- Get the list of cards and automatically buy the best cards based on return value (This feature allows you to retrieve a list of available cards and automatically purchase the best cards based on their return value. The return value is determined by comparing the card's price with its profit per hour. By automating this process, you can optimize your card selection and maximize your earnings), (11 Jun 2024)
- Fixed some issues and added the ability to perform all of your taps. (06 August 2024)
- **Added support for multi-accounts**. (June 12, 2024)
- Implemented a timer to periodically check the accounts. (June 12, 2024)
- Support setting a specific **proxy** for each account. (June 12, 2024)
- Added auto decoding and claiming of daily ciphers. (June 12, 2024)
- Auto claiming daily tasks added, **Version 2 released**. (June 12, 2024)
- Autocomplete other tasks (Youtube/Twitter and etc). (June 20, 2024)
- You can add a Telegram Bot to receive logs inside Telegram. (June 20, 2024)
- Automatically complete Hamster Kombat **Mini-Games** to earn keys. (July 21, 2024)
- Playground `Bike Ride 3D` added. (July 29, 2024)
- Playground `My Clone Army`, `Chain Cube 2024`, `Train Miner` added. (August 06, 2024)
- Playground `Merge Away` added. (August 15, 2024)
- Playground `Twerk Race` added. (August 16, 2024)
- Playground `Polysphere: Art Puzzle Game` added. (August 21, 2024)
- Playground `Mow and Trim, Mud Racing` added. (August 23, 2024)
<hr>
## 💻 Installation
1. Install Git & Download the Project.
```bash
git clone https://github.com/masterking32/MasterHamsterKombatBot
```
2. Install Python 3.
3. Install the required packages,
```bash
pip install requests colorlog
```
4. Add your accounts
- Copy the `config.py.example` file to `config.py`. (`cp config.py.example config.py`)
- Locate your `Authorization Bearer token` and place it in the `config.py` file. [How to Obtain a Token and Set Up the Bot?](https://www.youtube.com/watch?v=cjWE7DmMFgw)
- [Find your device's UserAgent](https://github.com/masterking32/MasterHamsterKombatBot/blob/main/useful_files/user-agents.md) and place it in the `config.py` file.
- Configure accounts
5. Execute the command `py main.py`.
6. Have fun!
<hr>
## 💻 Update to the Latest Version
This option only works if you have Git installed on your system and you downloaded the project using the command: `git clone https://github.com/masterking32/MasterHamsterKombatBot`. If you downloaded the project as a zip file, simply re-download and replace all files.
1. Run the following command: `git pull origin main`
2. Update the configuration file if needed.
3. Start the project.
<hr>
### <a href="https://github.com/masterking32/MasterHamsterKombatBot/discussions/12#discussioncomment-9852919" target="_blank">🐧 Linux Installation Guide</a>
### <a href="https://github.com/masterking32/MasterHamsterKombatBot/discussions/33#discussioncomment-10045854" target="_blank">👥 Multi-Account Example</a>
### <a href="https://github.com/masterking32/MasterHamsterKombatBot/discussions/133#discussioncomment-10290865">🔒 Proxy Example</a>
You can buy proxies from <a href="https://www.webshare.io/?referral_code=2ghmowzxmc26">WebShare</a> or <a href="https://iproyal.com/?r=128279">IPRoyal</a>.
<hr>
💵 If you're a fan of our project and want to support us, consider donating crypto. Your support will help us improve and expand, providing even more value to our users. Thank you for your generosity! 💵
TON:
`UQDdtN_p3WwuGMVXtMasatomVNPJF-Ljscy0srozJZBl15eL`
EVM-compatible blockchains:
`0x517f07305D6ED781A089322B6cD93d1461bF8652`
TRC20 chain:
`TLApdY8APWkFHHoxebxGY8JhMeChiETqFH`
RONIN Chain:
`masterking.ron`
<hr>
## 📽️ Tutorial and Test
<a href="https://www.youtube.com/watch?v=cjWE7DmMFgw" target="_blank">
<img align="center" src="https://raw.githubusercontent.com/masterking32/MasterHamsterKombatBot/main/thumbnail.png" alt="Youtube Video" />
</a>
---
# Encountered an Issue or Problem?
Feel free to [open a new issue](https://github.com/masterking32/MasterHamsterKombatBot/issues) if you encounter any problems or start a new discussion in the [discussions](https://github.com/masterking32/MasterHamsterKombatBot/discussions) section.
---
Developed By [MasterkinG32](https://github.com/masterking32)
<hr>