Skip to main content

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

  • The implementation of this game's GEP is experimental and is considered a Beta version

  • Support for these events is for English only and for 16:9 and 16:10 screen resolutions, the game window must be visible and should run with native screen resolution.

  • This game requires enabling exclusive mode on your OW app's windows. Read more about OW exclusive mode.

  • In addition, when developing your app, you must comply with Activision’s Call of Duty: Vanguard terms and conditions. Supporting queue dodging, interfering with matchmaking or any such behavior is strictly prohibited, and will not be approved. If you have any doubt, please contact us directly before starting development.

For more information check our Game compliance principles

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 notes198.0

gep_internal note

Data Example:




EventEvent DataFired WhenNotesSince GEP Ver.
match_startnullMatch started.See notes198.0
match_endnullMatch ended and also data about the match outcome.See notes198.0
round_outcomenullCurrent round result.See notes198.0

match_start note

Data Example:


match_end note

Match end event includes the match outcome
Possible values:

  • victory
  • defeat

Data Example:


round_outcome note

Data Example:



Info Updates

keyCategoryValuesNotesSince GEP Ver.
scenegame_infocurrent player's scene.See notes198.0
game_modegame_infocurrent game mode selected by the player.See notes198.0

scene note

Possible values:

  • lobby
  • inGame

Data Example:


game_mode note

Possible values:

  • free_for_all
  • team_deathmatch
  • kill_confirmed
  • domination
  • search_destroy
  • hardpoint
  • control
  • patrol
  • champion_hill
  • arms_race

Data Example:



Info Updates

keyCategoryValuesNotesSince GEP Ver.
player_namemecurrent player's name.See notes198.0

player_name note

Data Example:




EventEvent DataFired WhenNotesSince GEP Ver.
killnullLocal player has performed a kill.See notes198.0

kill note

Data Example:




EventEvent DataFired WhenNotesSince GEP Ver.
deathnullLocal player has died.See notes198.0

death note

Data Example: