Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/matthewmiglio/py-clash-bot

An inherently undetectable Clash Royale automation bot
https://github.com/matthewmiglio/py-clash-bot

automation bot clash clash-royale royale

Last synced: 7 days ago
JSON representation

An inherently undetectable Clash Royale automation bot

Awesome Lists containing this project

README

        

# py-clash-bot

[![Build windows package](https://github.com/pyclashbot/py-clash-bot/actions/workflows/python-build-msi.yml/badge.svg)](https://github.com/pyclashbot/py-clash-bot/actions/workflows/python-build-msi.yml) [![GitHub Python Tests](https://github.com/pyclashbot/py-clash-bot/actions/workflows/python-tests.yml/badge.svg?branch=master)](https://github.com/pyclashbot/py-clash-bot/actions/workflows/python-tests.yml) [![CodeFactor](https://www.codefactor.io/repository/github/pyclashbot/py-clash-bot/badge)](https://www.codefactor.io/repository/github/pyclashbot/py-clash-bot) [![Discord](https://img.shields.io/discord/1088595596962713790?label=Discord%20Server&cacheSeconds=43200)](https://discord.gg/mx4W9qRNgF)

py-clash-bot is an open-source application that allows users to automate their Clash Royale gameplay on Windows using an emulated Android phone. The bot uses a combination of image recognition, mouse control, and Android emulation to perform a variety of tasks without user intervention.

_Join the [Discord server](https://discord.gg/mx4W9qRNgF)!_

## Features

- Automated level-up, clan wars, card requesting, card mastery, card upgrade, chest opening, and MORE!
- Runs in the background without using mouse or keyboard input.
- [This link](https://github.com/pyclashbot/py-clash-bot/blob/master/JobListDescriptions.md) has a complete list of each task with descriptions.

## Installation

1. Download and install the latest version of [MEmu](https://www.memuplay.com/) to emulate Android.
2. Download and run the latest Windows installer for `py-clash-bot` [here](https://github.com/pyclashbot/py-clash-bot/releases/latest).

## Usage

1. Run the `py-clash-bot` shortcut on the desktop.
2. Click the start button to create a new emulator. Wait for the emulator to load.
3. `py-clash-bot` will detect that Clash Royale is not installed. You must manually install Clash Royale on the new emulator.
4. Start Clash Royale and complete the tutorial (takes 30 seconds). Then sign into your account using the SuperCell ID login (or use the fresh account).
5. Set the game language to English.
6. Restart the bot, select the desired jobs to perform, then click the `Start` button.
7. Enjoy the benefits of always-on farming with the py-clash-bot taking care of the heavy lifting for you.

## Demo

Game DemoGUI Demo

## Contribute

We welcome contributions to the py-clash-bot project. If you have an idea for a new feature or have found a bug, please open an issue on the [issues tab](https://github.com/pyclashbot/py-clash-bot/issues) or check out [how to contribute directly](https://github.com/pyclashbot/py-clash-bot/blob/master/CONTRIBUTING.md).