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
Available Features
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/SquadExample: {"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:
| 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"}