gg.postmatch.rocketleague.defs

jbhutch.bsky.social

Documentation

liveCapture object

Provenance for a complete report produced from Rocket League's live Game Data API.

Properties

collectorVersion string Required

Version of the Postmatch collector that assembled this report.

maxLength: 128 bytesminLength: 1 bytes
endEvidence string Required

Evidence used to decide that the match was complete. match-ended-event means Rocket League emitted MatchEnded. score-derived means teardown arrived without MatchEnded and the collector inferred completion only from a decisive overtime score or a non-tied regulation score at zero seconds.

finalSnapshot string Required

Where the final scoreboard snapshot sat relative to an observed MatchEnded event. after-match-ended is the usual case. before-match-ended means the accumulated last in-match snapshot was used; endEvidence says whether MatchEnded was observed or completion was score-derived.

source string Required

Source API used for this observation.

transport string Required

Transport used to receive the live frames.

View raw schema
{
  "description": "Provenance for a complete report produced from Rocket League's live Game Data API.",
  "properties": {
    "collectorVersion": {
      "description": "Version of the Postmatch collector that assembled this report.",
      "maxLength": 128,
      "minLength": 1,
      "type": "string"
    },
    "endEvidence": {
      "description": "Evidence used to decide that the match was complete. match-ended-event means Rocket League emitted MatchEnded. score-derived means teardown arrived without MatchEnded and the collector inferred completion only from a decisive overtime score or a non-tied regulation score at zero seconds.",
      "enum": [
        "match-ended-event",
        "score-derived"
      ],
      "type": "string"
    },
    "finalSnapshot": {
      "description": "Where the final scoreboard snapshot sat relative to an observed MatchEnded event. after-match-ended is the usual case. before-match-ended means the accumulated last in-match snapshot was used; endEvidence says whether MatchEnded was observed or completion was score-derived.",
      "enum": [
        "after-match-ended",
        "before-match-ended"
      ],
      "type": "string"
    },
    "source": {
      "const": "rocket-league-game-data-api",
      "description": "Source API used for this observation.",
      "type": "string"
    },
    "transport": {
      "const": "websocket",
      "description": "Transport used to receive the live frames.",
      "type": "string"
    }
  },
  "required": [
    "source",
    "transport",
    "collectorVersion",
    "endEvidence",
    "finalSnapshot"
  ],
  "type": "object"
}
player object

A public final-scoreboard row identified only within this observed match.

Properties

alias string Required

Public in-game display name observed on the final scoreboard.

maxLength: 128 bytesminLength: 1 bytesmaxGraphemes: 32 graphemes
matchPlayerKey integer Required

Rocket League Shortcut value; unique only within this report and never a durable account identifier.

minimum: 0
side ref #side Required

Intrinsic blue or orange side assigned to this player in the observed match.

View raw schema
{
  "description": "A public final-scoreboard row identified only within this observed match.",
  "properties": {
    "alias": {
      "description": "Public in-game display name observed on the final scoreboard.",
      "maxGraphemes": 32,
      "maxLength": 128,
      "minLength": 1,
      "type": "string"
    },
    "matchPlayerKey": {
      "description": "Rocket League Shortcut value; unique only within this report and never a durable account identifier.",
      "minimum": 0,
      "type": "integer"
    },
    "side": {
      "description": "Intrinsic blue or orange side assigned to this player in the observed match.",
      "ref": "#side",
      "type": "ref"
    },
    "stats": {
      "ref": "#playerStats",
      "type": "ref"
    }
  },
  "required": [
    "matchPlayerKey",
    "alias",
    "side",
    "stats"
  ],
  "type": "object"
}
playerStats object

Final Rocket League scoreboard totals for one match player.

Properties

assists integer Required

No description available.

minimum: 0
demos integer Required

No description available.

minimum: 0
goals integer Required

No description available.

minimum: 0
saves integer Required

No description available.

minimum: 0
score integer Required

In-game scoreboard points, not goals.

minimum: 0
shots integer Required

No description available.

minimum: 0
touches integer Required

Ball touches; car-to-car contact is not included.

minimum: 0
View raw schema
{
  "description": "Final Rocket League scoreboard totals for one match player.",
  "properties": {
    "assists": {
      "minimum": 0,
      "type": "integer"
    },
    "demos": {
      "minimum": 0,
      "type": "integer"
    },
    "goals": {
      "minimum": 0,
      "type": "integer"
    },
    "saves": {
      "minimum": 0,
      "type": "integer"
    },
    "score": {
      "description": "In-game scoreboard points, not goals.",
      "minimum": 0,
      "type": "integer"
    },
    "shots": {
      "minimum": 0,
      "type": "integer"
    },
    "touches": {
      "description": "Ball touches; car-to-car contact is not included.",
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "score",
    "goals",
    "shots",
    "assists",
    "saves",
    "demos",
    "touches"
  ],
  "type": "object"
}
reportingPlayer object

Identifies which match-scoped scoreboard row represents the author of this repository record.

Properties

matchPlayerKey integer Required

Must resolve to exactly one player row in this report.

minimum: 0
View raw schema
{
  "description": "Identifies which match-scoped scoreboard row represents the author of this repository record.",
  "properties": {
    "matchPlayerKey": {
      "description": "Must resolve to exactly one player row in this report.",
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "matchPlayerKey"
  ],
  "type": "object"
}
side string

An intrinsic Rocket League team side.

Allowed Values (closed enum)
blue orange
View raw schema
{
  "description": "An intrinsic Rocket League team side.",
  "enum": [
    "blue",
    "orange"
  ],
  "type": "string"
}
team object

Final score for one intrinsic Rocket League side.

Properties

score integer Required

Final observed team score.

minimum: 0
side ref #side Required

No description available.

View raw schema
{
  "description": "Final score for one intrinsic Rocket League side.",
  "properties": {
    "score": {
      "description": "Final observed team score.",
      "minimum": 0,
      "type": "integer"
    },
    "side": {
      "ref": "#side",
      "type": "ref"
    }
  },
  "required": [
    "side",
    "score"
  ],
  "type": "object"
}

Lexicon Garden

@