Skip to main content

CS:GO Game Events

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

Available Features

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

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

kill

Events

EventEvent DataFired WhenNotesSince GEP Ver.
killtotalKills – total kills for player in matchPlayer has killed an enemySee notes70.0

kill note

Data Example:

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

death

Events

EventEvent DataFired WhenNotesSince GEP Ver.
deathtotalDeaths – total deaths of the player in a matchPlayer has diedSee notes70.0

death note

Data Example:

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

assist

Events

EventEvent DataFired WhenNotesSince GEP Ver.
assisttotalAssists – total assists for user it matchPlayer has assisted in killing an enemySee notes70.0

assist note

Data Example:

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

headshot

Events

EventEvent DataFired WhenNotesSince GEP Ver.
headshotheadshotsInRound – total headshots for user in the current roundPlayer has gained a kill with a headshotFired alongside kill event70.0

headshot note

Data Example:

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

round_start

Events

EventEvent DataFired WhenNotesSince GEP Ver.
round_start
  • num_of_rounds – total number of rounds in current match
  • player_team – CT/T
A new round has beganSee notes70.0

round_start note

Data Example:

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

match_start

Events

EventEvent DataFired WhenNotesSince GEP Ver.
match_startNoneA new match has startedSee notes70.0

match_start note

Data Example:

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

match_end

Events

EventEvent DataFired WhenNotesSince GEP Ver.
match_endNoneMatch has endedSee notes70.0

match_end note

Data Example:

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

team_round_win

Events

EventEvent DataFired WhenNotesSince GEP Ver.
team_round_winNone
  • winningTeam – the team that won the round (CT/T)
  • bomb – bomb status (exploded/defused/planted)
See notes70.0

team_round_win note

Data Example:

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

bomb_planted

Events

EventEvent DataFired WhenNotesSince GEP Ver.
bomb_plantedNoneA bomb has been planted (by any player)See notes70.0

bomb_planted note

Data Example:

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

bomb_change

Events

EventEvent DataFired WhenNotesSince GEP Ver.
bomb_changeBomb state (planted / exploded / defused)Bomb state was changedSee notes70.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

EventEvent DataFired WhenNotesSince GEP Ver.
reloading
  • weapon_name
  • weapon_current_ammo
  • weapon_max_ammo
  • weapon_type
Player reloads his weaponSee notes70.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

EventEvent DataFired WhenNotesSince GEP Ver.
fired
  • weapon_name
  • weapon_current_ammo
  • weapon_max_ammo
  • weapon_type
"fired" is not available on "Arms Race" and "Demolition" modes70.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

EventEvent DataFired WhenNotesSince GEP Ver.
weapon_change
  • weapon_name
  • weapon_type
Player switches weaponsSee notes70.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

EventEvent DataFired WhenNotesSince GEP Ver.
weapon_acquired
  • weapon_name
  • weapon_type
Player acquired a new weapon (either purchased or picked up)See notes70.0

weapon_acquired note

Data Example:

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

player_activity_change

Events

EventEvent DataFired WhenNotesSince GEP Ver.
player_activity_change
  • playing
  • menu
  • The player started playing
  • The player entered the game’s menu
See notes70.0

player_activity_change note

Data Example:

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

team_set

Events

EventEvent DataFired WhenNotesSince GEP Ver.
team_set
  • CT
  • T
The player selected a teamSee notes70.0

team_set note

Data Example:

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

match_info

Info Updates

keyCategoryValuesNotesSince GEP Ver.
pseudo_match_idmatch_infoThe current match’s ID code. See notes130.0
server_infomatch_infoThe current session’s server ID. See notes135.0
game_modematch_infoThe current game mode that is played. See notes135.0
phasematch_infoThe current state of the match. See notes137.0
match_outcomematch_infowin/lose/tie. See notes140.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

keyCategoryValuesNotesSince GEP Ver.
totalKillsplayerTotal kills in a matchSee notes70.0
totalDeathsplayerTotal deaths in a matchSee notes70.0
totalMvpsplayerTotal MVP awardsSee notes70.0
scoreplayerScore in a matchSee notes70.0
teamplayerT / CTSee notes70.0
steamidplayerThe player’s steam idSee notes70.0
maproundMap nameSee notes70.0
moderoundMap mode (for example: "casual")See notes70.0
numOfRoundroundRound number in the match (starting 0)See notes70.0
phaseroundMatch phase
  • warmup
  • live
  • freezetime
  • over
See notes70.0
scenescene
  • MainMenu
  • LoadingScreen
  • Game
  • MenuInGame(ESC)
See notes70.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"}
  • Zoo
{"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

keyCategoryValuesNotesSince GEP Ver.
lobbyrosterJSON containing array of lobby_players objects. See notes77.0
matchrosterJSON containing array of player objects. See notes77.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

keyCategoryValuesNotesSince GEP Ver.
replay_listreplaySee notes134.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

keyCategoryValuesNotesSince GEP Ver.
pingperformanceLatency to server197.0
{"info":{"performance":{"ping":"68"}},"feature":"counters"}

mvp

Events

EventEvent DataFired WhenNotesSince GEP Ver.
mvptotalMvpsmvp is awarded.See notes70.0

mvp note

Data Example:

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

scoreboard

Info Updates

keyCategoryValuesNotesSince GEP Ver.
scoreboard_xxgame_infoPossible values:
  • Nickname
  • Steam ID
  • Team
  • Amount of money
  • Amount of kills
  • Assists
  • Deaths
  • Mvps
  • Score
  • Enemy flash
  • Utility damage
  • Average damage round
  • Ping
  • local_player
See notes148.0

scoreboard_xx note

Data Examples:

{"info":{"game_info":{"scoreboard_17":"{\"nickname\":\"Jenssen\",\"steamid\":76561199237064949,\"team\":\"T\",\"money\":2700,\"kills\":0,\"assists\":0,\"deaths\":0,\"mvps\":0,\"score\":0,\"adr\":0,\"ud\":0,\"ef\":0,\"ping\":80,\"local_player\":0}\n"}},"feature":"scoreboard"}

kill_feed

Events

EventEvent DataFired WhenNotesSince GEP Ver.
kill_feedKills & assists informationAnytime a player dies in match.See notes148.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.