py-clash-bot

py-clash-bot is an open-source automation tool that allows you to automate your Clash Royale gameplay on Windows using an emulated Android phone. The bot uses advanced image recognition, mouse control, and Android emulation to perform a comprehensive range of tasks automatically, letting you focus on strategy while it handles the daily grind.

Join our Discord server for support, updates, and community discussions!

✨ Features

🎮 Battle Automation

• Trophy Road 1v1 Battles - Automatically fight in trophy road ladder matches
• Path of Legends 1v1 Battles - Battle in the competitive Path of Legends mode
• 2v2 Battles - Team up with clan members for 2v2 matches
• War Battles - Participate in clan war battles automatically
• Random Decks - Randomize your deck selection before each battle
• Random Plays - Play cards randomly (ideal for low-end machines)
• Smart Battle Management - Skip fights when chests are full, disable win/loss tracking

🎁 Rewards & Collection

• Chest Management - Automatically unlock and open chests earned from battles
• Battlepass Rewards - Collect battlepass rewards (works for non-battlepass owners too)
• Card Mastery Rewards - Collect mastery rewards earned from battles
• Daily Challenges - Automatically claim daily and weekly challenge rewards
• Level Up Rewards - Collect level up chests and rewards
• Bannerbox Chests - Open bannerbox crates for additional rewards
• Trophy Road Rewards - Collect rewards from climbing the trophy ladder
• Season Shop - Automatically spend currency from 2v2 battles and events

🃏 Card Management

• Card Requests - Automatically request cards from your clan
• Card Donations - Donate cards to clan members
• Free Donations - Donate cards without spending gold
• Shop Management - Buy daily free shop offers and gold offers
• Card Upgrades - Upgrade your current deck after each battle
• Bulk Upgrades - Upgrade all cards in your collection

⚙️ Advanced Settings

• Account Switching - Switch between multiple accounts using SuperCell ID
• MEmu Integration - Optimized for MEmu Android emulator
• Render Mode Selection - Choose between OpenGL and DirectX rendering
• Real-time Statistics - Track wins, losses, chests opened, and more
• Performance Monitoring - Monitor bot runtime, failures, and account switches

📊 Comprehensive Statistics

The bot tracks detailed statistics across three categories:

• Battle Stats: Wins, losses, win rate, cards played, battle counts by mode
• Collection Stats: Requests, donations, chests unlocked, rewards collected
• Bot Stats: Runtime, failures, account switches, and performance metrics

🚀 Installation

Prerequisites

1. Windows 10/11 operating system
2. MEmu Android Emulator - Download from MEmu Play

Setup Steps

1. Install MEmu - Download and install the latest version of MEmu
2. Download py-clash-bot - Get the latest Windows installer from releases
3. Install py-clash-bot - Run the downloaded installer

📖 Usage

Initial Setup

1. Launch py-clash-bot - Use the desktop shortcut created during installation
2. Create Emulator - Click "Start" to create a new MEmu emulator instance
3. Install Clash Royale - Manually install Clash Royale on the new emulator
4. Complete Tutorial - Finish the in-game tutorial (takes ~30 seconds)
5. Account Login - Sign in with your SuperCell ID or use a fresh account
6. Language Setting - Ensure the game language is set to English

Running the Bot

1. Select Jobs - Choose which tasks you want the bot to perform
2. Configure Settings - Set up account switching, render modes, and preferences
3. Start Bot - Click the "Start" button to begin automation
4. Monitor Progress - Watch real-time statistics and status updates
5. Enjoy Automation - Let the bot handle your daily Clash Royale tasks!

🎯 Demo

Left: Bot automation in action | Right: User interface and controls

🤝 Contributing

We welcome contributions from the community! Whether you have ideas for new features, bug reports, or want to help with development, there are many ways to get involved:

• Report Issues - Open an issue on GitHub Issues
• Feature Requests - Suggest new automation features or improvements
• Code Contributions - Check out our Contributing Guide
• Community Support - Help other users on our Discord server

⚠️ Disclaimer

This tool is designed for educational and automation purposes. Please ensure you comply with Clash Royale's Terms of Service and use responsibly. The developers are not responsible for any consequences resulting from the use of this software.

---

Made with ❤️ by the py-clash-bot community

Automate your Clash Royale experience and focus on what matters most - strategy and fun!