World of Warships

World of Warships game events.

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

Game ID

  • 10746

Available Features

  • game_info
  • account_info
  • match
  • match_info
  • kill
  • death

Sample app

Info Updates

The Game Events Provider keeps an info DB with various information about the game state.
Updates about this information can be received as events by registering an event listener using overwolf.games.events.onInfoUpdates2()
It is also possible to get the current available information using overwolf.games.events.getInfo()

Feature Information
game_info
Category Key Values Notes Since Version
game_info  game_start_timestamp  Time of when the game process started running
"value":"2018-10-25T06:02:03.555Z"
   0.119.1
game_info  scene

Possible values:

  • initializing
  • dock
  • battle
  • loading_screen
  • post_battle
  • result_screen
   0.119.1
 account_info
Category Key Values Notes Since Version
account_info realm

Possible values:

  • ru
  • eu
  • na
  • asia
  0.119.1
account_info id The local player’s Wargaming account id   0.119.1
account_info playerName The local player’s Wargaming name   0.119.1
match_info
Category Key Values Notes Since Version
match_info pseudo_match_id

The current session’s ID code.

 

Example:

 

0c0ea3df-97ea-4d3a-b1f6-f8e34042251f
  0.130.0.15
match
Category Key Values Notes Since Version
match mapName

Map name – string

{"feature":"match","category":"match","key":"mapName","value":"33_new_tierra"}
  • An empty string will be set when there is no relevant map (e.g. while in the dock)
  • On tutorial maps (e.g. “i01_tutorial”), some features might not work correctly (specifically death/kill)
0.119.1
roster players

Array of “player” objects, each “player” contains the following data:

  • shipId
  • name – player name
  • team – ally/enemy
  • ship – ship name
  • maxHealth – The ship’s max health
"[{\"shipId\":\"1175724\",\"name\":\":Wright:\",\"team\":\"ally\",
\"ship\":\"PZSC101_Cheng_An\",\"maxHealth\":\"4900\"},
{\"shipId\":\"1175726\",\"name\":\":Buckmaster:\",\"team\":\"ally\",
\"ship\":\"PJSC037_Hashidate_1940\",\"maxHealth\":\"5150\"},
...
{\"shipId\":\"1175728\",\"name\":\":Tovey:\",\"team\":\"enemy\",
\"ship\":\"PASC001_Erie_1936\",\"maxHealth\":\"4950\"}]"
  0.119.1
ship health

 The current “health” of the user’s ship – int

{"feature":"match","category":"ship","key":"health","value":"4900"}
  0.119.1
ship name

 The ship’s name – string

{"feature":"match","category":"ship","key":"name","value":"PZSC101_Cheng_An"}
  0.119.1
ship level

The level of the player’s ship

{"feature":"match","category":"ship","key":"level","value":"1"}
  0.122.1
ship burning

Whether the ship is burning or not [true | false]

{"feature":"match","category":"ship","key":"burning","value":false}
  0.122.1
ship flooding

Whether the ship is flooding or not

{"feature":"match","category":"ship","key":"flooding","value":false}
  0.122.1
ship nation

The current nation of the player’s ship

{"feature":"match","category":"ship","key":"nation","value":"Pan_Asia"}
  0.122.1
match state

 Possible values:

  • running – match is active
  • empty string – match is not active
{"feature":"match","category":"match","key":"state","value":"running"}
  0.119.1

Events

Feature Information
match
Event Event Data Fired when Notes Since Version
 matchStart  null  Match starts    0.119.1
 matchEnd  null  Match ends    0.119.1
 matchOutcome

Possible values: 

  • “victory”
  • “lost”
 Match ends    
kill
Event Event Data Fired when Notes Since Version
kill Ship id of the “victim” ship – int  A ship was destroyed by the local user   0.121.0.6
damage
  •  amount – amount of damage done
  • shipId – int
 A ship was damaged by the local user    0.121.0.6
 ribbon
  •  ribbon – string

Available ribbons

 Ribbon was awarded    0.119.1
death  
Event Event Data Fired when Notes Since Version
death  Ship id of the “killer” ship – int  The player’s ship was destroyed   0.121.0.6
hit
  • damage – amount -int
  • ship name – string
 
The player’s ship was damaged
  0.121.0.6