Edit

Fortnite Game Events

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

Game ID

21216

Sample Apps

• Fortnite game events sample app

Available Features

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

Game events status

It is highly recommended to communicate errors and warnings to app users. Check game event status here. You can also easily check game events status from your app, using our API.

kill

Info Updates

key	Category	Values	Notes	Since GEP Ver.
kills	match_info	Total number of kills in the match		110.0

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
kill	null	The local player killed another player		110.0.0
knockout	null	The local player knocked out another player		110.0.0
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) See notes		110.0.0

hit note

Data Example:

{"name":"hit","data":"{"isHeadshot": true}"}

killed

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
killed	The name of the killed player. See notes	The local player killed another player		117.0

killed note

Data Example:

{"name":"killed","data":"itaygl"}

killer

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
killer	Name of the killer. See notes	The local player was killed		117.0

killer note

Data Example:

{"name":"killer","data":"itaygl"}

revived

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
revived	null	The local player was revived		110.0

death

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
death	null	The local player died		110.0
knockedout	The name of the player who knocked you out. See note	The local player is knocked-out		118.1

knockedout note

Data example:

{"events":[{"name":"knockedout","data":"itaygl"}]}

match

Info Updates

key	Category	Values	Notes	Since GEP Ver.
mode	match_info	Possible Values: "solo" "duo" "squad" "Playlist_Playground" {"mode":"duo"}		110.0

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
matchStart	null	Match started		110.0
matchEnd	null	Match ended		110.0

match_info

Info Updates

key	Category	Values	Notes	Since GEP Ver.
pseudo_match_id	match_info	The current match’s ID code. See notes		130.2
sessionID	match_info	The current session’s ID code. See notes		132.0
matchID	match_info	The current match’s ID. See notes		132.0
userID	match_info	The current user’s ID code. See notes		132.0
ticketID	match_info	The current ticket’s ID code. See notes		132.0
partyID	match_info	The current party’s ID code. See notes		132.0

pseudo_match_id note

Note that this is an Overwolf-generated code, not an Epic Games designation.

Example data:

0c0ea3df-97ea-4d3a-b1f6-f8e34042251f

sessionID note

Data Example:

{"info":{"match_info":{"sessionID":"03765ae468cb4e8ca21cc290302a0ba0"}},"feature":"match"}

matchID note

Data Example:

{"info":{"match_info":{"matchID":"ff75f8541670a4317136b0b239955416"}},"feature":"match"}

userID note

Data Example:

{"info":{"match_info":{"userID":"0608873718b84a11a2ee66316d09c941"}},"feature":"match"}

ticketID note

Data Example:

{"info":{"match_info":{"ticketID":"dd7fd486ad6c9ab52627514f1921d765"}},"feature":"match"}

partyID note

Data Example:

{"info":{"match_info":{"partyID":"24f122daf9c446199e59f1f6841cacfe"}},"feature":"match"}

rank

Info Updates

key	Category	Values	Notes	Since GEP Ver.
rank	match_info	The player’s rank at the end of the match		110.0
total_teams	match_info	Total number of active teams		110.0
total_players	match_info	Total number of active players		110.0

total_teams note

This is a dynamic variable that is being updated every time a team joins, leaves or dies during the game

total_players note

This is a dynamic variable that is being updated every time a player joins, leaves or dies during the game

me

Info Updates

key	Category	Values	Notes	Since GEP Ver.
name	me	The player’s nickname. See notes		110.0
health	me	The player’s current health % (100-0). See notes		110.0
accuracy	me	The local player’s current accuracy (hits/total shots). See notes		110.0
shield	me	The amount of shield the local player currently has. See notes		110.0

name note

Data Example:

{"name":"itayG"}

health note

Data Example:

{"health":"37"}

accuracy note

Data Example:

{"accuracy":"0.333333"}

shield note

Data Example:

{"info":{"me":{"shield":"50"}},"feature":"me"}

phase

Info Updates

key	Category	Values	Notes	Since GEP Ver.
phase	game_info	The game’s current state, can be one of the following: 'lobby' ‘loading_screen’ ‘airfield’ ‘aircraft’ ‘freefly’		110.0

location

Info Updates

key	Category	Values	Notes	Since GEP Ver.
location	game_info	Player’s current grid location, represented by (x,y,z). Top left corner of the map is (0,0,z) Bottom right corner of the map is (2500,2500,z). See notes		114.1

location note

Data Example:

{"x" : 621, "y" : 2469, "z" : 50}

team

Info Updates

key	Category	Values	Notes	Since GEP Ver.
nicknames	match_info	Names of the players in the user’s team. See notes		170.0

team note

Data Example:

{"feature":"team","category":"match_info","key":"nicknames","value":"{"team_members":[{"player":"Itaygl"},{"player":"ErW_iN"},{"player":"einhorn28"},{"player":"Jacqulees"}]}"}

items

Info Updates

key	Category	Values	Notes	Since GEP Ver.
item_X	inventory	Current inventory of the local player. See notes		119.2
selected_slot	selected_slot	Currently selected slot in the quickbar. See notes		119.2
quickbar_X	quickbar	Display names of the items in the primary quickbar. (list of possible display names can be found here) See notes		119.2
selected_material	selected_material	The currently selected building material. See notes		119.2

item_X note

Each item in the inventory has the following properties:

• name – display name of the item (list of possible display names can be found here)
• count – number of units
• ammo – amount of loaded ammo (when relevant)
• rarity – rarity of the item [0-4]
  • 0 – none
  • 1 – green
  • 2 – blue
  • 3 – purple
  • 4 – gold

Data Example:

"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"}",3
    "item_15":null,
    "item_14":null,
    "item_13":"{"name":"WID_Assault_AutoHigh_Athena_SR_Ore_T03","count":"1","ammo":"30","rarity":"4"}"
}

selected_slot note

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)

Data Example:

{"info":{"selected_slot":{"selected_slot":"{"isPrimary":true,"slot":"1"}"}},"feature":"items"}

quickbar_X note

Data Example:

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

selected_material note

Possible values are:

• 0 – wood
• 1 - stone
• 2 – metal

Data Example:

{"info":{"selected_material":{"selected_material":"1"}},"feature":"items"}

coutners

Info Updates

key	Category	Values	Notes	Since GEP Ver.
ping	performance	Latency changes of the local player in the current match.	This feature is currently disabled.	128.0