# ink.igav.galaxius.temp.join

> Published by [galaxius-gm.igav.ink](https://lexicon.garden/identity/did:plc:whg4cehv5lzx6yorjkwzbk56)

✓ This is the authoritative definition for this NSID.

## Description

A player joining a Galaxius game: who they are and the session key their orders are signed with.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:whg4cehv5lzx6yorjkwzbk56/ink.igav.galaxius.temp.join)
- [Documentation](https://lexicon.garden/lexicon/did:plc:whg4cehv5lzx6yorjkwzbk56/ink.igav.galaxius.temp.join/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:whg4cehv5lzx6yorjkwzbk56/ink.igav.galaxius.temp.join/examples)

## Definitions

### `ink.igav.galaxius.temp.join`

**Type**: `record`

A player's join record, written to the player's own repo; the game's whole write footprint there.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `agent` | `string` | No | Whether a human or an account bot is playing; absent means human. |
| `colour` | `string` | No | The player's preferred colour; the game master chooses the seat's actual colour. |
| `createdAt` | `string` (datetime) | Yes | When the join record was written. |
| `game` | `ref` → `com.atproto.repo.strongRef` | Yes | A strongRef to the game being joined. |
| `sessionKey` | `string` | Yes | The player's Ed25519 public key as a did:key multikey; every live order is signed with it. |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "A player's join record, written to the player's own repo; the game's whole write footprint there.",
      "key": "tid",
      "record": {
        "properties": {
          "agent": {
            "description": "Whether a human or an account bot is playing; absent means human.",
            "knownValues": [
              "human",
              "bot"
            ],
            "maxGraphemes": 16,
            "type": "string"
          },
          "colour": {
            "description": "The player's preferred colour; the game master chooses the seat's actual colour.",
            "maxGraphemes": 32,
            "type": "string"
          },
          "createdAt": {
            "description": "When the join record was written.",
            "format": "datetime",
            "type": "string"
          },
          "game": {
            "description": "A strongRef to the game being joined.",
            "ref": "com.atproto.repo.strongRef",
            "type": "ref"
          },
          "sessionKey": {
            "description": "The player's Ed25519 public key as a did:key multikey; every live order is signed with it.",
            "maxLength": 128,
            "type": "string"
          }
        },
        "required": [
          "game",
          "sessionKey",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "description": "A player joining a Galaxius game: who they are and the session key their orders are signed with.",
  "id": "ink.igav.galaxius.temp.join",
  "lexicon": 1
}
```