Navigate to the formation selection screen.

Nudge the character in a random direction to get unstuck.

Parse (name, activeness_value) pairs from the guild members list screen.

Return (raw_name, chest_count) pairs from one Contribution Ranking frame.

Parse value from various input formats to normalized float (0.0-1.0). Args: value: Input value Returns: Normalized value (0.

This is completely insane. We need to add subprocess.CREATE_NO_WINDOW to prevent tesseract from flashing a terminal every time it is used

Extract name, ascension and EX level from a hero detail screen.

Process a single hero found on screen. Returns: str: "selected", "skip", or "depleted"

Tap each request portrait and OCR its Wish Point reward value. Args: exclude: Portrait indices to skip (already exhausted this vi

Ask Qwen to name-read rows whose activeness value has no paired name.

Attempts to connect to a specific ADB device or auto resolve. Args: client (AdbClient): ADB client. Raises: GenericAdbUnreco

Restart ADB server, first trying kill-server command, then process killing.

Tap Battle to enter prep screen, copy first Records formation, and start.

Execute the Supreme Arena battle: Next, Next, Battle, wait for end. Returns: bool: True if battle completed, False otherwise.

Challenge and choose the weakest (leftmost) Supreme Arena opponent. Returns: bool: True if opponent chosen and challenge confirme

Save guild activeness records to guild_activeness.json.

Open the Ascension Panel and use OCR to confirm the hero's current rank. Args: hero_name: Hero name for logging. init

Navigate to Guild Chest Contribution Ranking and return name->chest dict. Assumes the Guild Hall is already on screen. Returns empty dict on

Selects an AFK stage template.

Select the request with the highest Wish Point reward. Reads all four request portraits, taps the one with the highest Wish Point val

Choose the active OCR backend based on GPU availability and settings. Returns (primary, fallback). - If Qwen2-VL is enabled and GPU V

Helper function to set environment variable ADBUTILS_ADB_PATH depending on OS. Raises: FileNotFoundError: ADB executable not found in PAT

Check if current formation should be skipped. Returns: True if formation should be skipped, False otherwise.

Start push.

Start Arcane Labyrinth.

Start Dream Realm battle.

Step through the records list until the target index is visible.

Determine whether to continue with Dream Realm battles. Args: spend_gold (bool, optional): Buy DR attempts. Defaults to False.

Add Qwen-detected chest entries not found by RapidOCR (e.g. Korean).

Perform a single essence swap.

Try to kill ADB server using adb kill-server command. Returns: True if successful, False otherwise

Attempts to connect to a device by using common ports and device IDs. This is specifically for people who did not read the user guide. And al

Check for and handle the Skip button if present. If the Skip button is visible, tap it and confirm the popup. Battle attempts will st

Validate that opposing crop values don't exceed 100% combined. Raises: ValueError: If left+right or top+bottom would crop entire

Validate that pixel crop values don't exceed image dimensions. Args: horizontal_crops: Tuple of (left_px, right_px) vertical_crop

Global application settings (loaded from App.toml).

Assist Synergy and Corrupt Creature.

Attempt to run Frostfire Showdown Battles.

Attempt to run quests in quest log.

Attempt to run Sunlit Showdown Battles.

Builds argparse.ArgumentParser.

Purchase single pull and optionally affinity items.

Claim daily AFK rewards.

Claim rewards from hamburger menu.

Close the connection.

Convert GameMetadata to GameGUIOptions for GUI IPC.

Return the number of CPU cores. Args: logical (bool): If True, return logical cores (including hyperthreading).

Create an image with distinct text blocks.

Create a checkered pattern image for easy verification. Args: width: Image width height: Image height squ

Create a new AdbDeviceWrapper instance from ADB Settings.

Create a gradient image.

Create an image with a rectangular pattern at specified location.

Create an image with paragraph structure.

Discover modules, find valid classes, and add them to the globals.

Extract (name, chest_count) pairs from a guild chest contribution screen. Supplements RapidOCR for multilingual names (Korean, etc.).

Return the first matching template found on the screen. Reuses a single screenshot for all template comparisons. Args: t

Tries multiple scales to find the one with the highest match confidence.