> For the complete documentation index, see [llms.txt](https://docs.candy-smith.com/main/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.candy-smith.com/main/match-3-kit-home-design/debugging-tools/replay-system.md).

# Replay System

Use **GAMEPLAY\_REPLAY** in Projects Settings->Player->Scripting Define symbols to enable this mode 

The project includes an internal replay system for debugging, QA, and regression testing.

### What it records

A replay session stores:

* Level number
* Seed
* Initial field states
* Player moves
* Bonus activations
* Action timing

### Enable it

Add the `GAMEPLAY_REPLAY` scripting define symbol in Unity:

`Project Settings > Player > Scripting Define Symbols`

Without this define, replay recording and playback are disabled.

### Hotkeys

* `F4` - Save replay to `Assets/Tests/Resources/Replays`
* `F5` - Save replay to `Application.persistentDataPath/gameplay_replay.json`
* `F6` - Load and play the last saved replay

### How to use

1. Start a level.
2. Play normally.
3. Save the session with `F5`.
4. Press `F6` to load and replay it.

In the Unity Editor, `F4` saves the replay into the project so it can be used in tests.

### Notes

Replay playback recreates the level using the saved seed and initial board state, then replays the recorded actions in order.