CS:GO Game Events · Overwolf

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

Game ID

7764

trusted mode

When running this game in trusted mode (without any launch parameters), OW can't go into an "exclusive mode" once the game is in a fullscreen state. This means - there is no way to interact with your OW app window when this issue occurs. Read our Exclusive Mode guide to understand how to get a relevant indications for this unique state, so you'll be able to notify the user / change the app flow accordingly if needed.

Sample Apps

CS:GO game events sample app

Available Features

gep_internal
match_info
kill
death
assist
headshot
round_start
match_start
match_info
match_end
team_round_win
bomb_planted
bomb_change
reloading
fired
weapon_change
weapon_acquired
info
roster
player_activity_change
team_set
replay
counters
mvp
scoreboard
kill_feed

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

`kill`

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
kill	totalKills – total kills for player in match	Player has killed an enemy	See notes	70.0

kill note

Data Example:

{"events":[{"name":"kill","data":"{  "totalKills": 1}"}]}

`death`

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
death	totalDeaths – total deaths of the player in a match	Player has died	See notes	70.0

death note

Data Example:

{"events":[{"name":"death","data":"{  "totalDeaths": 1}"}]}

`assist`

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
assist	totalAssists – total assists for user it match	Player has assisted in killing an enemy	See notes	70.0

assist note

Data Example:

{"events":[{"name":"assist","data":"{  "totalAssists": 1}"}]}

`headshot`

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
headshot	headshotsInRound – total headshots for user in the current round	Player has gained a kill with a headshot	Fired alongside kill event	70.0

headshot note

Data Example:

{"events":[{"name":"headshot","data":"{  "headshotsInRound": 1}"}]}

`round_start`

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
round_start	num_of_rounds – total number of rounds in current match player_team – CT/T	A new round has began	See notes	70.0

round_start note

Data Example:

{"events":[{"name":"round_start","data":"{  "num_of_rounds": 1,  "player_team": "T"}"}]}

`match_start`

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
match_start	None	A new match has started	See notes	70.0

match_start note

Data Example:

{"events":[{"name":"match_start","data":"{  "player_team": null}"}]}

`match_end`

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
match_end	None	Match has ended	See notes	70.0

match_end note

Data Example:

{"events":[{"name":"match_end","data":"{}"}]}

`team_round_win`

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
team_round_win	None	winningTeam – the team that won the round (CT/T) bomb – bomb status (exploded/defused/planted)	See notes	70.0

team_round_win note

Data Example:

{"events":[{"name":"team_round_win","data":"{  "winningTeam": "T",  "bomb": null}"}]}

`bomb_planted`

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
bomb_planted	None	A bomb has been planted (by any player)	See notes	70.0

bomb_planted note

Data Example:

{"events":[{"name":"bomb_planted","data":"{}"}]}

`bomb_change`

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
bomb_change	Bomb state (planted / exploded / defused)	Bomb state was changed	See notes	70.0

bomb_change note

Data Example:

{"events":[{"name":"bomb_change","data":"{  "state": "planted"}"}]}
{"events":[{"name":"bomb_change","data":"{  "state": "exploded"}"}]}
{"events":[{"name":"bomb_change","data":"{  "state": "defused"}"}]}

`reloading`

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
reloading	weapon_name weapon_current_ammo weapon_max_ammo weapon_type	Player reloads his weapon	See notes	70.0

reloading note

Data Example:

{"events":[{"name":"reloading","data":"{  "weapon_name": "weapon_glock",  "weapon_current_ammo": 3,  "weapon_max_ammo": 20,  "weapon_type": "Pistol"}"}]}

`fired`

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
fired	weapon_name weapon_current_ammo weapon_max_ammo weapon_type		"fired" is not available on "Arms Race" and "Demolition" modes	70.0

fired note

Data Example:

{"events":[{"name":"fired","data":"{  "weapon_name": "weapon_glock",  "weapon_current_ammo": 19,  "weapon_max_ammo": 20,  "weapon_type": "Pistol"}"}]}

`weapon_change`

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
weapon_change	weapon_name weapon_type	Player switches weapons	See notes	70.0

weapon_change note

weapon_type:

