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

gep_internal
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.

`gep_internal`

Info Updates

key	Category	Values	Notes	Since GEP Ver.
gep_internal	gep_internal	Local + Public version number	See notes	143.0

gep_internal note

Data Example:

{"info":{"gep_internal":{"version_info":"{"local_version":"157.0.1","public_version":"157.0.1","is_updated":true}"}},"feature":"gep_internal"}

`kill`

Info Updates

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

kills note

Data Example:

{"info":{"match_info":{"kills":"1"}},"feature":"kill"}

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
kill	totalKills – total kills for player in match	The local player killed another player	See notes	110.0.0
knockout	null	The local player knocked out another player	See notes	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

kill note

Data Example:

{"events":[{"name":"kill","data":"1"}]}

knockout note

Data Example:

{"events":[{"name":"knockout","data":""}]}

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	See notes	110.0

revived note

Data Example:

{"events":[{"name":"revived","data":""}]}

`death`

Events

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

death note

Data Example:

{"events":[{"name":"death","data":""}]}

`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_Respawn" (Team Rumble) "Playlist_PlaygroundV2" (Creative) "Playlist_Creative_PlayOnly" (Playground) "Playlist_ShowdownAlt_Solo" (Arena Solo) "Playlist_ShowdownAlt_Squads" (Arena Squads) "Playlist_Crucible_Solo" (The Combine) Playlist_BattleLab Playlist_Creative_ZebraWallet_Random Playlist_Creative_ZebraWallet_Random2		110.0

Important note - Fortnite is a game that rotates game modes when the season changes and with patches. Thus it's important to remember that not all values that are listed below are valid at all times. These values change with time and with patches (except for the base modes like solo / duo / etc).

Furthermore - Event data is not fully reliable in Creative mode and should be taken into consideration when working with that mode.

Data example:

{"info":{"match_info":{"mode":"solo"}},"feature":"match"}
{"info":{"match_info":{"mode":"duo"}},"feature":"match"}
{"info":{"match_info":{"mode":"Playlist_Trios"}},"feature":"match"}
{"info":{"match_info":{"mode":"squad"}},"feature":"match"}
{"info":{"match_info":{"mode":"Playlist_ShowdownAlt_Solo"}},"feature":"match"}
{"info":{"match_info":{"mode":"Playlist_ShowdownAlt_Duos"}},"feature":"match"}
{"info":{"match_info":{"mode":"Playlist_ShowdownAlt_Trios"}},"feature":"match"}
{"info":{"match_info":{"mode":"Playlist_Daybreak_PE_Squads"}},"feature":"match"}
{"info":{"match_info":{"mode":"Playlist_Respawn"}},"feature":"match"}
{"info":{"match_info":{"mode":"Playlist_BattleLab"}},"feature":"match"}
{"info":{"match_info":{"mode":"Playlist_Creative_LTM_NewRVB2"}},"feature":"match"}
{"info":{"match_info":{"mode":"Playlist_Creative_LTM_ProRVB"}},"feature":"match"}
{"info":{"match_info":{"mode":"Playlist_Creative_LTM_PRO100"}},"feature":"match"}
{"info":{"match_info":{"mode":"Playlist_Creative_LTM_FinestYTReal2v2"}},"feature":"match"}
{"info":{"match_info":{"mode":"Playlist_Daybreak_PP_Squads"}},"feature":"match"}
{"info":{"match_info":{"mode":"Playlist_Papaya"}},"feature":"match"}
{"info":{"match_info":{"mode":"Playlist_Daybreak_PE_Squads"}},"feature":"match"}

Events

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

matchStart note

Data Example:

{"events":[{"name":"matchStart","data":""}]}

matchEnd note

Data Example:

{"events":[{"name":"matchEnd","data":""}]}

`match_info`

Info Updates

key	Category	Values	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

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
generic	kill/death/knocked	Generic events are generated.	See notes	153.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"}

generic note

These are general events provided by the game client.

Possible values:

"knocked"
"kill"
"2kill" - double kill
"3kill" - triple kill
"mkill" - multi kill
"won"
"death"

Data Example:

{"events":[{"name":"generic","data":"death"}]}
{"events":[{"name":"generic","data":"kill"}]}

`rank`

Info Updates

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

rank note

Data Example:

{"info":{"match_info":{"rank":"1"}},"feature":"rank"}

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	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
total_shots	me	The amount of times the local player shot (not including grenades). See notes	157.0

name note

Data Example:

{"info":{"me":{"name":"Sh4rgaas"}},"feature":"me"}

health note

Data Example:

{"info":{"me":{"health":"100"}},"feature":"me"}

accuracy note

Data Example:

{"info":{"me":{"accuracy":"0.500000"}},"feature":"me"}

shield note

Data Example:

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

total_shots note

Data Example:

{"info":{"me":{"total_shots":"84"}},"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:

{"info":{"game_info":{"location":"{ "x" : 1209, "y" : 1560, "z" : -18 }"}},"feature":"location"}

`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

nicknames note

Data Example:

{"info":{"match_info":
  {"nicknames":"{"team_members" : [
    {"player" : "Sh4rgaas"},
    {"player" : "Benda3907"},
    {"player" : "KapiXono"},
    {"player" : "Bradost-dost12"}
      ]}"}},"feature":"team"}

`items`

Info Updates

key	Category	Values	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. 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"}

`counters`

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

Game ID

Sample Apps

Available Features

Game events status

gep_internal

Info Updates

gep_internal note

kill

Info Updates

kills note

Events

kill note

knockout note

hit note

killed

Events

killed note

killer

Events

killer note

revived

Events

revived note

death

Events

death note

knockedout note

match

Info Updates

Events

matchStart note

matchEnd note

match_info

Info Updates

Events

pseudo_match_id note

sessionID note

matchID note

userID note

ticketID note

partyID note

generic note

rank

Info Updates

rank note

total_teams note

total_players note

me

Info Updates

name note

health note

accuracy note

shield note

total_shots note

phase

Info Updates

location

Info Updates

location note

team

Info Updates

nicknames note

items

Info Updates

item_X note

selected_slot note

quickbar_X note

selected_material note

counters

Info Updates

`gep_internal`

`kill`

`killed`

`killer`

`revived`

`death`

`knockedout` note

`match`

`match_info`

`rank`

`me`

`phase`

`location`

`team`

`items`

`counters`