Edit

Rocket League Game Events

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

Game ID

10798

Sample Apps

• Rocket League game events sample app

Available Features

• gep_internal
• stats
• teamGoal
• opposingTeamGoal
• match
• roster
• me
• match_info
• death
• game_info

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

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

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

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
teamGoal	null	When the local player’s team has scored a goal	See notes	131.0

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

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
opposingTeamGoal	null	When the opposing team has scored a goal	See notes	131.0

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

Data Example:

[“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

Data Example:

[“soccar” | “basketball”, “hockey”, “items”, “volleyball”, “breakout”, “playTest”]

gameState note

Data Example:

[“waitingForPlayers” | “countdown | “active” | “postGoalScored” | “ReplayPlayback” | “PrePodiumSpotlight” | “Finished” | “Unknown” | “PodiumSpotlight”]

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

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

match_info

Info Updates

key	Category	Values	Notes	Since GEP Ver.
pseudo_match_id	match_info	Current match’s internal ID code.	See notes	130.0
mutator_settings	match_info	The current-chosen settings of the private match.	See notes	147.0
arena	match_info	The current private match's arena setting.	See notes	147.0
server_info	match_info	The info of the current match's server info.	See notes	147.0
action_points	match_info	Name of action that granted a score to local player.	See notes	160.0

pseudo_match_id note

Data Example:

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

mutator_settings note

Data Example:

{"info":{"match_info":{"mutator_settings":"SmallBall,HighBounciness,FastBall,LightBall,Pinball,BotsNone"}},"feature":"match_info"}

arena note

Data Example:

{"info":{"match_info":{"arena":"Random"}},"feature":"match_info"}

server_info note

Data Example:

{"info":{"match_info":{"server_info":"EU511-Gimbal9"}},"feature":"match_info"}

action_points note

Data Examples:

{"events":[{"name":"action_points","data":"Shot On Goal"}]}
{"events":[{"name":"action_points","data":"Goal"}]}
{"events":[{"name":"action_points","data":"First Touch"}]}
{"events":[{"name":"action_points","data":"Center Ball"}]}
{"events":[{"name":"action_points","data":"Pool Shot"}]}
{"events":[{"name":"action_points","data":"Assist"}]}
{"events":[{"name":"action_points","data":"Clear Goal"}]}
{"events":[{"name":"action_points","data":"Demolish"}]}
{"events":[{"name":"action_points","data":"Save"}]}
{"events":[{"name":"action_points","data":"Epic Save"}]}

roster

Info Updates

key	Category	Values	Notes	Since GEP Ver.
player0 / player1 … palyerN(N = number of players in the match)	playersInfo	Check notes	See notes	14.0
team1 / team2	teamsInfo	Check notes	See notes	24.0
team1_score / team2_score	teamsScore	team1 / team2 score – integer	See notes	86.0

player note

• Encoded stringified JSON containing the properties:
  • steamId – Steam ID of the player who died
  • score – Score of the player who died
  • goals – Goal count of the player
  • name – Name of the player that died
  • 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"}

teamsInfo note

Value:

Encoded stringified array of strings indicating the players IDs for each team. Each ID corresponds to an ID under the playersInfo category.

Data Example

{"info":{"teamsInfo":{"team1":"%5B%22player0%22%5D"}},"feature":"roster"}

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
rosterChange	Array containing players' information	A player leaves or joins the match	See notes	14.0
playerJoined	Check notes	A player joins the match	See notes	24.0
playerLeft	Check notes	A player leaves the match	See notes	24.0

rosterChange note

Data Example:

{"events":[{"name":"rosterChange","data":"{"roster": [{"steamId": "2535466851496806","score": 52,"goals": "0","name": "Daknowntesco","state": "0","team_score": 0,"team": "1","local": "0","index": 0},{"steamId": "8815809362838850094","score": 0,"goals": "0","name": "YT_BR33Z3_","state": "0","team_score": 0,"team": "2","local": "0","index": 1},{"steamId": "76561198239574678","score": 0,"goals": "0","name": "lars","state": "0","team_score": 0,"team": "1","local": "0","index": 2}]}"}]}

playerJoined 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
• team – Team number of the player (1 or 2)

Data Example:

{"events":[{"name":"playerJoined","data":"{"steamId":"2535428144972964","score":0,"goals": "0","name":"Joschy900","state":"0\","team_score":0,"team":"1","index": 2}"}]}

playerLeft 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
• team – Team number of the player (1 or 2)

Data Example:

{"events":[{"name":"playerLeft","data":"{"steamId":"156382600742638838","score":52,"goals":"0","name":"JHONNYHS","state":"0","team_score":1,"team":"2","index": 2}"}]}

me

Info Updates

key	Category	Values	Notes	Since GEP Ver.
steamId	me	Player’s Steam ID		14.0
name	me	Player’s name		14.0
goals	me	Player’s goal count		14.0
score	me	Player’s score		14.0
team	me	Player’s team number		14.0
team_score	me	Team score		86.0

me note

Data Examples:

{"info":{"me":{"goals":"1"}},"feature":"me"}
{"info":{"me":{"score":"102"}},"feature":"me"}
{"info":{"me":{"team_score":"1"}},"feature":"me"}

death

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
death	null	A player is demolished by an opponent.	See notes	160.0

death note

Data Example:

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

game_info

Info Updates

key	Category	Values	Notes	Since GEP Ver.
trade_menu_opened	game_info	true / false	See notes	170.3
trade_my_proposition	game_info	Local player's items that are on offer.	See notes	170.3
trade_opponent_proposition	game_info	Team member's items that are on offer.	See notes	170.3

trade_menu_opened note

Data Example:

{"info":{"game_info":{"trade_menu_opened":"true"}},"feature":"game_info"}
{"info":{"game_info":{"trade_menu_opened":"false"}},"feature":"game_info"}

trade_my_proposition note

Data Example:

{"info":{"game_info":{"trade_my_proposition":"[{"Index": "0","key" : "2625_0","ProductId" : "2625","ProductName" : "skin_aftershock_tigertiger","Color" : "0","Count" : "1"}]"}},"feature":"game_info"}
{"info":{"game_info":{"trade_my_proposition":"[]"}},"feature":"game_info"}

trade_opponent_proposition note

Data Example:

{"info":{"game_info":{"trade_opponent_proposition":"[{"Index": "0","key" : "2969_0","ProductId" : "2969","ProductName" : "skin_vanquish_watermelon","Color" : "0","Count" : "1"},{"Index": "1","key" : "4727_0","ProductId" : "4727","ProductName" : "hat_accordion","Color" : "0","Count" : "1"}]"}},"feature":"game_info"}
{"info":{"game_info":{"trade_opponent_proposition":"[]"}},"feature":"game_info"}