SummerMatchResult

Class: SummerMatchResult · Inherits: RefCounted This player’s own view of one concluded Match. Two facts converge in one object and nothing else does. When the authority’s settlement commits, the Engine delivers to exactly this Session its outcome, with rating_state at RATING_STATE_PENDING and no rating values: the authority never relays account data. Later the platform commits this player’s rating and delivers it privately through the trusted Player Host; the same object then carries rating and moves to RATING_STATE_COMMITTED. Queues without a rating stay at RATING_STATE_NONE. The object is keyed by match_id and session_id. A rating fact for another Match or Session never touches it, and a replayed or older fact is ignored: only a strictly newer SummerRatingSnapshot.version on SummerRatingChange.after is applied.

Properties

Property	Type	Access	Description
`committed_at_unix_msec`	int	read-only, `get_committed_at_unix_msec()`	Platform commit time of the rating in Unix milliseconds, or `0` while pending.
`match_id`	String	read-only, `get_match_id()`	Stable Match identifier.
`outcome`	`SummerMatchResult.Outcome`	read-only, `get_outcome()`	This player’s outcome as concluded by the authority.
`queue`	StringName	read-only, `get_queue()`	Queue the Match was played in. Empty for Worlds entered without a queue.
`rating`	`SummerRatingChange`	read-only, `get_rating()`	The committed before-and-after rating, or `null` until `rating_state` is `RATING_STATE_COMMITTED`.
`rating_state`	`SummerMatchResult.RatingState`	read-only, `get_rating_state()`	Whether a rating is expected and whether the platform has committed it.
`session_id`	String	read-only, `get_session_id()`	The Session this result belongs to.
`settlement_id`	String	read-only, `get_settlement_id()`	Settlement receipt identifier from the authority’s conclusion.

Methods

is_rating_committed

func is_rating_committed() -> bool const

Returns true once rating_state is RATING_STATE_COMMITTED. Returns: bool

Enums and constants

Outcome

Name	Value	Description
`OUTCOME_UNKNOWN`	`0`	The authority reported no outcome for this Session.
`OUTCOME_WIN`	`1`	Won.
`OUTCOME_LOSS`	`2`	Lost.
`OUTCOME_DRAW`	`3`	Drew.
`OUTCOME_ABANDON`	`4`	Abandoned the Match.

RatingState

Name	Value	Description
`RATING_STATE_NONE`	`0`	The queue carries no rating; nothing will be committed.
`RATING_STATE_PENDING`	`1`	Settlement committed; the durable account projection has not arrived yet.
`RATING_STATE_COMMITTED`	`2`	The platform committed this player’s rating for this Match.

What is live on the platform today: platform capability status. Check availability at runtime before you offer a feature.

Overview

MCP tools

HTTP API

GDScript API

Migration and extensions

MCP

Properties

Methods

is_rating_committed

Enums and constants

Outcome

RatingState

​Properties

​Methods

​is_rating_committed

​Enums and constants

​Outcome

​RatingState

Properties

Methods

is_rating_committed

Enums and constants

Outcome

RatingState