How magicstrangelzb/hearthstonelegendarriver works
HSLegendArriver automates Hearthstone matches from a browser-based control panel: users configure and calibrate the screen, start automation, and the runtime observes game state, processes recommendation-panel text, validates actions, and clicks through the game. Separate branches provide environment checks, live logs and overlays, and Hearthstone liveness monitoring. The recommendation flow excerpt shows execution and result verification; several other connections are based on the SOURCE INDEX or README rather than inspected implementation, so those links are limited to documented or indexed relationships.
Main entry points: web_ui.py Web console · FSM_action.py Match automation · recommendation_flow.py Recommendation execution · desktop_capture.py Recommendation capture
Components 29
Control and actions
- Match automation
FSM_action.py - Manual controller
manual_controller.py - Game clicks
click.py - Strategy logic
strategy.py
Recommendation processing
- Recommendation capture
src/capture/desktop_capture.py - Paddle OCR
src/ocr/paddle_adapter.py - OCR preprocessing
src/ocr/preprocess.py - Stable OCR reader
src/ocr/stable_reader.py - Instruction parser
src/parser/recommendation_parser.py - Recommendation protocol
src/recommendation_models.py - Recommendation execution
src/flow/recommendation_flow.py - Action adapter
src/game_state/recommendation_adapter.py
Game state and safety
- Recommendation validator
src/safety/recommendation_validator.py - Screen state detection
get_screen.py - Liveness monitor
src/safety/hearthstone_liveness.py
Operator tools
- Web console
web_ui.py - Runtime configuration
config.py - Screen regions
screen_regions.py - Calibration overlay
region_overlay.py - Environment checks
selfcheck.py
Logs and status
- Log overlay
log_overlay.py - Automation status
log_state.py - Log processing
log_op.py - Power log
power_log.py - Console reporting
print_info.py
Other components
- Operator
- Browser UI
- Hearthstone
- Hearthstone Box
Connections 40
- Operator → Browser UI: uses
- Browser UI → Web console: controls
- Web console → Match automation: starts automation
web_ui.py - Web console → Environment checks: runs checks
web_ui.py - Web console → Screen regions: configures regions
web_ui.py - Web console → Calibration overlay: toggles calibration
web_ui.py - Web console → Log overlay: shows overlay
web_ui.py - Web console → Liveness monitor: shows status
web_ui.py - Runtime configuration → Screen regions: provides coordinates
config.py - Screen regions → Screen state detection: uses state detection
screen_regions.py - Screen regions → Recommendation capture: configures capture
screen_regions.py - Calibration overlay → Screen regions: displays regions
region_overlay.py - Match automation → Screen state detection: reads game state
FSM_action.py - Match automation → Recommendation execution: runs recommendation flow
FSM_action.py - Match automation → Manual controller: uses controller
FSM_action.py - Match automation → Strategy logic: uses strategy
FSM_action.py - Match automation → Automation status: updates status
FSM_action.py - Match automation → Liveness monitor: checks liveness
FSM_action.py - Recommendation execution → Recommendation capture: obtains frames
- Recommendation execution → Stable OCR reader: reads recommendation
- Recommendation execution → Instruction parser: parses instruction
- Recommendation execution → Recommendation validator: validates action
src/flow/recommendation_flow.py - Recommendation execution → Action adapter: adapts action
- Recommendation execution → Manual controller: executes action
src/flow/recommendation_flow.py - Manual controller → Game clicks: issues clicks
manual_controller.py - Recommendation capture → Recommendation protocol: creates evidence
src/capture/desktop_capture.py - Paddle OCR → Recommendation protocol: creates OCR evidence
src/ocr/paddle_adapter.py - Stable OCR reader → OCR preprocessing: uses preprocessing
src/ocr/stable_reader.py - Instruction parser → Recommendation protocol: creates proposal
src/parser/recommendation_parser.py - Action adapter → Recommendation protocol: maps proposal
src/game_state/recommendation_adapter.py - Liveness monitor → Power log: checks freshness
src/safety/hearthstone_liveness.py - Log processing → Power log: reads log
log_op.py - Automation status → Log processing: uses log processing
log_state.py - Automation status → Console reporting: reports status
log_state.py - Web console → Automation status: reads status
web_ui.py - Web console → Log processing: uses logging
web_ui.py - Recommendation capture → Hearthstone: captures desktop
src/capture/desktop_capture.py - Recommendation capture → Hearthstone Box: checks panel
src/capture/desktop_capture.py - Game clicks → Hearthstone: operates game
- Environment checks → Hearthstone: checks installation
selfcheck.py