> ## Documentation Index
> Fetch the complete documentation index at: https://docs.summerengine.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SummerSession

> Immutable Player association with a Summer World.

**Class:** `SummerSession` · **Inherits:** RefCounted

Immutable Player association with a Summer World.

A Session records allocation and presence, not transport connection truth. The runtime publishes a new immutable projection for a transition; game code cannot assign Session, Player, World, peer, or entity identity.

## Properties

| Property | Type | Access | Description |
| - | - | - | - |
| <a id="local" />`local` | bool | read-only, `is_local()` | Whether this Session belongs to explicit local development. |
| <a id="player" />`player` | [`SummerPlayer`](/api-reference/gdscript/types/player) | read-only, `get_player()` | Verified or synthetic Player associated with this Session. |
| <a id="session_id" />`session_id` | String | read-only, `get_session_id()` | Control-plane Session identifier, or a visibly synthetic local identifier. |
| <a id="state" />`state` | [`SummerSession.State`](/api-reference/gdscript/types/session#state) | read-only, `get_state()` | Presence state represented by this immutable snapshot. |
| <a id="world" />`world` | [`SummerWorld`](/api-reference/gdscript/types/world) | read-only, `get_world()` | World associated with this Session. |

## Enums and constants

### State

| Name | Value | Description |
| - | - | - |
| `STATE_RESERVED` | `0` | Allocation exists but admission is incomplete. |
| `STATE_CONNECTED` | `1` | Admission and compatibility completed. |
| `STATE_DISCONNECTED` | `2` | The transport disconnected while the association remains relevant. |
| `STATE_ENDED` | `3` | The association ended. |

***

What is live on the platform today: [platform capability status](/knowledge-base/source-status). Check availability at runtime before you offer a feature.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.