# Configuration
Recap's `config.yml` lives at `plugins/Recap/config.yml`. All keys are optional — defaults are used if a key is missing.
---
## Recording
| Key | Default | Description |
|---|---|---|
| `recording.max-duration` | `0` | Max recording length in ticks (0 = unlimited). |
| `recording.capture-radius` | `16` | Default surroundings radius (blocks) captured around the player: nearby mobs and a geometry snapshot cube. Also scopes how far `--environment` records world block changes. `0` = player-only. Override per-recording with `--radius <n>` (e.g. `--radius 0` to disable). Max 128. |
| `recording.memory-threshold` | `80` | Auto-stop every recorder when JVM memory usage crosses this percent. Set to `0` to disable. |
---
## Playback
| Key | Default | Description |
|---|---|---|
| `playback.view-distance` | `64` | Distance (blocks) within which viewers see NPC packets. `0` = unlimited. |
| `playback.loop` | `false` | Default loop behaviour for `/recap play` when no flag is passed. |
---
## Storage
| Key | Default | Description |
|---|---|---|
| `storage.directory` | `recordings` | Subdirectory of the plugin data folder where `.recap` files live. World-snapshot files (`.rwsnap`) also land here. |
---
## Sample
```yaml
version: 1
recording:
max-duration: 0
capture-radius: 16
memory-threshold: 80
playback:
view-distance: 64
loop: false
storage:
directory: recordings
```