> ## 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.

# Summer.client.ratings

> This player's own match results and committed account ratings.

**Class:** `SummerClientRatings` · **Inherits:** RefCounted · **Access:** `Summer.client.ratings`

This player's own match results and committed account ratings.

Two facts converge here and game code never has to relay either. When the authority concludes a Match, the Engine delivers this Session's outcome as a [`SummerMatchResult`](/api-reference/gdscript/types/match-result) with a pending rating and emits [`match_result`](/api-reference/gdscript/client/ratings#match_result). When the platform commits the rating, the trusted Player Host delivers it privately to this player alone; the same result moves to committed and [`rating_committed`](/api-reference/gdscript/client/ratings#rating_committed) fires. Stale or replayed facts never overwrite newer state, and no other player's result or rating is ever visible here.
Recovery after a missed delivery is [`refresh()`](/api-reference/gdscript/client/ratings#refresh), a bounded read through the Player Host of the same `value`, `games`, `version` triple. Game code never calls the platform directly.

## Properties

| Property | Type | Access | Description |
| - | - | - | - |
| <a id="last_result" />`last_result` | [`SummerMatchResult`](/api-reference/gdscript/types/match-result) | read-only, `get_last_result()` | The most recent result for this player, or `null`. |
| <a id="results" />`results` | [`SummerMatchResult`](/api-reference/gdscript/types/match-result)\[] | read-only, `get_results()` | Recent results for this player, oldest first, bounded. |

## Methods

### get\_current

```gdscript theme={null}
func get_current(queue: StringName) -> SummerRatingSnapshot const
```

The latest committed rating for `queue`, or `null` until one is known.

| Parameter | Type | Default |
| - | - | - |
| `queue` | StringName | required |

**Returns:** [`SummerRatingSnapshot`](/api-reference/gdscript/types/rating-snapshot)

### leaderboard

```gdscript theme={null}
func leaderboard(queue: StringName) -> SummerLeaderboardOperation
```

Reads `queue`'s 50 highest-rated players by display name through the Player Host; [`SummerLeaderboardEntry.you`](/api-reference/gdscript/types/leaderboard-entry#you) marks the caller's own row. Only the Host's own queue can be read. One read is in flight at a time; a second call for the same queue returns the pending operation.

| Parameter | Type | Default |
| - | - | - |
| `queue` | StringName | required |

**Returns:** [`SummerLeaderboardOperation`](/api-reference/gdscript/types/leaderboard-operation)

Returns at once. Wait for the result with `var result: SummerResult = await op.get_result_or_completed_signal()`; see [SummerOperation](/api-reference/gdscript/types/operation).

### refresh

```gdscript theme={null}
func refresh(queue: StringName) -> SummerOperation
```

Reads the committed rating for `queue` through the Player Host. Only a strictly newer version replaces the held one. One read is in flight at a time; a second call while pending returns the same operation. Fails typed with `invalid_argument` for an empty queue or `unavailable` (retryable) when the Player Host cannot be reached.

| Parameter | Type | Default |
| - | - | - |
| `queue` | StringName | required |

**Returns:** [`SummerOperation`](/api-reference/gdscript/types/operation)

Returns at once. Wait for the result with `var result: SummerResult = await op.get_result_or_completed_signal()`; see [SummerOperation](/api-reference/gdscript/types/operation).

### standing

```gdscript theme={null}
func standing(queue: StringName) -> SummerStandingOperation
```

Reads the caller's own place in `queue` through the Player Host: their rating, how many players are rated, their percentile once rated, and their leaderboard rank when it is within the top 1000. One read is in flight at a time; a second call for the same queue returns the pending operation.

| Parameter | Type | Default |
| - | - | - |
| `queue` | StringName | required |

**Returns:** [`SummerStandingOperation`](/api-reference/gdscript/types/standing-operation)

Returns at once. Wait for the result with `var result: SummerResult = await op.get_result_or_completed_signal()`; see [SummerOperation](/api-reference/gdscript/types/operation).

## Signals

### match\_result

```gdscript theme={null}
signal match_result(result: SummerMatchResult)
```

The authority concluded a Match this player took part in. [`SummerMatchResult.rating_state`](/api-reference/gdscript/types/match-result#rating_state) is pending or none; no rating values are present yet.

### rating\_changed

```gdscript theme={null}
signal rating_changed(queue: StringName)
```

The current rating for `queue` advanced, through a commit, a platform snapshot, or [`refresh()`](/api-reference/gdscript/client/ratings#refresh).

### rating\_committed

```gdscript theme={null}
signal rating_committed(result: SummerMatchResult)
```

The platform committed this player's rating for the Match in `result`; [`SummerMatchResult.rating`](/api-reference/gdscript/types/match-result#rating) is now set.

***

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.