> 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/documentation/guides/leaderboards-and-bedwars.md).

# Leaderboards and Bedwars

Zumo publishes these events to Zed (`botId: "zumo"`, often `mode: "stats"` for leaderboards). Subscribe on `/` like any other consumer event.

## Leaderboard

| Event               | Category               | Meaning                               |
| ------------------- | ---------------------- | ------------------------------------- |
| `temporaryLbChange` | `temporaryLeaderboard` | Temporary leaderboard position change |
| `lifetimeLbChange`  | `lifetimeLeaderboard`  | Lifetime leaderboard change           |
| `lbBan`             | `ban`                  | Removed from all boards in a mode     |

## Bedwars

| Event                | Category  | Meaning          |
| -------------------- | --------- | ---------------- |
| `bwStatsChanges`     | `bedwars` | Stats deltas     |
| `bwCosmeticsChanges` | `bedwars` | Cosmetics deltas |
| `bwParty`            | `bedwars` | Party status     |

## Example

```js
socket.on('temporaryLbChange', (data) => {
  console.log(data.uuid, data.oldPos, '→', data.newPos, data.path);
});

socket.on('bwStatsChanges', (data) => {
  console.log(data.player, data.changes);
});
```

Grant these names on the key’s **consume** ACL. Schemas: [Zumo-published events](https://app.gitbook.com/s/M9ty6FYa3j98VSBHF9LN/ws/zumo/temporary-lb-change).