MSM Auto-Collector Bot 🎵🤖

A sophisticated, Python-based automation tool designed to streamline resource collection in My Singing Monsters. Built with computer vision and a modern GUI, this bot handles the repetitive tasks so you can focus on breeding and composing.

🚀 Features

• Smart Resource Collection: Automatically detects and collects Coins, Gems, Food, and Crystals using advanced image recognition.
• Multi-Island Routing: Navigates through your islands in a specific, optimized order (Plant -> Cold -> Air -> ... -> Tribal).
• Robust Logic:
  • Retry Mechanism: Persistently checks for resources until the area is clear (ensures nothing is missed).
  • Dynamic Asset Loading: Simply drop new island screenshots into the assets folder to expand the bot's reach without touching code.
  • Smart Navigation: Handles map opening, scrolling, and "Go" button confirmations automatically.
• Modern GUI: User-friendly interface built with customtkinter for easy configuration and control.
• Standalone Executable: Includes build scripts to compile into a portable .exe file.

🛠️ Installation & Setup

Prerequisites

• Python 3.x installed.
• My Singing Monsters (PC version).

Quick Start

1. Clone/Download this repository.

2. Install Dependencies: Open a terminal in the project folder and run:

   pip install -r requirements.txt

3. Asset Configuration (Crucial): The bot relies on visual recognition. You must populate the assets folder with screenshots from your game resolution:

   • Resources: money.png, gem.png, food.png, crystal.png
   • Navigation: map_button.png, go.png
   • Islands: island_plant.png, island_cold.png, island_air.png, etc. (Take these from the map list view).

4. Run the Bot:

   python gui.py

🔮 Roadmap & Future Propositions

We are just getting started! The vision for this bot extends far beyond simple collection. Here is what is on the horizon:

• 🧠 Intelligent Breeding: Automated breeding cycles based on desired monsters.
• 🎮 Minigame Solvers: Algorithms to automatically solve the Memory Game for extra rewards.
• ⏰ Scheduler: Built-in cron-like scheduling to run collection routines at optimal intervals.
• 📊 Statistics Dashboard: Track how much gold/diamonds you earn per day.
• Background Mode: Ability to run silently without stealing mouse focus (experimental).

🤝 Propositions & Contributing

Have an idea? Found a bug? We welcome propositions for new features!

• Pull Requests: Feel free to fork and submit PRs.
• Issues: Report glitches or suggest enhancements.

---

Disclaimer: This tool is for educational purposes. Use responsibly.