Counter-Strike: Global Offensive Game events
Support for this game has been deprecated, following the game's shutdown due to the release of Counter-Strike 2.
This page is being kept for historial documentation purposes.
Please read the overwolf.games.events documentation page to learn how to use Overwolf game events.
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
- gep_internal
- 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
- match_score
- 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 |
| 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 |
| 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 |
| 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 |
| "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 |
| 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 |
| 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 |
|
| 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 |
| The player selected a team | See notes | 70.0 |
team_set note
Data Example:
{"events":[{"name":"team_set","data":"{ "team": "T"}"}]}
match_score
Events
Event | Event Data | Fired When | Notes | Since GEP Ver. |
---|---|---|---|---|
score | Currnt score of the match | At the end of a round | See notes | 70.0 |
match_score note
Data Example:
{"events":[{"name":"score","data":"{\r\n \"team_ct\": 6,\r\n \"team_t\": 2\r\n}"}]}
match_info
Info Updates
key | Category | Values | Notes | 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
| See notes | 70.0 |
scene | scene |
| 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"}
- 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
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"}]}"}
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"]"}
counters
Info Updates
key | Category | Values | Notes | Since GEP Ver. |
---|---|---|---|---|
ping | performance | Latency to server | 197.0 |
{"info":{"performance":{"ping":"68"}},"feature":"counters"}
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:
| See notes | 148.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
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"}"}]}