Skip to main content

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

Sample Apps

Available Features

Game event status

It is highly recommended to communicate errors and warnings to app users.

Check the current game event status here. Alternatively, you can easily check that status from your app itself, using our API.


Info Updates

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

gep_internal note

Data Example:



Info Updates

keyCategoryValuesNotesSince GEP Ver.
scenegame_infoThe current scene-stateSee notes253.0

scene note

Possible Scene values:

  • lobby
  • ingame
  • battle
  • outcome

Data Example:

{"feature": "game_info", "category": "game_info", "key": "scene", "data": "lobby"}



EventEvent DataFired WhenNotesSince GEP Ver.
match_startnullIn the beginning of each matchSee notes253.0
match_endnullAt the end of each matchSee notes253.0
battle_startnullIn the beginning of each battleSee notes253.0
battle_endnullAt the end of each battleSee notes253.0
match_outcomevictory/defeatThe result of the battleSee notes253.0

match_start note

Data Example:


match_end note

Data Example:


battle_start note

Data Example:


battle_end note

Data Example:


match_outcome note

Data Example: