Skip to main content

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

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

  • 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: Modern Warfare 2 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 notes239.0
match_endnullMatch ended and also data about the match outcome.See notes239.0

match_start note

Data Example:


match_end note

Match end event includes the match outcome

Possible values:

  • victory
  • defeat

Data Example:



Info Updates

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

scene note

Possible values:

  • lobby_mw2
  • in_game

Data Example:


mode note

Data Example: