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
  • 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
Key Category Values Notes Since Version
 game_start_timestamp  game_info  Time of when the game process started running
"value":"2018-10-25T06:02:03.555Z"
   0.119.1
 scene  game_info

Possible values:

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

Possible values:

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

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
players roster

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
health ship

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

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

 The ship’s name – string

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

The level of the player’s ship

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

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

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

Whether the ship is flooding or not

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

The current nation of the player’s ship

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

 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