"Knife", "Pistol", "Shotgun", "Machine Gun", "Submachine Gun", "Rifle", "SniperRifle", "Grenade", "C4", "Tablet", "Fists"

weapon_name:

"weapon_knife", "weapon_knife_t", "weapon_hkp2000", "weapon_usp_silencer", "weapon_glock", "weapon_elite",  "weapon_p250", "weapon_fiveseven", "weapon_cz75a","weapon_tec9", "weapon_deagle", "weapon_revolver", "weapon_nova", "weapon_xm1014", "weapon_mag7","weapon_sawedoff", "weapon_m249", "weapon_negev",  "weapon_mp9", "weapon_mac10", "weapon_mp7",  "weapon_ump45", "weapon_p90", "weapon_bizon","weapon_famas", "weapon_galilar", "weapon_m4a1",  "weapon_m4a1_silencer", "weapon_ak47","weapon_ssg08", "weapon_aug", "weapon_sg556", "weapon_awp", "weapon_scar20", "weapon_g3sg1","weapon_incgrenade", "weapon_decoy", "weapon_flashbang", "weapon_hegrenade", "weapon_smokegrenade", "weapon_c4", "weapon_bayonet"

`weapon_acquired`

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
weapon_acquired	weapon_name weapon_type	Player acquired a new weapon (either purchased or picked up)	See notes	70.0

weapon_acquired note

Data Example:

{"events":[{"name":"weapon_acquired","data":"{  "weapon_name": "weapon_hkp2000",  "weapon_type": "Pistol"}"}]}

`player_activity_change`

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
player_activity_change	playing menu	The player started playing The player entered the game’s menu	See notes	70.0

player_activity_change note

Data Example:

{"events":[{"name":"player_activity_change","data":"{  "activity": "playing"}"}]}

`team_set`

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
team_set	CT T	The player selected a team	See notes	70.0

team_set note

Data Example:

{"events":[{"name":"team_set","data":"{  "team": "T"}"}]}

`match_info`

Info Updates

key	Category	Values	Since GEP Ver.
pseudo_match_id	match_info	The current match’s ID code. See notes	130.0
server_info	match_info	The current session’s server ID. See notes	135.0
game_mode	match_info	The current game mode that is played. See notes	135.0
phase	match_info	The current state of the match. See notes	137.0
match_outcome	match_info	win/lose/tie. See notes	140.0

pseudo_match_id note

This is an Overwolf-generated code, unrelated to Steam.

Data Example:

0c0ea3df-97ea-4d3a-b1f6-f8e34042251f

server_info note

Data Example:

{"info":{"match_info":{"server_info":"{"name":"Counter-Strike: Global Offensive","ip":"=[A:1:2111360000:13753]:0:0"}"}},"feature":"match_info"}

{"match_info":{"server_info":"{"name":"RU | ALTAI AWP [!ws,!knife,!gloves,!viptest] 128tick","ip":"212.22.93.74:27040"}"}}

game_mode note

Data Example:

Competitive mode on "Dust II" map

{"match_info":{"game_mode":"Competitive Dust II"}}

VS BOTS on "Dust II" map

{"match_info":{"game_mode":"Offline Deathmatch Dust II"}}

Community Server, "Causal" mode and server name

{"match_info":{"game_mode":"Community Casual surf_ski_2_GO_sw"}}

"Casual" mode on "Dust II" map

{"match_info":{"game_mode":"Casual Dust II"}}

Spectating "Casual" mode on "Dust II" map

{"match_info":{"game_mode":"Watching Casual Dust II"}}

phase note

Possible Values:

NotInGame (currently unavailable)
Loading
InGame
InGameTerroristTeamPlay
InGameCounterTerroristTeamPlay
PauseExchangeTeam
MatchResult
UNKNOWN

Data Example:

{"feature":"match_info","category":"match_info","key":"phase","value":"MatchResult"}

match_outcome note

Data Example:

{"info":{"match_info":{"match_outcome":"win"}},"feature":"match_info"}
{"info":{"match_info":{"match_outcome":"lose"}},"feature":"match_info"}

`info`

Info Updates

