# Commands Everything runs through `/recap`, or `/re` if you prefer typing less. You'll need the `recap.admin` permission. ## Recording Give the recording a name you'll recognise later: ``` /recap start finals-round-3 ``` That records you. To record other people, add a target: ``` /recap start finals-round-3 @a ``` Everyone online gets their own recording, named after them (`finals-round-3_Steve`, `finals-round-3_Alex`, and so on). When the match is over: ``` /recap stop ``` That saves it and tells you what it was called. If you started a group, one `/recap stop` ends the whole batch and lists everything it saved. Changed your mind? `/recap cancel` throws the recording away instead of saving it. `/recap stopall` and `/recap cancelall` do the same for everyone currently recording, which is handy at the end of an event. ### Sending recordings straight into a scene If you already know the recordings belong together, name a scene up front and Recap files them for you as each one stops: ``` /recap start big-battle @a --scene arena-replay ``` The scene has to exist first. `-s` is the short version. ### Capturing the ground too By default Recap grabs the blocks around the player, so the recording still looks right when you replay it somewhere else. 16 blocks out, unless you say otherwise: ``` /recap start arena-take @a --radius 32 ``` Use `--radius 0` if you only want the player and nothing around them. The maximum is 128. ### Capturing redstone and pistons Blocks that move on their own aren't recorded unless you ask: ``` /recap start contraption --environment ``` That picks up pistons, dust, lamps, repeaters, comparators and observers near the player. For something big and fast, add `--uncapped` to stop Recap limiting how many block changes it records per tick. Flags combine in any order: ``` /recap start 300-fight @a --radius 32 -s big-battle ``` ## Playing it back ``` /recap play finals-round-3 ``` The players reappear where they were recorded and act out exactly what they did. Play a scene the same way, by name. Add `true` to loop: ``` /recap play spawn-ambience true ``` Every recording in the scene loops on its own, so short clips don't leave the place empty while longer ones finish. While something is playing you get: ``` /recap pause /recap resume /recap seek 30 jump to 30 seconds in /recap speed 0.5 half speed, good for watching a single hit ``` These apply to whichever playback is nearest you, so you don't need to name a session. To stop: `/recap stop` ends the closest playback if you aren't recording or hijacking anything. `/recap stopall` ends every playback at once. On a big scene you'll see `Loading scene 'X'…` first and `Now playing 'X' (12 actors)` once everyone is ready. ### Saved recordings ``` /recap recordings list /recap recordings delete finals-round-3 ``` ## Scenes A scene is several recordings played together, each with its own start time and position. Scene names always begin with a dot, and Recap adds it for you. ``` /recap scene create arena-replay /recap scene arena-replay add finals-round-3_Steve /recap scene arena-replay add finals-round-3_Alex /recap scene arena-replay play ``` The rest: | Command | What it does | |---|---| | `/recap scene list` | Every scene you have | | `/recap scene <name> list` | What's inside one scene | | `/recap scene <name> play [loop]` | Play it where you're standing | | `/recap scene <name> add <recording or scene>` | Add a recording, or another scene | | `/recap scene <name> remove <recording or scene>` | Take something out | | `/recap scene delete <name>` | Delete the scene | A scene can contain other scenes, so you can build a big performance out of smaller ones. ## Fighting a recording (hijack) A hijack turns a scene's NPCs into things you can actually fight: ``` /recap hijack arena-replay ``` They fight the way the recorded player did, and drop their inventory when they die. Your side of the fight is recorded too. Bring everyone in: ``` /recap hijack arena-replay @a ``` Each person gets their own recording of the fight. When you're done, `/recap stop` saves it. `/recap cancel` ends the hijack and keeps nothing. ### Keeping the original scene intact By default, hijacking edits that scene: any NPC you fought is replaced by the version that fought back. If you'd rather leave the original alone: ``` /recap hijack arena-replay --new arena-replay-fought ``` ### Ending it automatically ``` /recap hijack arena-replay --stop-on-end ``` The hijack finishes by itself the moment the scene's last recording runs out, saving exactly as if you'd typed `/recap stop`. `--soe` is the short form, and it works alongside `--new`. ### Undoing a hijack ``` /recap revert ``` That puts the scene back the way it was before the last hijack. Add `--maintain` to keep the fight recording on disk and only undo the scene itself. ## World snapshots If a recording captured the blocks around it, you can put the world back the way it was for yourself: ``` /recap world apply finals-round-3 /recap world restore ``` `apply` paints the recorded blocks over what's there now, and only you see it. `restore` puts it back. ## Checking the version ``` /recap version ``` Tells you which build you're on, whether voice capture is available, and whether your licence checked out.