Skip to main content

Heroes of the Storm Game Events

Please read the overwolf.games.events documentation page to learn how to use Overwolf game events.

Game ID

10624

Sample Apps

Available Features

Game events status

It's highly recommended to communicate errors and warnings to your app users. Check game event status here or easily check game event status from your app using our API.

gep_internal

Info Updates

keyCategoryValuesNotesSince GEP Ver.
gep_internalgep_internalLocal + Public version numberSee notes143.0

gep_internal note

Data Example:

{"info":{"gep_internal":{"version_info":"{"local_version":"157.0.1","public_version":"157.0.1","is_updated":true}"}},"feature":"gep_internal"}

me

Info Updates

keyCategoryValuesNotesSince GEP Ver.
battletagmeBattletag of local playerSee notes134.0

battletag note

Data Example:

{"info":{"me":{"battletag":"Shargaas#2430"}},"feature":"me"}

match_info

Info Updates

keyCategoryValuesNotesSince GEP Ver.
pseudo_match_idmatch_infoCurrent match’s ID code.See notes134.0
teams_levelmatch_infoCurrent level of both teamsSee notes134.0
scorematch_infoCurrent kill-score of both teams.See notes134.0
match_statematch_infoIs a match in progress - true/false.See notes134.0
game_modematch_infoCurrent match's game_modeSee notes134.0
draft_XXmatch_infoCurrently selected hero for draftSee notes134.0
bans_XXmatch_infoCurrently selected hero for banSee notes134.0

Events

EventEvent DataFired WhenNotesSince GEP Ver.
match_startnullMatch startsSee notes134.0
match_endvictory/defeatMatch endsSee notes134.0
talent_availablenullA skill point is available for use.See notes134.0
gates_openednullWhen pregame preparation countdown has ended and the match begins.See notes134.0

pseudo_match_id note

The reason that pseudo_match_id is different for each player is that its internal Overwolf info that created for highlights recording capabilities. You should not use it to determine that individual players are playing in the same match. For that, you should use the roster info.

Data Example:

{"info":{"match_info":{"pseudo_match_id":"055accd3-5948-4444-903a-12400d484d4b"}}, "feature":"match_info"}

teams_level note:

Data Example:

{"info":{"match_info":{"teams_level":{"order":1, "chaos":1}}}, "feature":"match_info"}

score note:

Data Example:

{"info":{"match_info":{"score":{"order":8, "chaos":19}}}, "feature":"match_info"}

match_state note:

Data Example:

{"info":{"match_info":{"match_state":{"in_progress":true}}}, "feature":"match_info"}

game_mode note:

Data Example:

{"info":{"match_info":{"game_mode":"ranked_play"}},"feature":"match_info"}

Possible game_mode values:

"ai_play", "quick_play", "ranked_play", "unranked_play"

draft note:

Data Example:

{"info":{"match_info":{"draft_6":"{"player_name" : "Azurites","hero_name" : "Valeera"}"}},"feature":"draft"}
{"info":{"match_info":{"draft_6":"{"player_name" : "Azurites","hero_name" : "Mei"}"}},"feature":"draft"}

bans note:

Data Example:

{"info":{"match_info":{"bans_1":"{"hero_name" : "Mei"}"}},"feature":"bans"}
{"info":{"match_info":{"bans_1":"{"hero_name" : "Valeera"}"}},"feature":"bans"}
match_start note:

Data Example:

{"events":[{"name":"match_start", "data":""}]}
match_end note:

Data Example:

{"events":[{"name":"match_end", "data":"victory"}]}

talent_available note:

Data Example:

{"events":[{"name":"talent_available", "data":""}]}

gates_opened note:

Data Example:

{"events":[{"name":"gates_opened", "data":""}]}

game_info

Info Updates

keyCategoryValuesNotesSince GEP Ver.
scenegame_infoCurrent menu stateSee notes134.0

scene note:

Data Examples:

