revomonauto 0.7.0

Automation helpers for the Revomon Android game running under BlueStacks, built on top of the PymordialBlue automation framework.

RevomonAuto

Advanced automation framework for the Revomon Android game running under BlueStacks.

RevomonAuto is a high-level orchestration layer built on top of PymordialBlue, designed to provide a robust, extensible, and self-healing automation environment for Revomon.

🚀 Key Features

• 🎮 Intelligent Controller: A modular system using Python mixins to separate concerns like Battle, Navigation, and Lifecycle.
• 🛡️ Action Registry Pattern: Every game interaction is wrapped in a decorator that provides automatic retries, state verification, and detailed state-diff logging.
• 🗺️ Graph-Based Navigation: Implements BFS pathfinding to find the shortest route between locations, executing complex movement scripts defined in routes.yaml.
• ⚔️ Battle Engine: Automated combat with OCR-based data extraction for levels, HP, and PP, supporting pluggable battle strategies.
• 📺 TV Collection Manager: Background processing for scanning Revomons via the in-game TV, with automatic API integration and local database synchronization.
• 📍 Autonomous Locating: Uses pixel fingerprinting to detect current location and can automatically "resolve" generic Revocenters by walking outside.

🏗️ Architecture Overview

RevomonAuto follows a composite architecture to manage complexity:

• RevomonController: The primary entry point, combining high-level logic mixins.
• RevomonApp: The central state store, holding party information, location data, and active screen states.
• Action Handlers: Decoupled verification logic (e.g., ScreenTransitionHandler, StateUpdateHandler) that ensures actions actually succeeded.
• Navigator: A dedicated pathfinding engine that understands the game world's topology.

📦 Installation

RevomonAuto requires uv for the best experience.

uv add revomonauto

Prerequisites

• Python 3.13+
• BlueStacks 5 (Pie 64-bit recommended)
• ADB Enabled in BlueStacks settings.

🛠️ Quick Start

from revomonauto import RevomonController

# Initialize the controller (auto-detects BlueStacks)
controller = RevomonController()

# Launch and log in
controller.launch_app()
controller.login()

# Navigate to a specific location via the pathfinding graph
controller.navigate_to("drassiuscity", "gym")

# Enable autonomous features
controller.revomon.auto_battle = True
controller.revomon.auto_run = True

📚 Documentation

For detailed information on the API, core concepts, and advanced usage, please see our Full Documentation.

⚠️ Disclaimer

This project is for educational and personal use only. Use of automation tools may violate the game's Terms of Service. Use responsibly and at your own risk.

---

Built with ❤️ by IAmNo1Special.