# Scenes A scene is a group of recordings that play together. Each one can start at a different moment and stand in a different spot, which is what lets you stage a whole battle, a parade, or a cinematic out of clips recorded separately. ## Making one ``` /recap scene create arena-replay ``` Scene names always start with a dot, and Recap adds it for you (`arena-replay` becomes `.arena-replay`). That's just so scene names and recording names never get mixed up in tab-complete. ## Putting recordings in it ``` /recap scene arena-replay add finals-round-3_Steve /recap scene arena-replay add finals-round-3_Alex ``` To see what's in there, or get rid of something: ``` /recap scene arena-replay list /recap scene arena-replay remove finals-round-3_Alex /recap scene list ``` ## Playing it ``` /recap scene arena-replay play /recap play arena-replay ``` Both do the same thing. Add `true` to either one to loop it. In a scene each recording loops on its own, so a short clip doesn't leave a gap while a longer one is still running. You can't start the same scene twice at once. Stop the first one, or let it finish. ## Timing and positioning By default everything starts together, exactly where it was recorded. To stagger things or move them around, edit the scene file at `plugins/Recap/scenes/<name>.json`: ```json { "name": ".arena-replay", "entries": [ { "recording": "warrior-run", "delay": 0, "ox": 0, "oy": 0, "oz": 0 }, { "recording": "archer-volley", "delay": 40, "ox": 4, "oy": 0, "oz": -2 } ] } ``` `delay` is in ticks, so 40 means the archer starts two seconds after the warrior. `ox`, `oy` and `oz` shift that recording by that many blocks on each axis. ## Scenes inside scenes A scene can contain another scene, which is handy when you have a piece you want to reuse: ``` /recap scene parent-battle add .guards-patrol ``` Now `parent-battle` plays everything in `guards-patrol` plus whatever else you added directly. You can nest as deep as you like, and Recap won't let a scene end up containing itself. ## Filling a scene automatically If you know up front that a group of recordings belongs together, say so when you start: ``` /recap start big-fight @a --scene arena-replay ``` Each person's recording joins the scene the moment it stops. The scene has to exist already. ## What happens when you hijack a scene Fighting a scene changes it. Any NPC you actually hit gets replaced by a version that reacted to you, and your own run through the fight gets added to the scene as well. Your run is marked so it plays back normally but can't be fought. That matters if you hijack the same scene again: your previous laps show up as ghosts you can watch alongside the live one, rather than as extra targets dropping duplicate loot. See [[Recap/Server Owners/Features/Hijack]]. ## See Also - [[Recap/Server Owners/Features/Recording]] - [[Recap/Server Owners/Features/Playback]] - [[Recap/Server Owners/Features/Hijack]]