{"info":{"game_info":{"scene":"loading_screen"}},"feature":"game_info"}
{"info":{"game_info":{"scene":"hero_select"}}, "feature":"game_info"}
{"info":{"game_info":{"scene":"unranked_preparing"}}, "feature":"game_info"}
{"info":{"game_info":{"scene":"collection"}}, "feature":"game_info"}
{"info":{"game_info":{"scene":"home"}}, "feature":"game_info"}
{"info":{"game_info":{"scene":"ai_search"}}, "feature":"game_info"}
{"info":{"game_info":{"scene":"loot"}}, "feature":"game_info"}
{"info":{"game_info":{"scene":"quick_search"}}, "feature":"game_info"}
{"info":{"game_info":{"scene":"ranked_preparing"}}, "feature":"game_info"}
{"info":{"game_info":{"scene":"ranked_search"}}, "feature":"game_info"}
{"info":{"game_info":{"scene":"score"}}, "feature":"game_info"}
{"info":{"game_info":{"scene":"unknown_hots_game_scene"}}, "feature":"game_info"}

roster

Info Updates

keyCategoryValuesNotesSince GEP Ver.
rostergame_infoFull player rosterSee notes134.0

roster note:

Provided data:

  • player_level
  • battletag
  • if local = true/false
  • team - chaos/order
  • hero_name

For a full list of hero names check the following link

Data Example:

{ 
"info":{
"roster":{
"roster":"{"Cerese":{
"player_name":"Cerese",
"battletag":"Cerese#2249",
"player_level":"811",
"hero_name":"Ana",
"local":false,
"team":"order"
},
"DREADr":{
"player_name":"DREADr",
"battletag":"DREADr#2716",
"player_level":"1001",
"hero_name":"Falstad",
"local":false,
"team":"chaos"
},
"Devastator":{
"player_name":"Devastator",
"battletag":"Devastator#22538",
"player_level":"454",
"hero_name":"Valla",
"local":false,
"team":"order"
},
"Hostik":{
"player_name":"Hostik",
"battletag":"Hostik#2133",
"player_level":"975",
"hero_name":"Abathur",
"local":false,
"team":"order"
},
"Kafei":{
"player_name":"Kafei",
"battletag":"Kafei#2771",
"player_level":"250",
"hero_name":"Nova",
"local":false,
"team":"order"
},
"Monomax":{
"player_name":"Monomax",
"battletag":"Monomax#2130",
"player_level":"813",
"hero_name":"Artanis",
"local":false,
"team":"chaos"
},
"SouthernUral":{
"player_name":"SouthernUral",
"battletag":"SouthernUral#2738",
"player_level":"1379",
"hero_name":"Rehgar",
"local":false,
"team":"chaos"
},
"ladyboner":{
"player_name":"ladyboner",
"battletag":"ladyboner#2168",
"player_level":"519",
"hero_name":"Zarya",
"local":false,
"team":"chaos"
},
"moustacho":{
"player_name":"moustacho",
"battletag":"moustacho#21261",
"player_level":"264",
"hero_name":"Imperius",
"local":false,
"team":"order"
},
"?????????":{
"player_name":"?????????",
"battletag":"?????????#2698",
"player_level":"40",
"hero_name":"Butcher",
"local":true,
"team":"chaos"
}
} "
}
},
" feature":"roster"
}

kill

Events

EventEvent DataFired WhenNotesSince GEP Ver.
killnullLocal player kills an opponent.See notes134.0
assistnullLocal player takes part in the killing of an opponent.See notes134.0
minion_killnullLocal player kills a minion.See notes134.0
takedownnullLocal player kills an opponent.See notes134.0

kill note:

Data Example:

{"events":[{"name":"kill", "data":""}]}

assist note:

Data Example:

{"events":[{"name":"assist", "data":""}]}

minion_kill note:

Data Example:

{"events":[{"name":"minion_kill", "data":""}]}

takedown note:

Data Example:

{"events":[{"name":"takedown" ,"data":""}]}

death

Events

EventEvent DataFired WhenNotesSince GEP Ver.
deathnullLocal player dies.See notes134.0

death note:

Data Example:

{"events":[{"name":"death", "data":""}]}