Block Blast Auto-Solver

Automatically detects and solves Block Blast puzzles from screenshots.

Features

• Auto-detection: Captures your screen and detects the game board + pieces
• Smart solving: Finds the best solution (most lines cleared)
• Visual playback: Shows step-by-step solution with Pygame GUI

Installation

pip install -r requirements.txt

Usage

Run the full GUI application

python main.py

Test detection on an image file

python board_detector.py screenshot.png

Controls (Solution Viewer)

• SPACE - Play/Pause animation
• LEFT/RIGHT - Step through manually
• UP/DOWN - Adjust playback speed
• ESC - Quit

Files

• main.py - Main application entry point
• board_detector.py - Screenshot detection (grid + pieces)
• block_blast_solver.py - Puzzle solving algorithm
• block_blast_gui.py - Pygame GUI visualization
• piece_selector.py - Manual piece selection