Summer.client

Class: SummerClient · Inherits: RefCounted Role-scoped client SDK root. This root exists only for a client execution context. Its identity remains stable while immutable context projections advance after admission or reconnect; authority operations are never attached.

Services

Property	Class	What it does
`channels`	`SummerClientChannels`	Player chat channels bound to the current admitted World.
`analytics`	`SummerClientAnalytics`	Captures creator game events through the private Player Host.
`context`	`SummerClientContext`	Immutable client projection context.
`friends`	`SummerClientFriends`	The player’s Summer friends as this Game may see them.
`items`	`SummerClientItems`	Read-only revisioned inventory projection for the current player.
`matchmaking`	`SummerClientMatchmaking`	Hosted placement availability.
`messages`	`SummerClientMessages`	The player’s Summer direct messages, behind the player’s per-Game consent.
`party`	`SummerClientParty`	The player’s Summer party as this Game sees it.
`player_data`	`SummerClientPlayerData`	Read-only view of this player’s own public player data.
`ratings`	`SummerClientRatings`	This player’s own match results and committed account ratings.
`rankings`	`SummerClientRankings`	This player’s Game-scoped ranking scores.
`store`	`SummerClientStore`	Browse the current Game store and request trusted checkout.

Properties

Property	Type	Access	Description
`channels`	`SummerClientChannels`	read-only, `get_channels()`	Chat for the authenticated player’s current admitted World. The Player Host determines admission and visibility.
`analytics`	`SummerClientAnalytics`	read-only, `get_analytics()`	Captures creator observations through the private Host.
`context`	`SummerClientContext`	read-only, `get_context()`	Verified immutable client context.
`friends`	`SummerClientFriends`	read-only, `get_friends()`	The player’s Summer friends and whether they are online or in this Game, with the player’s consent, and the Summer app’s friends, profile and chat overlays.
`items`	`SummerClientItems`	read-only, `get_items()`	Read-only revisioned platform inventory projection for the current player.
`matchmaking`	`SummerClientMatchmaking`	read-only, `get_matchmaking()`	Hosted placement availability. Matchmaking itself is entered through `join` with `SummerJoinTarget.queue`.
`messages`	`SummerClientMessages`	read-only, `get_messages()`	The player’s Summer direct messages with their friends, behind the player’s per-Game messaging permissions.
`party`	`SummerClientParty`	read-only, `get_party()`	The player’s Summer party as this Game sees it: members, leader, who has this Game open, shared Game data and the party’s search. Bring the party into a match with `SummerJoinTarget.party_queue`.
`player_data`	`SummerClientPlayerData`	read-only, `get_player_data()`	Read-only view of this player’s own public player data, written by the Game’s hosted authority.
`ratings`	`SummerClientRatings`	read-only, `get_ratings()`	This player’s own match results and committed account ratings, converged from the authority’s outcome and the platform’s private projection. Authority code never relays ratings; they only arrive here.
`rankings`	`SummerClientRankings`	read-only, `get_rankings()`	Reads this player’s Game-scoped ranking scores and public leaderboard independently of matchmaking.
`store`	`SummerClientStore`	read-only, `get_store()`	Quote-bound platform store facade.

Methods

join

func join(target: SummerJoinTarget) -> SummerJoinOperation

The one way into a World. The target names the placement provider (matchmaking queue, direct World, invite, follow, portal, resume, or local fixture); every provider returns the same SummerJoinOperation with the same progress, typed failures, SummerJoinOperation.world and SummerJoinOperation.session. Only a queue target can emit SummerJoinOperation.acceptance_required. After a hosted connection is lost, a new queue or World join first awaits confirmed removal of the previous Session, then starts the requested placement within the original join deadline. Canceling that pending join stops the new placement but does not undo the durable Session cleanup.

var op := Summer.client.join(SummerJoinTarget.world(world_id))
var joined: SummerResult = await op.get_result_or_completed_signal()
if joined.ok:
    enter_gameplay_with(op.world, op.session)

A provider this runtime cannot reach yet fails typed with unsupported_placement.

Parameter	Type	Default
`target`	`SummerJoinTarget`	required

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

leave

func leave() -> SummerOperation

Leaves the current World, or abandons a join still in flight, and clears the client transport. During hosted matchmaking, await the returned operation before exiting the client. Success means the Player Host acknowledged cancellation or reported that the ticket was already terminal, including when ticket creation was still in flight. A Host failure or request deadline returns a failure; it does not prove the ticket was cancelled. Repeated calls share the pending leave and preserve its result until another join starts. Leaving an established hosted World closes its local connection promptly, then succeeds only when the Player Host confirms removal of the exact Session through its authenticated completion event or a bounded recovery read. If proof is still unknown at the leave deadline, the result is retryable and retains that Session identity for retry. A local fixture World only clears its local connection. Calling SummerOperation.cancel() on a join only cancels that local operation; use leave() to await hosted cleanup. Returns: SummerOperation Returns at once. Wait for the result with var result: SummerResult = await op.get_result_or_completed_signal(); see SummerOperation.

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

Services

Properties

Methods

join

leave

​Services

​Properties

​Methods

​join

​leave

Services

Properties

Methods

join

leave