Hamster Kombat 🐹 Key Generator

Welcome to the Hamster Kombat Key Generator repo! This project features a bot that automatically generates keys for the mini-games available within the Hamster Kombat app. The bot is designed to be easy to configure and deploy, providing a seamless way to unlock mini-games.

Features

Automated Key Generation: Quickly and efficiently generates keys for all available mini-games in the Hamster Kombat app, within minutes which if fairly played would consume hours.
Telegram Integration: Utilizes Telegram MtProto API framework for interaction, including easy setup and management through a Telegram bot.
Configurable Settings: Simple configuration of API credentials and bot settings through the main.py file.
Open Source and Free: Licensed under the AGPL, promoting transparency and allowing community contributions.

Demo

You can try out the demo bot here. Please note that the demo bot is currently hosted locally on my VS Code environment and might be intermittently down. For consistent access, you may need to deploy the bot on a dedicated server.

Getting Started

To get started with the Hamster Kombat Key Generator, follow these instructions:

Prerequisites

Python 3.6 or higher
Telegram API credentials (API ID, API Hash, Bot Token, Owner ID) from here

Installation

Clone the Repository:

git clone https://github.com/ogsamrat/HamsterKombat.git

Navigate to the Project Directory:
```
cd HamsterKombat
```
Install Required Libraries:

Create a virtual environment (optional but recommended) and install the necessary libraries using:
```
pip install -r requirements.txt
```

Configuration

Before deploying the bot, you need to configure it with your Telegram API credentials. Open main.py and set the following variables with your credentials:

api_id: Your Telegram API ID
api_hash: Your Telegram API Hash
bot_token: Your Telegram Bot Token
mongodb_uri: Your MongoDB URI (from mongodb.com)
owner_id: Your Telegram User ID (for administrative purposes)

Running the Bot

To start the key generator bot, run:

python main.py

Ensure that all configuration values are correctly set before deployment.

Contributing

Contributions to this project are welcome! If you have any suggestions or would like to add features, please feel free to submit a pull request or open an issue.

License

This project is licensed under the GNU Affero General Public License (AGPL). See the LICENSE file for more information.

ogsamrat/HamsterKombat