# Heroes of the Storm draft help Ava reads the draft screen, so you do not have to say hero names. Everything runs on the Mac: Apple's text recognition reads the screen, no model is loaded. ## One-time setup (macOS) 1. System Settings → Privacy & Security → **Screen & System Audio Recording** → allow the app that runs Ava (Terminal, iTerm or VS Code), then restart it. 2. Save the Icy Veins pages and images into `data/icyveins/raw` and `data/icyveins/images` (the hero portraits there read the ban slots). 3. `make run`, open , turn the microphone on with Ctrl+M. ## During a draft Press the **HotS** button in the header (a hexagon with an H; it lights up while the mode is on), or say "draft mode on" (or "game mode on"); the button follows the spoken commands too. Ava then watches the screen, notices a draft by herself (the map name and a ban or pick phase on screen) and answers in a few words; speech that is not a draft command gets "Say again." instead of going to the chat model. Outside draft mode Ava never looks at the screen unless you ask her to read it. Say: | You say | Ava does | |---|---| | "suggest", "ban", "what should I pick" | short advice from the current screen | | "read the draft" (or "scan the screen") | map, your team, the enemy, bans, then advice for your turn | | "read the draft and ban" | the same, then ban advice | | "what is good against Zul'jin" | the best counters | | "why" | the reasons of the last advice | | "read the last screenshot" | reads the newest saved screen instead of the live one | | "brief", "what's the plan" | what the two teams mean for the match (see below) | | "draft mode on" / "draft mode off" | switch the mode (`game_mode = true` starts every session in it) | When the match starts Ava stays quiet until the next draft screen, and draft mode stays on. ## The loading screen The loading screen shows both full teams. In draft mode Ava reads them and says the three most important things about the lineups, each as one short sentence (`loading_briefing = false` turns the voice off; say "brief", "what's the plan" or "how do we look" any time to hear it): * **Shape of the teams:** "No healer: don't overextend.", "No frontline: don't fight in the open.", "Squishy team: stay grouped." and the same for the enemy ("No enemy healer: keep trading.", "Two enemy healers: kill one first.", "Enemy is squishy: dive them."). * **Matchups:** "Johanna counters Brightwing and Cassia." (focus them), "Valla counters Tychus: protect." (from the counter lists of the hero pages). * **The map:** "Weak on Sky Temple: Tychus.", "Enemy strong on Sky Temple: Dehaka." * **Combos:** "Jaina and Johanna combo well." The heaviest notes win: missing healer, then missing frontline, then matchups, then the rest. ## Names that are said badly Names are matched by sound as well as by spelling ("Kszalatat" finds Xal'atath), limited to heroes still available. When two heroes fit, Ava asks "One Thrall or two Tyrael?"; answer with the number (or the name), so a name she misheard once is not needed again. The spelling is remembered in `data/hots_aliases.toml`. ## Other screens and windows The positions of everything on the draft screen are measured, not assumed: every ban and pick screen shows the map name and "Browse All Heroes", and the distance between them gives the scale and the middle line of the screen. So a 4K display, a laptop's 16:10 panel, a window with a title bar or a window moved on the desktop all read like full screen. The measurement is kept per capture size in `data/hots_calibration.toml` (so the loading screen, which lacks those two texts, is mapped too) and is redone when it changes. Delete the file to start over. ## Misread labels Every hero label read with certainty (exact name, clear text, locked in) teaches Ava the hero's face; the faces are kept in `data/hots_faces`. When a label is later misread (a letter cut off on the slanted text, a low resolution) the face names the hero instead. It starts empty and fills up over a few drafts; the small Icy Veins portraits only read the ban slots, because the big pick portraits are another painting. ## What is saved Every screen where the draft changed is saved to `data/game_screens//NN.png` with a `draft.json` of what Ava read. The last 20 drafts are kept. Nothing leaves the machine. ## Settings `[hots.screen]` in `config/voicemate.toml`: `enabled`, `window` (app name of the game), `poll_s`, `game_mode`, `proactive` (say "Your ban." when it is your turn), `loading_briefing`, `calibration_file`, `faces_dir`, `log_dir`, `keep`.