Skip to main content

Valorant

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

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

keyCategoryValuesNotesSince GEP Ver.
gep_internalgep_internalLocal + Public version numberSee notes143.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

keyCategoryValuesNotesSince GEP Ver.
player_namemeName of local player.See notes148.0
player_idmeID of the local player.See notes148.0
regionmeRegion of the local player.See notes148.0
agentmeCharacter Internal ID.See notes149.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
  • "Deadeye_PC_C" = Chamber
  • "Sprinter_PC_C" = Neon
  • "BountyHunter_PC_C" = Fade
  • "Mage_PC_C" = Harbor

match_info

Info Updates

keyCategoryValuesNotesSince GEP Ver.
pseudo_match_idmatch_infoThe current match’s ID code.

Example:

0c0ea3df-97ea-4d3a-b1f6-f8e34042251f
This is an Overwolf-generated code, unrelated to Riot.159.0
round_numbermatch_infoNumber of current round.See notes149.0
scorematch_infoAmount of rounds won/lost.See notes149.0
round_phasematch_infoCurrent state of the round.See notes149.0
teammatch_infoAttack / Defense.See notes149.0
match_outcomematch_infoVictory / Defeat.See notes149.0
round_reportmatch_info Total Damage
Total number of bullets hit.
Number of bullets hit on head.
Number of hit headshots that killed.
See notes150.0
game_modematch_info Mode: Bomb / Quick Bomb
Ranked: 0 (Practice), 1 (Competitive), 2 (Spike Rush/Other)
See notes151.0
rostermatch_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 notes151.0
scoreboardmatch_infoScoreboard changes and updates during the gameSee notes151.0
kill_feedmatch_infokill feed updates during the gameSee notes209.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.*Important:* Roster is not supported in game mode "escalation"
Rank value in roster can be translated using this list (Apr. 2022)
  • 0 - Unranked
  • 3 - Iron_01
  • 4 - Iron_02
  • 5 - Iron_03
  • 6 - Bronze_01
  • 7 - Bronze_02
  • 8 - Bronze_03
  • 9 - Silver_01
  • 10 - Silver_02
  • 11 - Silver_03
  • 12 - Gold_01
  • 13 - Gold_02
  • 14 - Gold_03
  • 15 - Platinum_01
  • 16 - Platinum_02
  • 17 - Platinum_03
  • 18 - Diamond_01
  • 19 - Diamond_02
  • 20 - Diamond_03
  • 21 - Ascendant_1
  • 22 - Ascendant_2
  • 23 - Ascendant_3
  • 24 - Immortal_01
  • 25 - Immortal_02
  • 26 - Immortal_03
  • 27 - Radiant

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"}

scoreboard note

List of parameters:

  • name - the player name
  • character - the character name
  • teammate - is the player in my team or not
  • kills / deaths / assists - The number of kills, deaths and assists suring the game
  • money - the amount of money during the game for each player
  • is_local - local player or not (Boolean)
  • alive - if the player is alive true / false

Data Example:

{"info":{"match_info":{"scoreboard_0":"{\"name\":\"jaxxx #7934\",\"character\":\"\",\"teammate\":false,\"alive\":true,\"kills\":0,\"deaths\":4,\"assists\":0,\"money\":99999,\"is_local\":true}"}},"feature":"match_info"}

kill_feed note

List of parameters:

  • attacker - name of the killing player
  • victim - name of the killed player
  • assist 1/2/3/4 - name of the characters who assisted in the kill
  • weapon - name of the weapon/ability/ultimate used by the killing player or spike/fall damage
  • ult - name of the ultimate used, reserved for a non lethal ultimate such as Sage's resurrection
  • headshot - Boolean value if the kill was by headshot

Data Example:

{"info":{"match_info":{"kill_feed":"{\"attacker\":\"YTDestruct28\",\"victim\":\"Ghostblade\",\"weapon\":\"TX_Hud_Volcano\",\"ult\":\"\",\"assist1\":\"TX_Killfeed_Sage1\",\"assist2\":\"\",\"assist3\":\"\",\"assist4\":\"\",\"headshot\":false}"}},"feature":"match_info"}

None lethal ultimate example:

{"info":{"match_info":{"kill_feed":"{\"attacker\":\"JacksAtWork\",\"victim\":\"jaxxxsosparrow\",\"weapon\":\"\",\"ult\":\"TX_Thorne_Heal\",\"assist1\":\"\",\"assist2\":\"\",\"assist3\":\"\",\"assist4\":\"\",\"headshot\":false}"}},"feature":"match_info"}

Events

EventEvent DataFired WhenNotesSince GEP Ver.
match_startnullMatch started.See notes148.0
match_endnullMatch ended.See notes148.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

keyCategoryValuesNotesSince GEP Ver.
scenegame_infoThe current scene-state.See notes148.0
stategame_infoThe current game-state.See notes148.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
  • "Canyon" - Fracture map
  • "Pitt" - Pearl 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

keyCategoryValuesNotesSince GEP Ver.
killskillAmount of kills performed by the local player.See notes148.0
assistskillAmount of assists performed by the local player.See notes148.0
headshotskillAmount of headshots performed by the local player.See notes150.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

EventEvent DataFired WhenNotesSince GEP Ver.
killTotal killsKill is performed.See notes148.0
assistTotal assistsAssist is performed.See notes148.0
headshotTotal headshotsHeadshot is performed.See notes150.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

keyCategoryValuesNotesSince GEP Ver.
deathsdeathAmount of deaths by the local player.See notes148.0

death note

Data Example:

{"info":{"death":{"deaths":1}},"feature":"death"}

Events

EventEvent DataFired WhenNotesSince GEP Ver.
deathTotal deathsLocal player died.See notes148.0

death note

Data Example:

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