Skip to main content

World of Tanks

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

Sample Apps

Available Features

info

In WoT, due to technical reasons, Overwolf API starts to work only if the game was launched before, at least one time (because only then, we identify the location of the game installation). So, if you identify an error when you try to register to the game events (and in particular - when you get the “failed after 11 tries” error when calling setRequiredFeatures ) - on that case, notify the user that she has to relaunch the game. Not ideal - but working. And cover those cases.

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 events straight 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:

{"feature":"gep_internal","category":"gep_internal","key":"version_info","value":"{"local_version":"143.0.10","public_version":"143.0.10","is_updated":true}"}

kill

Events

EventEvent DataFired WhenNotesSince GEP Ver.
killSee notesA tank was destroyed47.0
one_shot_killSee notesThe player’s tank destroyed another tank with a single shot and no ally assistance47.0
damageSee notesThe player’s tank damaged another tank47.0
assistSee notesThe player’s tank assisted in destroying another tank47.0

kill note

Event Data:

{"enemyTeam":true}

true if the event refers to an enemy unit, false if the event refers to an ally unit

one_shot_kill note

Event Data:

{"enemyTeam":true}

true if the event refers to an enemy unit, false if the event refers to an ally unit

damage note

Event Data:

{"enemyTeam":true,"damage":"33"}

true if the event refers to an enemy unit, false if the event refers to an ally unit

assist note

Event Data:

{"enemyTeam":true}

true if the event refers to an enemy unit, false if the event refers to an ally unit

death

Events

EventEvent DataFired WhenNotesSince GEP Ver.
deathnullThe player’s tank was destroyed47.0
hitSee notesThe player’s tank was damaged47.0

hit note

Event Data:

{"enemyTeam":true,"damage":"41"}

true if the event refers to an enemy unit, false if the event refers to an ally unit

game_info

Info Updates

keyCategoryValuesNotesSince GEP Ver.
game_start_timestampgame_infoSee notesDeprecated47.0
game_stategame_infoSee notes47.0
map_namegame_infoSee notes86.0

game_start_timestamp note

This event is deprecated

Example data - "Tue Feb 07 2017 15:48:48 GMT+0200"

game_state note

what is the current state of the game.

Data example:

['hangar' | 'battle' | 'training' | 'replay']

'replay' means we are running a replay file.

map_name note

Name of the map or loading space the player is currently in

Data example:

['hangar_v2' | 'hangar_bootcamp' | '05_prohorovka' | '08_ruinberg']

match_info

Info Updates

keyCategoryValuesNotesSince GEP Ver.
pseudo_match_idmatch_infoCurrent match’s ID code.See notes47.0

Data example

{"feature":"match_info","category":"match_info","key":"pseudo_match_id","value":"c03af125-b319-449a-9b6f-1310073f3f86"}

Events

EventEvent DataFired WhenNotesSince GEP Ver.
match_outcomevictory/defeatWhen local player wins/loses.See notes137.0

pseudo_match_id note

Data example:

{"feature":"match_info","category":"match_info","key":"pseudo_match_id","value":"c03af125-b319-449a-9b6f-1310073f3f86"}

match_outcome note

Data Example:

{"events":[{"name":"match_outcome","data":"defeat"}]}
{"events":[{"name":"match_outcome","data":"victory"}]}