> For the complete documentation index, see [llms.txt](https://zumo.fusion.ac/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://zumo.fusion.ac/api-reference/lobby-events/game-join.md).

# gameJoin

Bot periodic game-join cycle lifecycle.

Plus [envelope](/api-reference/websocket/envelope.md) fields.

| Field     | Type   | Description                                                              |
| --------- | ------ | ------------------------------------------------------------------------ |
| `action`  | string | `attempting_join` \| `game_started` \| `timeout` \| `returning_to_lobby` |
| `command` | string | Present when attempting join                                             |
| `message` | string | Present when game started                                                |
| `reason`  | string | Present on timeout                                                       |

## Example

```json
{
  "botId": "duels-1",
  "mode": "duels",
  "lobbyId": 1,
  "timestamp": 1713500100,
  "action": "attempting_join",
  "command": "/play duels_classic_duel"
}
```