How jooi025/brawlstarsbot works
BrawlStarsBot automates solo-showdown mastery farming in Brawl Stars running through BlueStacks. Its main workflow captures the game window, detects players, bushes, and enemies, then drives movement and combat while screen-state automation handles defeat, loading, and requeue actions. Configuration and bundled YOLO models support that loop; the README also documents a separate helper for measuring a brawler’s height scale factor. Source excerpts are partial, so some runtime data wiring is represented only where supported by the documented workflow.
Main entry points: main.py Runtime Orchestrator · constants.py Bot Configuration · screendetect.py Screen-State Detection · bot.py Combat / Bush Logic
Components 11
Bot Runtime
- Runtime Orchestrator
main.py - Bot Configuration
constants.py - Combat / Bush Logic
modules/bot.py - Brawler Stats
brawler_stats.json
Game Perception
- Window Capture
modules/windowcapture.py - YOLO Detection
modules/detection.py - YOLO Models
yolov8_model
Match Automation
- Screen-State Detection
modules/screendetect.py
Brawler Setup
- Height-Scale Helper
hsf_finder.py
Other components
- Operator
- BlueStacks / Game
Connections 16
- Operator → Runtime Orchestrator: starts bot
- Runtime Orchestrator → Window Capture: starts capture
- Runtime Orchestrator → YOLO Detection: starts detector
- Runtime Orchestrator → Screen-State Detection: starts monitor
- Runtime Orchestrator → Combat / Bush Logic: starts / stops
- Runtime Orchestrator → Bot Configuration: reads settings
- Bot Configuration → Brawler Stats: loads stats
- Bot Configuration → YOLO Models: selects model
- Window Capture → YOLO Detection: provides frames
- YOLO Detection → Combat / Bush Logic: provides detections
- Combat / Bush Logic → BlueStacks / Game: controls movement / combat
- Screen-State Detection → BlueStacks / Game: checks pixels / clicks
- Screen-State Detection → Runtime Orchestrator: reports match state
- Runtime Orchestrator → BlueStacks / Game: selects foreground window
- Operator → Height-Scale Helper: measures brawler
- Height-Scale Helper → Operator: returns scale factor