key	Category	Values	Notes	Since GEP Ver.
totalKills	player	Total kills in a match	See notes	70.0
totalDeaths	player	Total deaths in a match	See notes	70.0
totalMvps	player	Total MVP awards	See notes	70.0
score	player	Score in a match	See notes	70.0
team	player	T / CT	See notes	70.0
steamid	player	The player’s steam id	See notes	70.0
map	round	Map name	See notes	70.0
mode	round	Map mode (for example: "casual")	See notes	70.0
numOfRound	round	Round number in the match (starting 0)	See notes	70.0
phase	round	Match phase warmup live freezetime over	See notes	70.0
scene	scene	MainMenu LoadingScreen Game MenuInGame(ESC)	See notes	70.0

totalKills note

Data Example:

{"info":{"player":{"totalKills":"1"}},"feature":"info"}

totalDeaths note

Data Example:

{"info":{"player":{"totalDeaths":"1"}},"feature":"info"}

totalMvps note

Data Example:

{"info":{"player":{"totalMvps":"1"}},"feature":"info"}

score note

Data Example:

{"info":{"player":{"score":"2"}},"feature":"info"}

team note

Data Example:

{"info":{"player":{"team":"CT"}},"feature":"info"}

steamId note

Data Example:

{"info":{"player":{"steamid":"76561197971316549"}},"feature":"info"}

map note

List of all the map names and data:

Casual/Ranked/Deathmatch Maps:

Dust II

{"info":{"match_info":{"game_mode":"Offline Casual Dust II"}},"feature":"match_info"}

Mirage

{"info":{"match_info":{"game_mode":"Offline Casual Mirage"}},"feature":"match_info"}

Inferno

{"info":{"match_info":{"game_mode":"Offline Casual Inferno"}},"feature":"match_info"}

Vertigo

{"info":{"match_info":{"game_mode":"Offline Casual Vertigo"}},"feature":"match_info"}

Cobblestone

{"info":{"match_info":{"game_mode":"Offline Casual Cobblestone"}},"feature":"match_info"}

Cache

{"info":{"match_info":{"game_mode":"Offline Casual Cache"}},"feature":"match_info"}

{"info":{"match_info":{"game_mode":"Offline Casual Zoo"}},"feature":"match_info"}

Breach

{"info":{"match_info":{"game_mode":"Offline Casual Breach"}},"feature":"match_info"}

Seaside

{"info":{"match_info":{"game_mode":"Offline Casual Seaside"}},"feature":"match_info"}

Train

{"info":{"match_info":{"game_mode":"Offline Casual Train"}},"feature":"match_info"}

Overpass

{"info":{"match_info":{"game_mode":"Offline Casual Overpass"}},"feature":"match_info"}

Nuke

{"info":{"match_info":{"game_mode":"Offline Casual Nuke"}},"feature":"match_info"}

Canals

{"info":{"match_info":{"game_mode":"Offline Casual Canals"}},"feature":"match_info"}

Agency

{"info":{"match_info":{"game_mode":"Offline Casual Agency"}},"feature":"match_info"}

Miltia

{"info":{"match_info":{"game_mode":"Offline Casual Militia"}},"feature":"match_info"}

Office

{"info":{"match_info":{"game_mode":"Offline Casual Office"}},"feature":"match_info"}

Italy

{"info":{"match_info":{"game_mode":"Offline Casual Italy"}},"feature":"match_info"}

Assault

{"info":{"match_info":{"game_mode":"Offline Casual Assault"}},"feature":"match_info"}

War Games Map names:

Lake

{"info":{"match_info":{"game_mode":"Offline War Games Lake"}},"feature":"match_info"}

St.marc

{"info":{"match_info":{"game_mode":"Offline War Games St. Marc"}},"feature":"match_info"}

Safehouse

{"info":{"match_info":{"game_mode":"Offline War Games Safehouse"}},"feature":"match_info"}

Shoots

{"info":{"match_info":{"game_mode":"Offline War Games Shoots"}},"feature":"match_info"}

Baggage

{"info":{"match_info":{"game_mode":"Offline War Games Baggage"}},"feature":"match_info"}

Monastery

