Overwolf

Overwolf

  • Getting Started
  • Docs
  • API
  • Events Status
  • Blog
  • Q&A
  • Support

›Available Game Events

API Reference

  • Changelog
  • Overview

App Manifest

  • manifest.json
  • Validate your manifest

Available Game Events

  • Games IDs
  • Apex Legends
  • Call of Duty: Warzone
  • CS:GO
  • Dota 2
  • Final Fantasy XIV
  • Dota Underlords
  • Escape From Tarkov
  • Fortnite
  • Hearthstone
  • Heroes of the Storm
  • Legends of Runeterra
  • League of Legends
  • Minecraft
  • MTG Arena
  • Overwatch
  • Path of Exile
  • PUBG
  • PUBG Lite
  • Rainbow Six Siege
  • Rocket League
  • StarCraft II
  • Teamfight Tactics
  • Valorant
  • World of Tanks
  • World of Warcraft
  • World of Warships
  • Warframe
  • Various External APIs

Game Launchers Events

  • Launchers IDs
  • LOL Launcher

overwolf.benchmarking

  • overwolf.benchmarking

overwolf.campaigns

  • overwolf.campaigns.crossapp

overwolf.cryptography

  • overwolf.cryptography

overwolf.extensions

  • overwolf.extensions
  • overwolf.extensions.current
  • overwolf.extensions.sharedData
  • overwolf.extensions.io

overwolf.games

  • overwolf.games
  • overwolf.games.events
  • overwolf.games.inputTracking
  • overwolf.games.launchers
  • overwolf.games.launchers.events

overwolf.io

  • overwolf.io
  • overwolf.io.paths

overwolf.logitech

  • overwolf.logitech
  • overwolf.logitech.arx
  • overwolf.logitech.led

overwolf.media

  • overwolf.media
  • overwolf.media.audio
  • overwolf.media.replays
  • overwolf.media.videos
  • Highlights supported games

overwolf.os

  • overwolf.os
  • overwolf.os.tray

overwolf.profile

  • overwolf.profile
  • overwolf.profile.subscriptions

overwolf.settings

  • overwolf.settings
  • overwolf.settings.hotkeys
  • overwolf.settings.language
  • overwolf.settings.games

overwolf.social

  • overwolf.social
  • overwolf.social.reddit
  • overwolf.social.youtube
  • overwolf.social.discord
  • overwolf.social.gfycat
  • overwolf.social.twitter

overwolf.streaming

  • overwolf.streaming

overwolf.tobii

  • overwolf.tobii

overwolf.utils

  • overwolf.utils

overwolf.web

  • overwolf.web
  • overwolf.web.webserver
  • overwolf.web.websocket

overwolf.windows

  • overwolf.windows
Edit

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

  • HOTS game events sample app

Available Features

  • gep_internal
  • match_info
  • me
  • game_info
  • roster
  • death
  • kill

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":""}]}
Last updated on 2020-10-4 by Sh4rgaas
← HearthstoneLegends of Runeterra →
  • Sample Apps
  • Available Features
  • Game events status
  • gep_internal
    • Info Updates
  • me
    • Info Updates
  • match_info
    • Info Updates
    • Events
  • game_info
    • Info Updates
  • roster
    • Info Updates
  • kill
    • Events
  • death
    • Events
  • Legal
  • Terms overview
  • Developer's terms
  • App terms
  • Overwolf terms
  • Overwolf Privacy policy
  • Support
  • Questions and Answers
  • Discord
  • Slack
  • Facebook
  • Twitter
  • Documentation
  • Changelog
  • API
  • App Creation Process
  • Best Practices
  • Game Events status
  • Information
  • Careers
  • Fund
  • Developers Blog
  • Overwolf Appstore
  • Advertise on Overwolf