Fortnite Game Events
Please read the overwolf.games.events documentation page to learn how to use Overwolf game events.
Game ID
21216
Sample Apps
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 | 110.0 |
Events
Event | Event Data | Fired When | Notes | Since GEP Ver. |
---|---|---|---|---|
kill | totalKills – total kills for player in match | 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:
| 110.0 |
Data example:
{"info":{"match_info":{"mode":"solo"}},"feature":"match"}
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 |
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 | 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 | |
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:
| 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).
| 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 |
team 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 | 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. 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 |