> 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/player-joined.md).

# playerJoined

A player entered the lobby.

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

| Field      | Type           | Description           |
| ---------- | -------------- | --------------------- |
| `username` | string         | Minecraft username    |
| `uuid`     | string \| null | Player UUID if known  |
| `prefix`   | string \| null | Tab-list rank prefix  |
| `suffix`   | string \| null | Tab-list guild suffix |

Emitted after up to 10s wait for scoreboard team data. Fake leaves near NPCs are suppressed.

## Example

```json
{
  "botId": "duels-1",
  "mode": "duels",
  "lobbyId": 1,
  "timestamp": 1713500000,
  "username": "Steve",
  "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "prefix": "§6[MVP§0++§6]",
  "suffix": "§3[OASIS]"
}
```