Edit

PlayerUnkown's Battlegrounds Lite Game Events

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

Game ID

21598

Sample Apps

• PUBG game events sample app

Available Features

• gep_internal
• kill
• revived
• death
• killer
• match
• rank
• me
• phase
• map
• team_feed
• team

Game events status

It is highly recommended to communicate errors and warnings to your app users.

Check here the game events status. OR - easily check the 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	146.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		146.0
headshots	match_info	Total number of headshots in the match		146.0
total_damage_dealt	match_info	Total damage dealt in the current match		146.0
max_kill_distance	match_info	Max kill distance in CM		146.0

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
kill	null	The local player killed another player		146.0
headshot	null	The local player hit another player with a headshot		146.0
damage_dealt	amount of damage dealt by the local player	The local player “damaged” an enemy or himself	See notes	146.0
knockout	weapon name + victim name	The local player knocked-out another player	See notes	148.0

damage_dealt note

This event can not be used in real time, as it can give an un-fair advantage to the user. You can use it post-match.

Data Example:

{"events":[{"name":"damage_dealt","data":"42.63"}]}

knockout note

Data Example:

{"events":[{"name":"knockout","data":"{"weapon":"SLR","victim":"salambebek1"}"}]}

match

Info Updates

key	Category	Values	Notes	Since GEP Ver.
mode	match_info	Solo/Duo/Squad Example: {"mode":"squad"}	See notes	146.0
match_id	match_info	The current match ID code. Example: match.bro.official.pc-2018-03.steam. solo.eu.2019.05.07.08.ce8d1a14-b2af -41c8-8bf4-d2a504326630	Can be compared and checked at this link	146.0
pseudo_match_id	match_info	The current match’s ID code. Example: 0c0ea3df-97ea-4d3a-b1f6-f8e34042251f	This is an Overwolf-generated code which is unrelated to the match ID given above.	146.0

Events

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

mode note

Data Example:

{"info":{"match_info":{"mode":"squad"}},"feature":"match"}

match_id note

Data Example:

{"info":{"match_info":{"match_id":"match.bro.official.lpc-2019-06.gacct.squad.eu.2020.10.04.08.aa64b4d8-0f0a-4892-9678-3cdca2b0fedb"}},"feature":"match"}

matchEnd note

The matchEnd event fired when your player is killed, and when you exit to the lobby. (which means that if you get killed and than you exit to the lobby, you will see two calls for this event).

rank

Info Updates

key	Category	Values	Notes	Since GEP Ver.
me	match_info	The player’s rank at the end of the match		146.0
total	match_info	The total number of players		146.0

me

Info Updates

key	Category	Values	Notes	Since GEP Ver.
name	me	The player’s nickname {"name":"itayG"}		146.0
health	me	The player’s current health	See notes	146.0
view	me		See notes	146.0

health note:

Data Example:

{"health":"{"health":100,"ko_health":100}"}

view note:

Data Example:

{"view":"TPP"}

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’ ‘landed’		146.0

map

Info Updates

key	Category	Values	Notes	Since GEP Ver.
map	match_info	The current map name {"map":"Desert_Main"}	map names mapping	146.0

revived

Events

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

death

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
death	null	The local player dies	See notes	146.0
knockedout	null	The local player is knocked-out	See notes	146.0

death note

Data Example:

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

knockedout note

Data Example:

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

killer

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
killer	The killer’s nickname	The local player was killed by one of the players		146.0

killer notes:

When one of local player’s squad members kill the local player, the provided data will be "self_kill”.

team_feed

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
team_feed	Action name, attacker name, weapon name, and victim name.	Whenever a game update appears in the middle of the screen.	See notes	148.0

team_feed note

Data Examples:

{"events":[{"name":"team_feed","data":"{"message":"YouKilledPlayer","attacker":"Shargaas","weapon": "SKS","victim":"sOrgUsUs"}"}]}

{"events":[{"name":"team_feed","data":"{"message":"YourTeammateKilledPlayer","attacker":"KingSlayer3x","weapon": "QBZ","victim":"4Senius"}"}]}

{"events":[{"name":"team_feed","data":"{"message":"YourTeammateHaveBeenPutDown","attacker":"Egemen365", "weapon":"SLR","victim":"KingSlayer3x"}"}]}

{"events":[{"name":"team_feed","data":"{"message":"YouPutDownPlayer","attacker":"Shargaas","weapon": "M416","victim":"cerenihat}"}]}

team

Info Updates

key	Category	Values	Notes	Since GEP Ver.
nicknames	match_info	The nicknames of your team members.	See notes	151.0

nicknames note

Data Example:

{"info":{"match_info":{"nicknames":"{"team_members":["REMT1","Shargaas","anselxx"]}"}},"feature":"team"}