Summer.authority.match

Class: SummerAuthorityMatch · Inherits: RefCounted · Access: Summer.authority.match Typed authoritative Match operations. Authority-only facade for Match settlement and lifecycle operations. It resolves the trusted World binding internally; game code supplies immutable SummerSession capabilities and never peer IDs, supervisor routes, credentials, or runtime-role checks.

Methods

complete_delivery

func complete_delivery() -> SummerMatchDeliveryCompletionOperation

Finalizes the current persistent or multi-Match delivery phase after every required delivery plan is terminal. Match-bound Sessions end, World-bound Sessions remain admitted, and the World returns to serving. Match-scoped Worlds use Summer.authority.world.complete(). Returns: SummerMatchDeliveryCompletionOperation Returns at once. Wait for the result with var result: SummerResult = await op.get_result_or_completed_signal(); see SummerOperation.

conclude

func conclude(outcomes: Dictionary[SummerSession, SummerAuthorityMatch.MatchOutcome], reason: String = "match_complete", rating_deltas: Dictionary[SummerSession, int] = {}) -> SummerMatchConclusionOperation

Commits one exact outcome for every trusted outcome-eligible participant and returns the typed durable settlement. Spectators, ineligible participants, raw identifiers, forged same-ID Sessions, and divergent retries are rejected. rating_deltas reports the game’s own rating movement for each player, within ±1000, on a queue declared with "ratingSystemRef": "authority_v1"; see SummerAuthorityRatings. Such a queue requires a delta for every participant, and every other queue rejects any delta: the platform refuses the result with invalid_request and nothing is committed, so the authority may conclude again with corrected arguments. Keys must be Sessions named in outcomes. On a queue that declares teams, the platform scores the sides matchmaking formed from each player’s SummerParticipant.team; the outcomes name players, never teams. Give every member of one team the same outcome.

Parameter	Type	Default
`outcomes`	Dictionary[`SummerSession`, `SummerAuthorityMatch.MatchOutcome`]	required
`reason`	String	`"match_complete"`
`rating_deltas`	Dictionary[`SummerSession`, int]	`{}`

Returns: SummerMatchConclusionOperation Returns at once. Wait for the result with var result: SummerResult = await op.get_result_or_completed_signal(); see SummerOperation.

get_participant

func get_participant(session: SummerSession) -> SummerParticipant const

Returns the verified participant for a Session this authority admitted: its role, outcome eligibility, Session lifetime and team. Returns null for any other Session object, including a copy with the same ID.

func _on_session_joined(session: SummerSession) -> void:
var participant := Summer.authority.match.get_participant(session)
if participant and participant.team >= 0:
spawn_on_side(session, participant.team)

Parameter	Type	Default
`session`	`SummerSession`	required

Returns: SummerParticipant

Enums and constants

MatchOutcome

Name	Value	Description
`MATCH_OUTCOME_WIN`	`0`	The participant won.
`MATCH_OUTCOME_LOSS`	`1`	The participant lost.
`MATCH_OUTCOME_DRAW`	`2`	The participant drew.
`MATCH_OUTCOME_ABANDON`	`3`	The participant abandoned the 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

Methods

complete_delivery

conclude

get_participant

Enums and constants

MatchOutcome

​Methods

​complete_delivery

​conclude

​get_participant

​Enums and constants

​MatchOutcome

Methods

complete_delivery

conclude

get_participant

Enums and constants

MatchOutcome