A Python-based automation tool for Monster Legends, designed to handle repetitive tasks efficiently.
- 🎯 Introduction
- ⚙️ Features
- 💻 Installation
- 🔄 Updates
- 🕹️ Setting Up an Emulator
- 💬 Usage and Interface
- 🚨 Disclaimer
- 🤝 Contributing
- 📜 License
The Auto Monster Project is a Python-based automation tool for the game Monster Legends. It is designed to handle repetitive tasks within the game, such as playing ads, doing dungeons, etc. Please note that while the project is functional, it is still in active development and may undergo changes and improvements.
Compatibility: The Auto Monster Project can be used on both phones and tablets via USB debugging, although it is primarily designed for desktop use with emulators. Mobile device compatibility requires:
- USB debugging enabled in developer options
- Device resolution support (may require testing)
Note: Phone compatibility is still under development and not fully tested on all devices.
Current implementation status of major features:
✅ Fully Working:
- Monster-Wood ad automation
- Era Saga dungeon progression
- Daily Resource Dungeons:
- Gem Dungeon
- Rune Dungeon
- Maze Coin Dungeon
- Cavern Dungeons:
- Ancestral Caverns (Evaris, Geneza, Jestin, etc.)
- Era Caverns (Historia, Multiverse, etc.)
- Automatic team management
- Multi-dungeon automation
- PVP automation:
- Auto battles
- Box management
- Box timer reduction
- Brightness controls for overnight runs
- Device connectivity:
- Real device support (USB and wireless)
Configure your emulator (see below)
- Download the latest AutoMonster_Setup.exe
- Run the installer and follow the prompts
- Launch from Start Menu or desktop shortcut
For developers or advanced users:
- Clone the repository
- Install dependencies:
pip install -r requirements.txt - Run
python main.py
The application includes an automatic update system that:
- Checks for updates on startup
- Downloads and installs new versions
- Preserves your settings
- Handles asset management
Updates are installed seamlessly without manual intervention.
- Resolution: 1280x720 (required)
- DPI: 240
- ADB enabled and accessible
-
BlueStacks (Recommended)
- Best overall performance
- Easy ADB setup
- Stable with Monster Legends
-
LDPlayer
- Good gaming performance
- Lower resource usage
- Simple configuration
- Install your chosen emulator
- Configure resolution and DPI settings
- Enable ADB in emulator settings
- Install Monster Legends APK (from APKPure recommended)
- Test the game runs smoothly
-
Enable Developer Options:
- Go to Settings > About Phone
- Tap Build Number 7 times
- Enter your device PIN if prompted
-
Enable USB Debugging:
- Go to Settings > Developer Options
- Enable USB Debugging
- Enable "Stay Awake" (prevents screen timeout)
-
Connect Device:
- Use a quality USB cable
- Select "File Transfer" mode when prompted
- Accept USB debugging prompt on device
- Install device drivers if needed
-
First enable USB debugging as described above
-
Enable Wireless Debugging:
- Keep device and computer on same network
- Go to Developer Options > Wireless Debugging
- Enable Wireless Debugging
- Tap "Pair device with pairing code"
- Note the IP address and port (e.g., 192.168.1.100:5555)
-
Connect Device:
- Launch AutoMonster
- Enter the IP address and port in wireless connection field
- Click "Connect Wireless"
- Accept the debugging prompt on device
-
Test Connection:
- Verify preview window shows your device screen
- Check connection status in log window
- Ensure stable network connection for reliability
When you first launch AutoMonster, you'll see the device selection screen:
- Lists all available devices (emulators and phones)
- Shows connection status and resolution
- Allows testing connection before proceeding
- Remembers last used device
- Launch AutoMonster
- Connect your device via USB or wireless
The interface consists of three main panels:
- Command Selection: Dropdown menu to choose automation task
- Task Parameters: Configurable settings for each command
- Control Buttons:
- Start: Begin automation
- Stop: Halt current task
- Save Settings: Store current parameters as defaults
- Live preview of your device screen
- Brightness controls:
- Lower Brightness: Reduce screen brightness
- Reset Brightness: Return to auto brightness
- Detailed descriptions of selected commands
- Parameter explanations
- Tips and requirements
The macro system allows you to create automated sequences of commands that can be run consecutively.
- Click "Macro Manager" in the main interface
- Click "New Macro" and enter a name
- Select commands and configure their parameters
- Click "Add Step" to add each command to the macro
- Use arrow buttons to reorder steps if needed
- Steps can be reordered using ▲▼ buttons
- Individual steps can be removed with ✕ button
- Entire macros can be deleted using "Delete Macro"
- Lower Brightness: Reduces screen brightness during macro execution
- Lock Device: Automatically locks device after macro completion
- Run Monster-Wood ads
- Complete Gem Dungeon
- Complete Rune Dungeon
- Run Era Saga battles
- Monitor the log window for status updates and errors
- Use the preview window to verify automation is working correctly
- For overnight runs, consider using brightness controls
- If automation seems stuck, check the log window for errors
- Use the Stop button to halt current operations
- Refresh device connection if preview becomes unresponsive
This tool is for educational purposes. Usage may violate Monster Legends' terms of service. Use at your own risk and responsibility.
Contributions welcome! Please:
- Fork the repository
- Create a feature branch
- Submit a pull request
Found a bug? You can:
- Message me on Reddit: @some-guy250
- Open an issue on GitHub
Licensed under MIT License - see LICENSE file for details.