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

key	Category	Values	Notes	Since GEP Ver.
gep_internal	gep_internal	Local + Public version number	See notes	143.0

gep_internal note

Data Example:

{"feature":"gep_internal","category":"gep_internal","key":"version_info","value":"{"local_version":"143.0.10","public_version":"143.0.10","is_updated":true}"}

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

match_info

Info Updates

key	Category	Values	Notes	Since GEP Ver.
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_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"}

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:

{"feature":"match_info","event":"match_start","data":null}

match_end note

Data Example:

{"feature":"match_info","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:

{"feature":"game_info","category":"game_info","key":"scene","value":"Triad"}

Possible Scene values:

• "MainMenu" - Main menu
• "Triad" - Bind map
• "Duality" - Haven map
• "Bonsai" - Split map
• "Range" - Practice Range map
• "CharacterSelectPersistentLevel" - Character Selection

state note

Data Example:

{"feature":"game_info","category":"game_info","key":"state","value":"WaitingToStart"}
{"feature":"game_info","category":"game_info","key":"state","value":"InProgress"}

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

kill note

Data Example:

{"feature":"kill","category":"kill","key":"kills","value":1}
{"feature":"kill","category":"kill","key":"kills","value":2}
{"feature":"kill","category":"kill","key":"kills","value":3}

assist note

Data Example:

{"info":{"kill":{"assists":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

kill note

Data Example:

{"events":[{"name":"kill","data":6}]}

assist note

Data Example:

{"events":[{"name":"assist","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:

{"feature":"death","category":"death","key":"deaths","value":1}

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