{"info":{"match_info":{"game_mode":"Offline War Games Monastery"}},"feature":"match_info"}

Sugarcane

{"info":{"match_info":{"game_mode":"Offline War Games Sugarcane"}},"feature":"match_info"}

Bank

{"info":{"match_info":{"game_mode":"Offline War Games Bank"}},"feature":"match_info"}

Shortdust

{"info":{"match_info":{"game_mode":"Offline War Games Shortdust"}},"feature":"match_info"}

Dizzy

{"info":{"match_info":{"game_mode":"Offline War Games Dizzy"}},"feature":"match_info"}

mode note

Data Example:

{"info":{"round":{"mode":"casual"}},"feature":"info"}

numOfRound note

Data Example:

{"info":{"round":{"numOfRound":"1"}},"feature":"info"}

phase note

Data Example:

{"info":{"round":{"phase":"live"}},"feature":"info"}
{"info":{"round":{"phase":"freezetime"}},"feature":"info"}

scene note

Data Example:

{"info":{"scene":{"scene":"ClientLoading"}},"feature":"info"}
{"info":{"scene":{"scene":"MainMenu"}},"feature":"info"}
{"info":{"scene":{"scene":"LoadingScreen"}},"feature":"info"}
{"info":{"scene":{"scene":"Game"}},"feature":"info"}

`roster`

Info Updates

key	Category	Values	Notes	Since GEP Ver.
lobby	roster	JSON containing array of lobby_players objects. See notes		77.0
match	roster	JSON containing array of player objects. See notes		77.0

lobby note

Each player contains:

steamId

Data Example:

{
    "feature":"roster",
    "category":"roster",
    "key":"lobby",
    "value":"{"lobby_players" : [{"steamId":"76561198269560618"}]}"}

Note: This event is not supported on trusted mode.

match note

Each player contains:

steamId
team

Data Example:

{
    "feature":"roster",
    "category":"roster",
    "key":"match",
    "value":"{"players" : [
            {"steamId":"76561198364007097","team":"Counter-Terrorists"},{"steamId":"76561198389957131","team": "Counter-Terrorists"}
    ]}"}

`replay`

Info Updates

key	Category	Values	Notes	Since GEP Ver.
replay_list	replay	See notes		134.0

replay note

Values:

A list containing the URL address of all available replays that are currently stored in your profile (can be accessed via the main menu under "Your Matches").

Data Example:

{"feature":"replay","category":"replay","key":"replay_list","value":"["steam://rungame/730/76561202255233023/+csgo_download_match CSGO-dVoC5-kwY8k-LCb3J-wCiMw-CrahQ","steam://rungame/730/76561202255233023/+csgo_download_match CSGO-myDzD-AOTzm-wYZzH-bCmrA-JebRF"]"}

Note: This event is not supported on trusted mode.

`counters`

Info Updates

key	Category	Values	Notes	Since GEP Ver.
ping	performance	Latency to server

`mvp`

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
mvp	totalMvps	mvp is awarded.	See notes	70.0

mvp note

Data Example:

{"event":"mvp","value":{"totalMvps":1}}

`scoreboard`

Info Updates

key	Category	Values	Notes	Since GEP Ver.
scoreboard_xx	game_info	Possible values: Steam ID Team Amount of money Amount of kills Assists Deaths Mvps Score Enemy flash Utility damage Average damage round	See notes	148.0

scoreboard_xx note

Data Examples:

{"info":{"game_info":{"scoreboard_1":"{"steamid":76561198864213590,"team":"T","money":0,"kills":2,"assists":0,"deaths":2,"mvps":0,"score":5,"adr":0,"ud":3,"ef":2}"}},"feature":"scoreboard"}

`kill_feed`

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
kill_feed	Kills & assists information	Anytime a player dies in match.	See notes	148.0

kill_feed note

Data Example:

{"events":[{"name":"kill_feed","data":"{"attacker":"ALP","assister":"","weapon":"m4a1","headshot":true,"suicide":false,"wallbang":false,"revenge":false,"domination":false,"noscope":false,"throughsmoke":false,"flashed":false,"victim":"Matiosss"}"}]}

Note: This event is not supported on trusted mode.