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

> Trusted reads and versioned writes for Game-scoped rankings.

**Class:** `SummerAuthorityRankings` · **Inherits:** RefCounted · **Access:** `Summer.authority.rankings`

Trusted reads and versioned writes for Game-scoped rankings.

The current World authority can read and compare-and-set a score by stable player ID without a matchmaking Session. A write uses the version returned by [`get_score()`](/api-reference/gdscript/authority/rankings#get_score). On a version conflict, read and recompute. After a transport failure, read to determine whether the write committed before making another decision. Game code never handles the Supervisor credential.

## Methods

### get\_score

```gdscript theme={null}
func get_score(ranking: String, player_id: String) -> SummerRankingOperation
```

Reads one player's score. The operation carries [`SummerRankingOperation.rating`](/api-reference/gdscript/types/ranking-operation#rating) with value, games and version.

| Parameter | Type | Default |
| - | - | - |
| `ranking` | String | required |
| `player_id` | String | required |

**Returns:** [`SummerRankingOperation`](/api-reference/gdscript/types/ranking-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).

### leaderboard

```gdscript theme={null}
func leaderboard(ranking: String) -> SummerRankingLeaderboardOperation
```

Reads the ranking's public top 50 rows. No row is marked as the authority's player.

| Parameter | Type | Default |
| - | - | - |
| `ranking` | String | required |

**Returns:** [`SummerRankingLeaderboardOperation`](/api-reference/gdscript/types/ranking-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).

### set\_score

```gdscript theme={null}
func set_score(ranking: String, player_id: String, expected_version: int, value: int, games: int) -> SummerRankingOperation
```

Compares `expected_version` and sets the absolute `value` and `games` atomically. A missing score has version zero. Values are bounded to ±1000000000000, games to 2147483647, and versions to safe integers. The expected version must be below 9007199254740991 so the next version remains representable. The Engine does not automatically retry a write.

| Parameter | Type | Default |
| - | - | - |
| `ranking` | String | required |
| `player_id` | String | required |
| `expected_version` | int | required |
| `value` | int | required |
| `games` | int | required |

**Returns:** [`SummerRankingOperation`](/api-reference/gdscript/types/ranking-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).

***

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.