Detect text blocks and return results with bounding boxes. Args: image: Input RGB image as numpy array min_confidence

Calculate Euclidean distance to another point.

Returns the percentage of pixels that match the color.

Returns all Tasks for all Games.

Get resource dir.

Check if an image is grayscale. An image is considered grayscale if it has only two dimensions, i.e., shape (height, width), without

Return True if the OS is macOS (Darwin).

Creates a new log message with the current UTC timestamp.

PP-OCRv4 detection + PP-OCRv5 recognition for better name accuracy. Explicitly sets engine_type and model_type required by rapidocr>=3.9.0.

Press and immediately release a key.

Set display size. Args: display_size: format width x height e.g. 1080x1920

Return the OS name (e.g., Windows, Linux, Darwin).

Convert a BGR image to RGB format. Args: image (np.ndarray): Input image in BGR color format. Returns: np.nd

Wait until the template is no longer visible on screen. Args: template (str | Path): Template to monitor. threshold (

Add the extras directory to sys.path and persist it via a .pth file.

Logs the number of keys farmed. Args: keys (int): Number of keys.

Start labyrinth battle.

Claim free Arena attempts. Returns: bool: True if free attempt claimed, False not available.

Click a hero for affinity and go next.

Close out weekly reward and weekly notice popups. Returns: bool: True if notices were closed, False otherwise.

Replace OCR-misread names with the closest matching guild member name.

Return the closest guild member name to `name`.

Enter homestead if not already there. Uses the stacked-coins icon (top-right) as the definitive signal that we are inside homestead.

Enter Arena.

Extract categories from game metadata, preserving order and uniqueness.

Locate the battle screen by looking for 'Records' or 'Battle' button.

Send summary via callback if available.

Return test image. Returns: np.ndarray: Test image

Return the game's module name (segment after 'games' in module path).

Cluster names into groups where each pair is fuzzy-similar.

Handle Arcane Labyrinth.

Handles a single pass through formations. Args: use_suggested_formations: if True copy formations from Records skip_m

Handle entering the labyrinth.

Open emote menu and click the appropriate quest gesture.

Close out of guide popups.

Craft a missing ingredient via the grey action-button sub-flow. Flow: 1. Tap the grey action button -> a popup like the missing-r

Handles a single stage of a battle. Returns: bool: True if the battle was successful, False if not.

Check if on Legend Trial tower select (Season or non-Season).

Return True only when `text` looks like a real player name.

Load hero synonyms from disk (user-downloaded version preferred).

Return sys.modules patches for torch and transformers. Args: proc_cls: mock to use as Qwen2VLProcessor. model_cls: mo

Tap the Guild tab in the bottom nav and wait for the hall view to load. Returns True if the Guild Hall is reached, False if the tab is not fo

Normalize numeric value to 0.0-1.0 range. Args: value: Numeric value Returns: Normalized value (0.0-1.0) Raises:

Run the bounding-box OCR path. Returns (parsed_rows, debug_rows, ocr_results).

Install packages into an isolated extras directory. Uses ``--target`` instead of the main venv so that already-loaded .dll/.pyd files

Release D-pad.

Navigate to the Guild Members screen and scan all member activeness.

Collect all (rank, name) observations, then canonicalize.

Scan Supreme Arena rankings, filter by Guild Members, and export results.

Determine if chunked streaming should be used based on emulator brand.

Begin battle. Returns: bool: True if battle started, False otherwise.

Replace non-ASCII diacritics with their base ASCII equivalents.

Map Cyrillic characters to visually similar Latin homoglyphs.

Wait for template to appear and tap. Args: template: Template path description: Template description (for logging)

Return coordinates as a string formatted for adb shell commands.

Assert frame and input lag are below acceptable thresholds. Intended for bots that need fast input/reaction time. Args: