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
  • 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   0.119.1
name ship  The ship’s name – string   0.119.1
state  match

 Possible values:

  • running – match is active
  • empty string – match is not active
  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
 destroyed  shipId – int  A ship was destroyed by the local user    0.119.1
 damaged
  •  amount – amount of damage done
  • shipId – int
 A ship was damaged by the local user    0.119.1
 ribbon
  •  ribbon – string

Available ribbons

 Ribbon was awarded    0.119.1
death  

Event Event Data Fired when Notes Since Version
 destroyed  Name of the “killer” ship  The player’s ship was destroyed    0.119.1
 damage
  • damage – amount -int
  • ship name – string
 
The player’s ship was damaged
   0.119.1