# Configuration Recap's settings live in `plugins/Recap/config.yml`. Every setting is optional. Leave one out and Recap uses the default. ## Recording | Setting | Default | What it does | |---|---|---| | `recording.max-duration` | `0` | Longest a recording may run, in ticks (20 ticks is a second). `0` means no limit. Worth setting if you're worried about someone starting a recording and forgetting about it. | | `recording.capture-radius` | `16` | How far around the player Recap captures the scenery and nearby mobs, in blocks. This is what lets a recording replay correctly somewhere else. `0` records the player only. You can override it per recording with `--radius`. Maximum 128. | | `recording.memory-threshold` | `80` | If the server's memory use passes this percentage, Recap stops every recording to protect the server. `0` turns the safety net off. | ## Playback | Setting | Default | What it does | |---|---|---| | `playback.view-distance` | `64` | How close a player has to be, in blocks, to see the NPCs. `0` shows them to everyone no matter how far away. | | `playback.loop` | `false` | Whether `/recap play` loops when you don't say either way. | ## Storage | Setting | Default | What it does | |---|---|---| | `storage.directory` | `recordings` | The folder inside `plugins/Recap/` where recordings are kept. World snapshots go here too. | ## A full example ```yaml version: 1 recording: max-duration: 0 capture-radius: 16 memory-threshold: 80 playback: view-distance: 64 loop: false storage: directory: recordings ``` ## Common changes **Recording a big arena?** Raise `capture-radius` to 24 or 32 so the whole space comes along with the recording. **Only ever recording players, never scenery?** Set `capture-radius: 0`. Recordings get much smaller. **Want everyone on the server to see a replay, wherever they are?** Set `playback.view-distance: 0`.