Skip to content

Repository files navigation

AutoMonster

Automation tool for Monster Legends using ADB and OpenCV template matching.

Python 3.10+ License: MIT Latest Release

Features

  • Ads · Reduce Time · Resource Dungeons · Cavern Dungeons · Era Saga · PVP
  • Breed Monsters · Feed & Sell Monsters · Craft Runes
  • Macro System · Brightness Controls · Automatic Updates · Close Game

Installation

Quick Install (Recommended)

  1. Download the latest AutoMonster_Setup.exe from releases
  2. Run the installer and follow the prompts
  3. Launch from Start Menu or desktop shortcut

Manual Installation

For developers or advanced users:

python -m pip install --upgrade pip
pip install -r requirements.txt
python main.py

Device Setup

Emulator (Recommended)

  • Android: 5.0 to 16 (Android 17+ is not supported yet)
  • Resolution: 1280x720 (recommended)
  • DPI: 240
  • ADB: Enabled and accessible

Recommended emulators: BlueStacks (best performance), LDPlayer (lower resource usage).

Physical Device

  1. Enable Developer Options (Settings > About Phone > tap Build Number 7 times)
  2. Enable USB Debugging and Stay Awake in Developer Options
  3. Connect via USB (device appears in the dropdown automatically) or enable Wireless Debugging and enter the IP address and port manually

Usage

Commands

Select a command from the dropdown, configure its parameters, and click Set Values as Defaults to store them for next time.

Macro System

Chain commands into automated sequences via Macro Manager:

  1. Create a new macro and name it
  2. Add steps by selecting commands and configuring parameters
  3. Reorder steps with arrow buttons
  4. Enable Lower Brightness and / or Lock Device for overnight runs

Troubleshooting

  • Check the log window for status updates and errors
  • Use Stop to halt any running operation
  • Some commands are semi-automatic — click the ? help button for navigation requirements

Requirements

  • Windows (installer), macOS or Linux (manual)
  • Python 3.10+
  • ADB-capable device or emulator (Android 5.0 to 16; Android 17+ not supported yet)
  • Monster Legends at 1280x720 resolution (recommended)

Bug Reports

Disclaimer

This tool is for educational purposes. Usage may violate Monster Legends' terms of service. Use at your own risk.

License

MIT. See LICENSE.

About

Tool for doing repetitive tasks in Monster Legends

Resources

Stars

4 stars

Watchers

2 watching

Forks

Releases

Packages

Used by

Contributors

Languages