An open-source automation tool for Clash Royale on Windows and macOS. Uses Android emulation and image recognition to automate battles, card upgrades, clan tasks, and other daily gameplay.
Join our Discord for support and updates.
Battle Automation
- Trophy Road, Classic 1v1, and Classic 2v2 battles
- Randomize or cycle decks
- Optional random card plays
Progression & Clan
- Card mastery reward collection
- Automatic card upgrades
- Clan donate, card requests, and Pass gift claiming
- Real-time win/loss tracking and session stats
Accounts & Extras
- Rotate between linked Supercell accounts (2–3)
- Discord Rich Presence
- Custom UI themes
Emulator Support
- MEmu, BlueStacks 5, Google Play Games, and ADB devices
- OpenGL, DirectX, and Vulkan render modes (where supported)
Windows: Download the installer from releases and run it.
macOS: Download the DMG from releases, drag to Applications. On first launch, go to System Settings > Privacy & Security and click "Allow" for py-clash-bot.
Choose one:
MEmu (Windows only)
- Download MEmu 9.2.5.0 (alternate link)
- Run the installer
BlueStacks 5 (Windows/macOS)
- Download BlueStacks 5 (not BlueStacks X/10)
- Run the installer
Google Play Games (Windows only)
- Download the developer emulator (not BETA)
- Run the installer and complete the Google sign-in when prompted
- Start py-clash-bot
- Go to the Emulator tab and select your emulator from the dropdown
- Click Start — the bot creates the emulator instance automatically
- Install Clash Royale on the emulator via Google Play Store
- Open Clash Royale, complete the tutorial, set language to English
- Close the emulator completely
- Enable the jobs you want on the Jobs tab, then click Start again to begin automation
Default settings work for most users. Only enable "Show advanced settings" to change render mode if troubleshooting.
- Requires UEFI and Hyper-V enabled in BIOS (enable UEFI, enable Hyper-V)
- Hardware intensive — try Google Play Games on low-end machines
- Black screen or boot issues: switch render mode in bot settings (OpenGL/DirectX/Vulkan)
- Corrupt VMs from old versions: delete existing MEmu VMs or reinstall MEmu
- Must use BlueStacks 5, not BlueStacks X/10
- Expected install path:
C:\Program Files\BlueStacks_nxt - Startup fails: open Multi-Instance Manager, create a fresh "Android 13 (Tiramisu 64-bit)" instance without signing into any Google account, leave other settings as default, then start the bot again
- Black screen: switch render mode in bot settings
- Must use the DEVELOPER version, not BETA
- Hanging on boot: check for Google sign-in popup in a minimized browser window
- Rendering issues: adjust settings via System tray > Google Play Games > Graphics settings
- Installer won't download: open Task Manager > File > Run new task, paste installer path, check "Run as admin"
- Set emulator system language to English (in addition to game language)
See CONTRIBUTING.md | Discord | Issues
Source: NC-CL-1.0 | Assets: CC BY-NC-SA 4.0 | Commercial inquiries