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)¶
System Settings → Privacy & Security → Screen & System Audio Recording → allow the app that runs Ava (Terminal, iTerm or VS Code), then restart it.
Save the Icy Veins pages and images into
data/icyveins/rawanddata/icyveins/images(the hero portraits there read the ban slots).make run, open http://localhost:8080, 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 ( |
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/<date_time>/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.