Fortnite

Fortnite game events.

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

Game ID

  • 21216

Sample app

Available Features:

  • kill
  • killed
  • killer
  • revived
  • death
  • match
  • rank
  • me
  • phase
  • location
  • team
  • items

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
kill
Category Key Values Notes Since Version
match_info kills

Total number of kills in the match

   110.1.3
match
Category Key Values Notes Since Version
match_info mode

Possible values:

  • “solo”
  • “duo”
  • “squad”
  • “Playlist_Playground”
{"mode":"duo"}
Special/Temporary game mode names can change from time to time 110.1.3
rank  
Category Key Values Notes Since Version
match_info  rank

The player’s rank at the end of the match

  110.1.3
match_info total_teams

The total number of active teams

Note – this is a dynamic variable that is being updated every time team joins or leaves (all of the team members died) the game

  110.1.3
match_info total_players

The total number of active players

Note – this is a dynamic variable that is being updated every time a player joins or leaves (die) the game

  110.1.3
me  
Category Key Values Notes Since Version
me  name

The player’s nickname

{"name":"itayG"}
  110.1.3
me health

The player’s current health % (100-0)

{"health":"37"}
  110.1.3
me accuracy

The current local player’s accuracy (hits/total shots)

{"accuracy":"0.333333"}
  127.0.7
phase
Category Key Values Notes Since Version
game_info  phase

The game’s current state, can be one of the following:

  • ‘lobby’
  • ‘loading_screen’
  • ‘airfield’
  • ‘aircraft’
  • ‘freefly’
  110.1.3

location

 

Note: “location” is currently not available

Category Key Values Notes Since Version
game_info  location

The player’s current grid location, represented by (x,y).

  • Top left corner of the map is (0,0)
  • Bottom right corner of the map is (2500.-2500)
{"x" : 621, "y" : -2769}
  114.1.1
team
Category Key Values Notes Since Version
match_info nicknames

The names of the players in the user’s team

{"feature":"team","category":"match_info","key":"nicknames",
"value":"{\"team_members\":
[{\"player\":\"Itaygl\"},{\"player\":\"ErW_iN\"},
{\"player\":\"einhorn28\"},{\"player\":\"Jacqulees\"}]}"}
  117.1.1
items
Category Key Values Notes Since Version
inventory item_X

The current inventory of the local player.

Each item in the inventory contains the following properties:

  • name – display name of the item (list of possible display names can be found here)
  • count – number of units
  • ammo – amount loaded ammo (when relevant)
  • rarity – rarity of the item [0-4]
    • 0 – none
    • 1 – green
    • 2 – blue
    • 3 – purpule
    • 4 – gold
"inventory":{  
   ...
   "item_0":"{\"name\":\"WID_Harvest_Pickaxe_NeonCat\",\"count\":\"1\",\"ammo\":\"0\",\"rarity\":\"3\"}",
   "item_3":"{\"name\":\"StoneItemData\",\"count\":\"2\",\"ammo\":\"0\",\"rarity\":\"0\"}",
   "item_7":"{\"name\":\"AthenaAmmoDataShells\",\"count\":\"4\",\"ammo\":\"0\",\"rarity\":\"0\"}",
   "item_11":"{\"name\":\"Athena_Balloons_Consumable\",\"count\":\"7\",\"ammo\":\"0\",\"rarity\":\"3\"}",
   "item_15":null,
   "item_14":null,
   "item_13":"{\"name\":\"WID_Assault_AutoHigh_Athena_SR_Ore_T03\",\"count\":\"1\",\"ammo\":\"30\",\"rarity\":\"4\"}",
...
         },

 

  •  When an item is dropped, its value will be updated to “null”
    "item_1":null
119.2
selected_slot selected_slot

The currently selected slot in the quickbar.

This info-update includes the  following properties:

  •  isPrimary – “true” when the selected slot is in the main quickbar (weapons), “false” when the selected slot is in the secondary quickbar (build options)
  • slot – the selected slot (0-5)
{"info":{"selected_slot":
{"selected_slot":"{\"isPrimary\":true,\"slot\":\"1\"}"}},
"feature":"items"}
   119.2
quickbar quickbar_X

The display names of the items in the primary quickbar. (list of possible display names can be found here)

{"info":{"quickbar":{"quickbar_1":"{\"name\":\"WID_Shotgun_SemiAuto_Athena_UC_Ore_T03\"}"}},
"feature":"items"}
   119.2
selected_material selected_material

The currently selected building material.

Possible values are:

  • 0 – wood
  • 1- stone
  • 2 – metal
{"info":{"selected_material":{"selected_material":"1"}},
"feature":"items"}
   119.2
 counters
Category Key Values Notes Since Version
performance ping The latency changes of the local player in the current match.   0.128.0.4

 

Events

Feature Information
 kill  
Event Event Data Fired when Notes Since Version
kill null The local player killed another player   110.1.3
knockout null The local player knockedout another player   110.1.3
hit isHeadshot – bool
(“true” when the hit is a “headshot”)

The local player hits an enemy with a weapon 
(hits with a pickaxe are not counted)

{"name":"hit","data":"{"isHeadshot": true}"}
  127.0.7
killed
Event Event Data Fired when Notes Since Version
killed

The name of the killed player

{"name":"killed","data":"itaygl"}
The local player killed another player   117.1.1
killer
Event Event Data Fired when Notes Since Version
killer

The name of the killer

{"name":"killer","data":"itaygl"}
The local player was killed   117.1.1
 revived
Event Event Data Fired when Notes Since Version
revived null The local player was revived   110.1.3
 death
Event Event Data Fired when Notes Since Version
death null The local player died   110.1.3
knockedout The name of the player who knocked you out
{"events":[{"name":"knockedout","data":"itaygl"}]}
The local player is knocked-out   118.1.0
match
Event Event Data Fired when Notes Since Version
matchStart null Match started   110.1.3
matchEnd null Match ended   110.1.3