# games.cavu.tier-madness.game

> Published by [chris.pardy.family](https://lexicon.garden/identity/did:plc:dp7v5b5kejmmzzpwmqyf5wj6)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:dp7v5b5kejmmzzpwmqyf5wj6/games.cavu.tier-madness.game)
- [Documentation](https://lexicon.garden/lexicon/did:plc:dp7v5b5kejmmzzpwmqyf5wj6/games.cavu.tier-madness.game/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:dp7v5b5kejmmzzpwmqyf5wj6/games.cavu.tier-madness.game/examples)

## Definitions

### `games.cavu.tier-madness.game`

**Type**: `record`

Declares a game: the roster in seat order and the ballot. Written by the host player, from their own PDS, to the game's commitment space (rkey = game id). With each player's round records and moves it is enough to replay the game: replay checks every player's records agree.

**Key**: `any`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `ballot` | `array` | Yes | Categories offered in the pre-game vote. |
| `createdAt` | `string` (datetime) | Yes |  |
| `game` | `string` | Yes |  |
| `host` | `string` (did) | No | The player who started the game. |
| `players` | `array` | Yes | In seat order; the criteria picker goes round this circle. |
| `scale` | `ref` → `games.cavu.tier-madness.defs#scale` | Yes | The tier list's scale: an ordinal scale, S highest. Every placement's value is on it. |
| `totalRounds` | `integer` | Yes |  |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "Declares a game: the roster in seat order and the ballot. Written by the host player, from their own PDS, to the game's commitment space (rkey = game id). With each player's round records and moves it is enough to replay the game: replay checks every player's records agree.",
      "key": "any",
      "record": {
        "properties": {
          "ballot": {
            "description": "Categories offered in the pre-game vote.",
            "items": {
              "maxLength": 300,
              "type": "string"
            },
            "maxLength": 20,
            "minLength": 1,
            "type": "array"
          },
          "createdAt": {
            "format": "datetime",
            "type": "string"
          },
          "game": {
            "maxLength": 64,
            "type": "string"
          },
          "host": {
            "description": "The player who started the game.",
            "format": "did",
            "type": "string"
          },
          "players": {
            "description": "In seat order; the criteria picker goes round this circle.",
            "items": {
              "ref": "games.cavu.tier-madness.defs#gamePlayer",
              "type": "ref"
            },
            "maxLength": 12,
            "minLength": 1,
            "type": "array"
          },
          "scale": {
            "description": "The tier list's scale: an ordinal scale, S highest. Every placement's value is on it.",
            "ref": "games.cavu.tier-madness.defs#scale",
            "type": "ref"
          },
          "totalRounds": {
            "maximum": 20,
            "minimum": 1,
            "type": "integer"
          }
        },
        "required": [
          "game",
          "players",
          "totalRounds",
          "ballot",
          "scale",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "id": "games.cavu.tier-madness.game",
  "lexicon": 1
}
```