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

# chat

A player typed a chat message (not system messages).

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

| Field      | Type           | Description               |
| ---------- | -------------- | ------------------------- |
| `username` | string         | Author                    |
| `uuid`     | string \| null | Author UUID               |
| `prefix`   | string         | Rank prefix; `""` if none |
| `message`  | string         | Text without prefix       |
| `color`    | string \| null | Minecraft color name      |
| `star`     | boolean        | MVP+ star present         |

## Example

```json
{
  "botId": "duels-1",
  "mode": "duels",
  "lobbyId": 1,
  "timestamp": 1713500005,
  "username": "Steve",
  "prefix": "[MVP+]",
  "message": "gg",
  "color": "white",
  "star": true
}
```
