Overwolf

Overwolf

  • Getting Started
  • Docs
  • API
  • Events Status
  • Blog
  • Q&A
  • Support

›Available Game Events

API Reference

  • Changelog
  • Overview

App Manifest

  • manifest.json
  • Validate your manifest

Available Game Events

  • Games IDs
  • Apex Legends
  • Call of Duty: Warzone
  • CS:GO
  • Dota 2
  • Final Fantasy XIV
  • Dota Underlords
  • Escape From Tarkov
  • Fortnite
  • Hearthstone
  • Heroes of the Storm
  • Legends of Runeterra
  • League of Legends
  • Minecraft
  • MTG Arena
  • Overwatch
  • Path of Exile
  • PUBG
  • PUBG Lite
  • Rainbow Six Siege
  • Rocket League
  • StarCraft II
  • Teamfight Tactics
  • Valorant
  • World of Tanks
  • World of Warcraft
  • World of Warships
  • Warframe
  • Various External APIs

Game Launchers Events

  • Launchers IDs
  • LOL Launcher

overwolf.benchmarking

  • overwolf.benchmarking

overwolf.campaigns

  • overwolf.campaigns.crossapp

overwolf.cryptography

  • overwolf.cryptography

overwolf.extensions

  • overwolf.extensions
  • overwolf.extensions.current
  • overwolf.extensions.sharedData
  • overwolf.extensions.io

overwolf.games

  • overwolf.games
  • overwolf.games.events
  • overwolf.games.inputTracking
  • overwolf.games.launchers
  • overwolf.games.launchers.events

overwolf.io

  • overwolf.io
  • overwolf.io.paths

overwolf.log

  • overwolf.log

overwolf.logitech

  • overwolf.logitech
  • overwolf.logitech.arx
  • overwolf.logitech.led

overwolf.media

  • overwolf.media
  • overwolf.media.audio
  • overwolf.media.replays
  • overwolf.media.videos
  • Highlights supported games

overwolf.os

  • overwolf.os
  • overwolf.os.tray

overwolf.profile

  • overwolf.profile
  • overwolf.profile.subscriptions

overwolf.settings

  • overwolf.settings
  • overwolf.settings.hotkeys
  • overwolf.settings.language
  • overwolf.settings.games

overwolf.social

  • overwolf.social
  • overwolf.social.reddit
  • overwolf.social.youtube
  • overwolf.social.discord
  • overwolf.social.gfycat
  • overwolf.social.twitter

overwolf.streaming

  • overwolf.streaming

overwolf.tobii

  • overwolf.tobii

overwolf.utils

  • overwolf.utils

overwolf.web

  • overwolf.web
  • overwolf.web.webserver
  • overwolf.web.websocket

overwolf.windows

  • overwolf.windows
Edit

Valorant

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

Game ID

21640

Sample Apps

  • VALORANT game events sample app

Available Features

  • gep_internal
  • me
  • game_info
  • match_info
  • kill
  • death

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

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

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 = Deatchmatch

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

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

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
  • "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}]}
Last updated on 2021-1-15 by Shir Brass
← Teamfight TacticsWorld of Tanks →
  • Sample Apps
  • Available Features
  • Game event status
  • gep_internal
    • Info Updates
  • me
    • Info Updates
  • match_info
    • Info Updates
    • Events
  • game_info
    • Info Updates
  • kill
    • Info Updates
    • Events
  • death
    • Info Updates
    • Events
  • Legal
  • Terms overview
  • Developer's terms
  • App terms
  • Overwolf terms
  • Overwolf Privacy policy
  • Support
  • Questions and Answers
  • Discord
  • Slack
  • Facebook
  • Twitter
  • Documentation
  • Changelog
  • API
  • App Creation Process
  • Best Practices
  • Game Events status
  • Information
  • Careers
  • Fund
  • Developers Blog
  • Overwolf Appstore
  • Advertise on Overwolf