🎮 Simplicity - Clash of Clans Bot

⚡ Currently working on version 17.477.9

An advanced automation bot for Clash of Clans featuring intelligent attack strategies, resource collection, and multi-account management.

🇧🇷 Versão em Português

---

✨ Features

🎯 Attack Strategies

• Dragon Attack - Powerful dragon-based raid strategy
• Electro Dragon Attack - Advanced electro dragon deployment
• Smart Troop Deployment - AI-powered troop placement
• Hero Management - Automatic hero ability activation
• Spell Casting - Intelligent rage and freeze spell usage

🏆 Automation

• ⚡ Auto-Farm - Automatic resource collection (Gold, Elixir, Dark Elixir)
• 🎮 Multi-Account Support - Manage up to 5 accounts simultaneously
• 📊 Statistics Tracking - Real-time attack stats and resource gains
• 🎪 Clan Games - Automated clan games participation
• 🏰 Clan Capital - Clan capital raid automation
• 💎 Collector Management - Smart resource collector emptying

🛠️ Technical Features

• 🖼️ Computer Vision - Advanced template matching using OpenCV
• 🤖 ADB Integration - Full Android Debug Bridge support
• 📱 Emulator Support - Compatible with MEmu, BlueStacks, LDPlayer
• 🔄 Smart Reconnection - Automatic connection recovery
• 🎨 Modern GUI - Built with PyQt5

---

📋 Requirements

• Python 3.12+
• Android Emulator (MEmu, BlueStacks, or LDPlayer)
• ADB (Android Debug Bridge)
• Windows OS

Dependencies

opencv-python (cv2)
numpy
PyQt5
torch
torchvision
easyocr
adbutils
scikit-learn
scikit-image

---

🚀 Quick Start

1. Installation

# Clone the repository
git clone https://github.com/luizunc/SimplicityBot.git
cd simplicity

# Install dependencies
pip install -r requirements.txt

2. Setup Your Emulator

1. Install an Android emulator (MEmu recommended)
2. Enable ADB debugging in emulator settings
3. Set emulator resolution to 1600x900
4. Install Clash of Clans on the emulator

3. Run Simplicity

# Run the executable
Simplicity.exe

Or run from source:

python main.py

4. Configure

1. Connect Device - Select your emulator from the device list
2. Load Account - Add your account credentials
3. Choose Attack Strategy - Select Dragon or Electro Dragon attack
4. Set Criteria - Configure attack filters (gold, elixir, trophies)
5. Start Bot - Click start and let Simplicity do the work!

---

📖 Usage

Attack Configuration

The bot supports two main attack strategies:

🐉 Dragon Attack

• Deploys 14 dragons in strategic pattern
• Includes balloon support troops
• Siege machine deployment
• All heroes with ability activation
• Rage and freeze spell timing

⚡ Electro Dragon Attack

• Deploys 10 electro dragons
• Optimized for chain lightning damage
• Same hero and spell support as dragon attack

Profile Management

Manage multiple accounts with individual statistics:

• Gold collected
• Elixir collected
• Dark Elixir collected
• Total attacks
• Star distribution (0★, 1★, 2★, 3★)

---

🎯 Attack Patterns

The bot uses sophisticated coordinate-based deployment:

• Left Side Attack - Attacks from top-left corner
• Right Side Attack - Attacks from top-right corner
• Random Selection - Randomly chooses attack side each raid

Troop Deployment Order

1. Dragons / Electro Dragons
2. Event troops (if available)
3. Balloons
4. Siege Machine
5. Heroes (Queen, King, Warden, Prince, Royal Champion)
6. Rage Spells
7. Freeze Spells

---

📊 Statistics

Track your farming progress with detailed statistics:

{
  "gold": 1500000,
  "elixir": 1200000,
  "de": 15000,
  "attacks": 150,
  "stars": {
    "0": 10,
    "1": 30,
    "2": 60,
    "3": 50
  }
}

---

🔧 Advanced Configuration

Custom Attack Patterns

Edit attacks/attacks.py to customize deployment coordinates:

DRAGON_L = [
    (170,384), (214,348), (246,327), ...
]

Template Matching

Add custom templates in Templates/ folder:

• PNG format
• Grayscale recommended
• Match threshold: 0.52

---

🛡️ Safety Features

• Connection Monitoring - Detects and handles connection losses
• Error Recovery - Automatic recovery from game errors
• Account Protection - Secure credential management
• Smart Delays - Human-like timing between actions

---

📸 Screenshots

The bot includes visual recognition for:

• Troop tabs (dragons, balloons, heroes)
• Spell tabs (rage, freeze)
• Game states (loading, battle, home)
• Resource collectors
• Clan features

---

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the project
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

⚠️ Disclaimer

This bot is for educational purposes only. Use at your own risk. The developers are not responsible for any bans or penalties from Supercell. Using bots violates Clash of Clans Terms of Service.

---

🌟 Support

If you find this project helpful, please give it a ⭐ star!

Issues & Support

• 🐛 Report a Bug
• 💡 Request a Feature
• 💬 Discussions

---

🏷️ Tags

#clashofclans #coc #bot #automation #python #opencv #gaming #farmbot #clash #supercell #android #adb #ai #computervision #gamebot #mobilebot #emulator #pytorch #machinelearning #cocbot #clashbot #autofarm #gaming-automation #python-bot #opencv-python #pyqt5 #gui-application #multi-account #resource-farming #attack-strategy