Valorant
Please read the overwolf.games.events documentation page to learn how to use Overwolf game events.
Game ID
21640
Sample Apps
Available Features
Game event status
It is highly recommended to communicate errors and warnings to app users.
Check the current game event status here. Alternately, you can easily check that status from your app itself, 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"}
me
Info Updates
| key | Category | Values | Notes | Since GEP Ver. |
|---|---|---|---|---|
| player_name | me | Name of local player. | See notes | 148.0 |
| player_id | me | ID of the local player. | See notes | 148.0 |
| region | me | Region of the local player. | See notes | 148.0 |
| agent | me | Character Internal ID. | See notes | 149.0 |
player_name note
Data Example:
{"info":{"me":{"player_name":"Doom#5339"}},"feature":"me"}
player_id note
Data Example:
{"info":{"me":{"player_id":"f4029eff-92e6-56db-adba-4d073df968a4"}},"feature":"me"}
region note
Data Example:
{"info":{"me":{"region":"esp"}},"feature":"me"}
agent note
Not all agents have their game-name match their ID data, since this is an internal name, so take that into account. Furthermore, if a character has an ability that gives him different points of view (f.ex Sova with his drone), the ID will change accordingly to the drone.
Data Example:
{"info":{"me":{"agent":"Phoenix_PC_C"}},"feature":"me"}
Possible agent values:
- "Clay_PC_C" = Raze
- "Pandemic_PC_C" = Viper
- "Wraith_PC_C" = Omen
- "Hunter_PC_C" = Sova
- "Thorne_PC_C" = Sage
- "Phoenix_PC_C" = Phoenix
- "Wushu_PC_C" = Jett
- "Gumshoe_PC_C" = Cypher
- "Sarge_PC_C" = Brimstone
- "Breach_PC_C" = Breach
- "Vampire_PC_C" = Reyna
- "Killjoy_PC_C" = Killjoy
- "Guide_PC_C" = Skye
- "Stealth_PC_C" = Yoru
- "Rift_PC_C" = Astra
- "Grenadier_PC_C" = KAY/O
match_info
Info Updates
| key | Category | Values | Notes | Since GEP Ver. |
|---|---|---|---|---|
| pseudo_match_id | match_info | The current match’s ID code.Example: 0c0ea3df-97ea-4d3a-b1f6-f8e34042251f | This is an Overwolf-generated code, unrelated to Riot. | 159.0 |
| round_number | match_info | Number of current round. | See notes | 149.0 |
| score | match_info | Amount of rounds won/lost. | See notes | 149.0 |
| round_phase | match_info | Current state of the round. | See notes | 149.0 |
| team | match_info | Attack / Defense. | See notes | 149.0 |
| match_outcome | match_info | Victory / Defeat. | See notes | 149.0 |
| round_report | match_info | * Total Damage * Total number of bullets hit. * Number of bullets hit on head. * Number of hit headshots that killed. | See notes | 150.0 |
| game_mode | match_info | * Mode: Bomb / Quick Bomb * Ranked: 0 (Practice), 1 (Competitive), 2 (Spike Rush/Other) | See notes | 151.0 |
| roster | match_info | * Player Name * Player ID * Name of picked character * Player's Rank * Whether it is the local player * If player is a teammate or not. | See notes | 151.0 |
round_number note
Data Example:
{"info":{"match_info":{"round_number":"1"}},"feature":"match_info"}
{"info":{"match_info":{"round_number":"2"}},"feature":"match_info"}
{"info":{"match_info":{"round_number":"3"}},"feature":"match_info"}
score note
Data example:
{"info":{"match_info":{"score":"{"won":9,"lost":2}"}},"feature":"match_info"}
round_phase note
Data Example:
{"info":{"match_info":{"round_phase":"shopping"}},"feature":"match_info"}
{"info":{"match_info":{"round_phase":"combat"}},"feature":"match_info"}
{"info":{"match_info":{"round_phase":"end"}},"feature":"match_info"}
{"info":{"match_info":{"round_phase":"game_end"}},"feature":"match_info"}
team note
Data Example:
{"info":{"match_info":{"team":"attack"}},"feature":"match_info"}
{"info":{"match_info":{"team":"defense"}},"feature":"match_info"}
match_outcome note
Data Example:
{"info":{"match_info":{"match_outcome":"victory"}},"feature":"match_info"}
{"info":{"match_info":{"match_outcome":"draw"}},"feature":"match_info"}
round_report note
This data is per round.
Data Example:
{"info":{"match_info":{"round_report":"{"damage":331,"hit":6,"headshot":0,"final_headshot":1}"}},"feature":"match_info"}
game_mode note
Current values:
- Bomb = Regular game (Unrated).
- Quick Bomb = Spike Rush.
- Ranked = 1 = Competitive.
- Deathmatch = Deathmatch
- Escalation = Escalation
Both of these values also have "custom" value which is identified as a Boolean, either "True" or "False".
True meaning that the current game is custom made, and false being an online game which is not custom.
We recently added "ranked" value to game_mode which will indicate if the game you are playing is ranked or not. The values you will be getting range betweeb 0 which is received in the practice range, 1 which means it's a ranked game, and 2 which is received during Spike Rush and is just a random value, it does not represent a ranked game.
Data Example:
{"info":{"match_info":{"game_mode":"{"mode":"bomb","custom":true,"ranked":"0"}"}},"feature":"match_info"}
{"info":{"match_info":{"game_mode":"{"mode":"bomb","custom":false,"ranked":"1"}"}},"feature":"match_info"}
{"info":{"match_info":{"game_mode":"{"mode":"deathmatch","custom":false,"ranked":"1"}"}},"feature":"match_info"}
roster note
Important: If players (or local player) in the match activate the option to hide their names from players outside their party, the output you will see will be the name of the agent (like Jett or in the case of the local player it will be Me) instead.
It is language dependant, so that is also important to take into account.
Data Example:
{"info":{"match_info":{"roster_3":"{"name":"Sh4rgaas #EUNE","player_id":"2fb49e77-85c6-522c-a240-27c78a2f9a8f","character":"Pandemic","rank":0,"locked":false,"local":true,"teammate":true}"}},"feature":"match_info"}
{"info":{"match_info":{"roster_4":"{"name":"BreachMain #EUW","player_id":"d8b9c6f7-2cc6-5a75-825f-a5658b37eb1d","character":"Vampire","rank":0,"locked":true,"local":false,"teammate":true}"}},"feature":"match_info"}
{"info":{"match_info":{"roster_3":"{"name":"Sh4rgaas #EUNE","player_id":"2fb49e77-85c6-522c-a240-27c78a2f9a8f","character":"Pandemic","rank":0,"locked":true,"local":true,"teammate":true}"}},"feature":"match_info"}
{"info":{"match_info":{"roster_1":"{"name":"NoobaHooba #8609","player_id":"f0be482b-d182-51a7-a17b-5d5d73d2f0cc","character":"Hunter","rank":0,"locked":false,"local":false,"teammate":true}"}},"feature":"match_info"}
{"info":{"match_info":{"roster_0":"{"name":"TroyDarion #6170","player_id":"e70b9fb9-b64a-503e-a0ac-3bd12bcac218","character":"Gumshoe","rank":0,"locked":false,"local":false,"teammate":true}"}},"feature":"match_info"}
{"info":{"match_info":{"roster_1":"{"name":"NoobaHooba #8609","player_id":"f0be482b-d182-51a7-a17b-5d5d73d2f0cc","character":"Hunter","rank":0,"locked":true,"local":false,"teammate":true}"}},"feature":"match_info"}
{"info":{"match_info":{"roster_0":"{"name":"TroyDarion #6170","player_id":"e70b9fb9-b64a-503e-a0ac-3bd12bcac218","character":"Gumshoe","rank":0,"locked":true,"local":false,"teammate":true}"}},"feature":"match_info"}
{"info":{"match_info":{"roster_2":"{"name":"SoloMeoParedes #ESP","player_id":"db36fb3b-e351-5da2-b0e3-c3a0400e8ddd","character":"Thorne","rank":0,"locked":false,"local":false,"teammate":true}"}},"feature":"match_info"}
{"info":{"match_info":{"roster_2":"{"name":"SoloMeoParedes #ESP","player_id":"db36fb3b-e351-5da2-b0e3-c3a0400e8ddd","character":"Thorne","rank":0,"locked":true,"local":false,"teammate":true}"}},"feature":"match_info"}
{"info":{"match_info":{"roster_6":"{"name":"zayed2 #EUW","player_id":"4d5efc43-b001-5c47-81d2-2f3cacff5ac7","character":"Wraith","rank":0,"teammate":false,"locked":false,"local":false}"}},"feature":"match_info"}
{"info":{"match_info":{"roster_7":"{"name":"maheralkurdy #7836","player_id":"2080a484-c481-5362-812c-7572f5182b10","character":"Wushu","rank":0,"teammate":false,"locked":false,"local":false}"}},"feature":"match_info"}
{"info":{"match_info":{"roster_5":"{"name":"Kubix11223 #5713","player_id":"dafa74b0-80ad-5dba-a753-70318f91d80a","character":"Thorne","rank":0,"teammate":false,"locked":false,"local":false}"}},"feature":"match_info"}
{"info":{"match_info":{"roster_9":"{"name":"ImJOWY #2905","player_id":"162ec3aa-0114-554e-839f-fbe276467ece","character":"Clay","rank":0,"teammate":false,"locked":false,"local":false}"}},"feature":"match_info"}
{"info":{"match_info":{"roster_8":"{"name":"kot #8059","player_id":"4d7d329c-efc4-5400-9910-2a6b76f13c7b","character":"Phoenix","rank":0,"teammate":false,"locked":false,"local":false}"}},"feature":"match_info"}
Events
| Event | Event Data | Fired When | Notes | Since GEP Ver. |
|---|---|---|---|---|
| match_start | null | Match started. | See notes | 148.0 |
| match_end | null | Match ended. | See notes | 148.0 |
match_start note
Data Example:
{"event":"match_start","data":null}
match_end note
Please note that match_end does not work on custom matches nor training.
Data Example:
{"event":"match_end","data":null}
game_info
Info Updates
| key | Category | Values | Notes | Since GEP Ver. |
|---|---|---|---|---|
| scene | game_info | The current scene-state. | See notes | 148.0 |
| state | game_info | The current game-state. | See notes | 148.0 |
scene note
"Scene" info includes the scenes of the game and the name of the map that is currently played (like in the example down below - Triad).
Data Example:
{"info":{"game_info":{"scene":"Triad"}},"feature":"game_info"}
Possible Scene values:
- "MainMenu" - Main menu
- "Triad" - Haven map
- "Duality" - Bind map
- "Bonsai" - Split map
- "Ascent" - Ascent map
- "Port" - Icebox map
- "Foxtrot" - Breeze map
- "Range" - Practice Range map
- "CharacterSelectPersistentLevel" - Character Selection
state note
Data Example:
{"info":{"game_info":{"state":"WaitingToStart"}},"feature":"game_info"}
{"info":{"game_info":{"state":"InProgress"}},"feature":"game_info"}
Possible states:
- "WaitingToStart"
- "LeavingMap"
- "Aborted"
- "InProgress"
- "Init"
kill
Info Updates
| key | Category | Values | Notes | Since GEP Ver. |
|---|---|---|---|---|
| kills | kill | Amount of kills performed by the local player. | See notes | 148.0 |
| assists | kill | Amount of assists performed by the local player. | See notes | 148.0 |
| headshots | kill | Amount of headshots performed by the local player. | See notes | 150.0 |
kill note
Data Example:
{"info":{"kill":{"kills":1}},"feature":"kill"}
{"info":{"kill":{"kills":2}},"feature":"kill"}
{"info":{"kill":{"kills":3}},"feature":"kill"}
assist note
Data Example:
{"info":{"kill":{"assists":1}},"feature":"kill"}
headshots note
Data Example:
{"info":{"kill":{"headshots":1}},"feature":"kill"}
Events
| Event | Event Data | Fired When | Notes | Since GEP Ver. |
|---|---|---|---|---|
| kill | Total kills | Kill is performed. | See notes | 148.0 |
| assist | Total assists | Assist is performed. | See notes | 148.0 |
| headshot | Total headshots | Headshot is performed. | See notes | 150.0 |
kill note
Data Example:
{"events":[{"name":"kill","data":6}]}
assist note
Data Example:
{"events":[{"name":"assist","data":1}]}
headshot note
Data Example:
{"events":[{"name":"headshot","data":"1"}]}
death
Info Updates
| key | Category | Values | Notes | Since GEP Ver. |
|---|---|---|---|---|
| deaths | death | Amount of deaths by the local player. | See notes | 148.0 |
death note
Data Example:
{"info":{"death":{"deaths":1}},"feature":"death"}
Events
| Event | Event Data | Fired When | Notes | Since GEP Ver. |
|---|---|---|---|---|
| death | Total deaths | Local player died. | See notes | 148.0 |
death note
Data Example:
{"events":[{"name":"death","data":14}]}