- Game events API
Please read the overwolf.games.events documentation page to learn how to use Overwolf game events.
Sample Apps
Available Features
Game events status
It's recommended to communicate errors and warnings to your users. You can check game event status here or easily verify event status directly 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"}
stats
Info Updates
| key | Category | Values | Notes | Since GEP Ver. |
|---|---|---|---|---|
| player0 / player1 … playerN(N = number of players in the match) | playersInfo | Check notes | See notes | 14.0 |
player note
- Encoded stringified JSON containing the properties:
- steamId – Steam ID of the player
- score – Score of the player
- goals – Goal count of the player
- name – Name of the player
- team – Team number of the player (1 or 2)
Comment:
Encoded stringified JSON containing the properties. Need to do a decodeURI() on the value and then JSON.parse() on the result.
Data Example:
{"info":{"playersInfo":{"player0":"%7B%22steamId%22:%222535466851496806%22,%22score%22:52,%22goals%22:%220%22,%22name%22:%22Daknowntesco%22,%22state%22:%220%22,%22team_score%22:0,%22team%22:%221%22,%22local%22:%220%22,%22index%22:0%7D"}},"feature":"roster"}
Events
| Event | Event Data | Fired When | Notes | Since GEP Ver. |
|---|---|---|---|---|
| goal | Check notes | A goal has been scored | See notes | 14.0 |
| score | Check notes | Score of a player has changed | See notes | 86.0 |
| teamGoal | null | When the local player’s team has scored a goal | See notes | 131.0 |
| opposingTeamGoal | null | When the opposing team has scored a goal | See notes | 131.0 |
goal note
Event Data:
- steamId – Steam id of the player scoring the goal
- score – Score of the player scoring the goal
- goals – Goal count of the player
- name – Name of the player scoring the goal
- team – Team number of the scoring player (1 or 2)
- local – Whether the player who scored is the local player
Comments:
Encoded stringified JSON containing the properties. Need to do a decodeURI() on the value and then JSON.parse() on the result
Data Example:
{"events":[{"name":"goal","data":"{ "steamId": "0", "score": 118, "goals": "1", "name": "Ram is troll", "state": "0", "team_score": 1, "team": "2", "local": "1", "index": 3}"}]}
score note
Event Data:
- steamId – Steam ID of the player
- score – Score of the player
- goals – Goal count of the player
- name – Name of the player
- state
- team_score
- team – Team number of the player (1 or 2)
- index
Comments:
Encoded stringified JSON containing the properties. Need to do a decodeURI() on the value and the JSON.parse() on the result
Data Example:
{"info":{"me":{"team_score":"0"}},"feature":"me"}
{"info":{"teamsScore":{"team1_score":"0"}},"feature":"roster"}
{"info":{"teamsScore":{"team2_score":"0"}},"feature":"roster"}
{"info":{"me":{"score":"725"}},"feature":"me"}
teamGoal note
Data Example:
{"events":[{"name":"teamGoal","data":"{"steamId":"2535424769966317","score":126,"goals":"1","name":"JteRushencroks0","state":"0","team_score":2,"team":"1","index":4}"}]}
opposingTeamGoal note
Data Example:
{"events":[{"name":"opposingTeamGoal","data":"{"steamId":"2535461211167231","score":128,"goals":"1","name":"JaffaCake200015","state":"0","team_score":1,"team":"1","index":2}"}]}
match
Info Updates
| key | Category | Values | Notes | Since GEP Ver. |
|---|---|---|---|---|
| started | matchState | "true" / "false" | 14.0 | |
| ended | matchState | "true" / "false" | 86.0 | |
| matchType | matchInfo | Current match type | See notes | 86.0 |
| ranked | matchInfo | True if the match is ranked, false otherwise "true"/"false" | 86.0 | |
| maxPlayers | matchInfo | Maximum number of players allowed in this match | See notes | 86.0 |
| gameMode | matchInfo | Game mode of the match | See notes | 86.0 |
| gameState | matchInfo | Current state of the game | See notes | 86.0 |
| gameType | matchInfo | Current game type | 86.0 |
matchType note
Possible values:
- Lobby
- Private
- Online
- Offline
Data Example:
{"info":{"matchInfo":{"matchType":"Online"}},"feature":"match"}
maxPlayers note
(integer – use parseInt)
Data Example:
{"info":{"matchInfo":{"maxPlayers":"6"}},"feature":"match"}
gameMode note
Possible values:
- Soccar
- Breakout (Dropshot)
- Basketball
- Hockey
- Items
- Unknown
Data Example:
{"feature":"match","category":"matchInfo","key":"gameMode","value":"Soccar"}
gameState note
Possible values:
- WaitingForPlayers
- Countdown
- Active
- PostGoalScored
- ReplayPlayback
- PrePodiumSpotlight
- Finished
- Unknown
- PodiumSpotlight
Data Example:
{"info":{"matchInfo":{"gameState":"WaitingForPlayers"}},"feature":"match"}
Events
| Event | Event Data | Fired When | Notes | Since GEP Ver. |
|---|---|---|---|---|
| matchStart | null | Match starts | See notes | 14.0 |
| matchEnd | null | Match ends | See notes | 14.0 |
| victory | null | team_score (1 / 2)(1 – Victory, 2 - defeat) | 86.0 | |
| defeat | null | team_score (1 / 2)(1 – Victory, 2 - defeat) | 86.0 | |
| surrender | ID of the forfeiting team | A team forfeits the match | See notes | 253.0 |
| overtime | null | The match reaches overtime | See notes | 253.0 |
matchStart note
Data Example:
{"events":[{"name":"matchStart","data":""}]}
matchEnd note
Data Example:
{"events":[{"name":"matchEnd","data":""}]}
victory note
Data Example:
{"events":[{"name":"victory","data":"{"team_score":5}"}]}
defeat note
Data Example:
{"events":[{"name":"defeat","data":"{"team_score":0}"}]}
Data Example:
{"events":[{"name":"defeat","data":"{"team_score":0}"}]}