---
name: scenario-unreal-cinematics
description: 'Use when making a trailer, cutscene, cinematic or short film in Unreal Engine 5.8 with Sequencer: shot lists, master and shot sequences, cameras, lenses, depth of field, camera cuts, spawnables, character animation in shots, per-shot lighting, Movie Render Graph or Movie Render Queue EXR renders, "render darker than the viewport", "first frames pop", "last frame missing", ACES or OCIO to DaVinci Resolve, the 180-degree rule, Sequencer Python, or reviewing a cut.'
license: MIT
---

# Cinematics in Unreal Engine 5.8 (Sequencer and Movie Render Graph)

Expert level here means the cut is checked as data before anything is built and a render is judged on its files and frames, not the viewport. The core stance: plan offline, build in one transaction, lock timing against the music before animating, light from approved masters, render per shot through one template graph, hand linear EXRs, an edit and a color note to the grade. If a sibling skill named here is missing from your available skills, ask the user to install it (`npx skills add scenario-labs/skills --skill <name>`); unattended, proceed from tool schemas and flag the gap.

**REQUIRED BACKGROUND:** scenario-unreal-expert (channels, review loop, 5.8 traps).

**Status (2026-09-24):** [`scripts/ue_cine.py`](scripts/ue_cine.py) and [`scripts/cine_render_callbacks.py`](scripts/cine_render_callbacks.py) are **not yet run in Unreal**; offline tests pass (counts: [`references/sources.md`](references/sources.md)). In the engine, run `tests/code/unreal-cinematics/job_00_probe_cine.py` first.

## Stance (the expert delta)

- **The master is an edit; shots own the content.** Cameras, characters and keys live in shots, per-discipline subsequences (lighting, FX) inside shots, so re-pacing moves sections, never animation (Sir Wade, ywtvn1uncZo [00:07:32]; Glitch, uzTo5vQchkk [00:35:24]). Per-shot things are spawnables, the set is possessable, so the cinematic plays in any level (yOcgYMcxr3Q [00:07:53] [00:13:50]); a possessable animated in one shot snaps back after it; Outliner visibility is not saved, Levels panel visibility is ([00:10:34] [00:02:23]). Duplicating a master shares its shots: "someone tweaks lighting, it changes seven shots" (Epic CAT, S4Iyzbl-oaE [00:41:34]); experiment with a New Take.
- **Structure is templated and scripted, never clicked together.** Display rate, start frame, bias, naming and folder template are set once in `DefaultEngine.ini` under revision control (S4Iyzbl-oaE [00:15:22] [00:21:52]); CAT 5.8 schemas nest and can give each shot its own level (VP 5SJA1FfRPWs [00:19:07] [00:20:44]). Every tool is one `ScopedEditorTransaction` around a `ScopedSlowTask`, because "long running Python codes, they look really similar to a frozen engine" (SPI, moQTQzAOFVA [00:16:16]).
- **Lock timing before animating.** Board with constant keys, music on its own track, stingers exactly on cuts; "you don't want to spend time working on frames that will never make it into the final film" (Toonen, mAMp6qCt7kc [00:15:04] [00:15:36] [00:04:55]). Retiming must carry intent: keys move with their shot, spanning subsequences are chopped and each half gets its own asset (moQTQzAOFVA [00:14:04] [00:24:19]).
- **Warm-up is three fixes, and end frames are exclusive.** Idle CPU simulation: Engine Warm Up Count above 30; temporal history: Render Warm Up; anything moving at frame one: animation and camera cut extended before the start with camera-cut warm-up, which evaluates the lead-in instead of holding frame one (tips doc; Comly/Hoffman, demystifying MRQ). A 0 to 50 range renders 0 to 49.
- **Samples buy motion blur and anti-aliasing, nothing else.** Noise goes back to its source (demystifying MRQ; Faucher, fVg5ihB8Wdc [00:09:15]). Temporal only, odd counts with Frame Center, or Blur's 24/48/64 with Frame Close (AAAhD5tEUBs [00:39:32]); AA None above 8 samples; zero console variables until a named shot problem needs one (fVg5ihB8Wdc [00:03:00]).
- **Grade outside from linear EXR, and say how to read it.** Tone curve off gives linear sRGB, about one stop darker than the viewport because UE's tone curve is "ACES flavored, but not a true ACES" (Faucher, 2Q3CybANHKE [00:04:31] [00:09:39]). Resolve's ACES Transform: tone curve on, sRGB (Linear) to sRGB Texture; off, Linear sRGB to sRGB; ACEScg (only for a vendor), ACEScg to sRGB ([00:08:30] [00:09:05]). Light and review through the viewport's OCIO Display set to that view ([00:10:28] [00:11:00]).
- **The shot is the render unit.** "The smallest unit of distributable work in Unreal Engine is a single camera cut" (MRQ command-line doc): one job per shot, one template graph, per-job variable overrides, never edits to the shared graph. Plain MRQ needs babysitting and a crash loses the shots, so unattended multi-shot renders go through a farm manager (Glitch [00:40:14]).
- **Lighting scales by process.** A temp camera light from day one; then one or two signature shots per lighting scenario, locked with the director; then per-shot `_LGT` subsequences derived from them, graded by distance from their master (Glitch [00:27:18] [00:28:51] [00:29:23] [00:31:32] [00:36:59]).

## Establish first

| Input                                         | Changes                              | Default when silent                                                                               |
| --------------------------------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------------- |
| Delivery: graded or direct                    | tone curve, format, OCIO, color note | graded: EXR 16-bit half, tone curve off                                                           |
| Production record (rate, start, bias, naming) | every sequence, EDL                  | the project's `DefaultEngine.ini`; else 24 fps, start 0 (SPI 101, CAT demo 1000: match editorial) |
| Duration, shots, music                        | layout, stingers                     | the brief; a temp track before boarding                                                           |
| Aspect and filmback                           | lens, framing                        | 16:9 Digital Film [verify mm]; 2.39 crop for scope                                                |
| Level and what exists                         | bindings                             | set possessable; cameras, characters, shot lights spawnable; master lighting in the level         |
| Cast                                          | pre-roll, cost                       | existing Animation Sequences; joints and meshes per character                                     |
| Motion per shot, shutter timing               | samples, pre-roll                    | Frame Center, odd counts                                                                          |
| Exposure                                      | continuity                           | Manual, physical camera, ISO compensates aperture changes                                         |
| Channel                                       | build, board, render                 | live editor (MCP, PythonRemote) for boards; `ue_run` or the command line for finals               |

## Workflow

`import ue_cine as C` (skill `scripts/`, with scenario-unreal-expert's `scripts/` on the path). Full code: [`references/procedures.md`](references/procedures.md).

1. **Scaffold (once per project).** Production defaults recorded once (CAT Production Setup or Project Settings) and copied into `plan["production"]`; folder template, shots in steps of 10; with CAT 5.8, shot schemas holding the `_LGT` schema, a level per shot when shots need unique set states (P2). Check the MCP SequencerTools toolset first [verify]. GATE: `C.check_production(plan)` no fail; `audit_sequence` seq.rate and seq.start.
2. **Plan the cut as data (python3).** Shots, sizes, lenses, camera and subject positions, motion, flags, cast (joints, meshes), stingers, lighting scenarios. `C.check_plan(plan)`: length, lenses, framing, 180-degree line, screen direction, jump cuts, DOF, pre-roll, exposure, cast, stingers, lighting groups (P1). GATE: no fail; every warn fixed or answered in the plan.
3. **Build in one transaction (editor).** `C.build_from_plan(plan)`: master with Shots and music, a spawnable Cine Camera per shot (lens keyed, Use Field of View for LOD on), camera cut from pre-roll to the exclusive end, pre-rolled performers, `<shot>_LGT` with the temp light (P3); never overwrites. GATE: `C.audit_sequence` no fail, `bind.override` answered; `C.empty_level_test` lists only set pieces.
4. **Board and lock the cut (latent editor).** `C.board_generator(..., preroll=True)`: first, middle, last frame per shot plus each shot's first pre-roll frame read in isolation (GUI: Evaluate Sub Sequences In Isolation); `ue_review.image_checks`, contact sheet (P4). Retime (`C.retime_shot`), takes (`C.new_take`), own tools inside `C.editor_tool` (P5). GATE: no all-white or all-black frame, the sheet and the cut with music judged, `C.ready_to_animate(plan)` passes.
5. **Performance and camera polish.** Rack focus as keyed Manual Focus Distance (P6), camera moves as base plus offset plus shake layers (P7); Accumulation DOF only on DOF-centric shots. GATE: re-board; keyed focus equals subject distance; no pop at section boundaries.
6. **Lighting (with scenario-unreal-lighting-rendering).** Temp light renders unblock everyone; `C.lighting_masters(plan)`, render only those (`render_jobs(plan, only=...)`), director approval into `plan["lighting_approved"]`; then per-shot rim and kick lights in `_LGT`, lit through the viewport OCIO Display (P7b). GATE: `C.ready_for_final_lighting(plan)`; luminance continuity and approval against the masters; `stat unit` or an Insights trace if a shot is slow.
7. **Draft render and review.** The review graph or the 5.8 Basic config; `C.review_movie_cmd` with the music (P10). GATE: `C.check_render_output`, `C.first_frame_pop`, `C.cut_flash`, then watch it with sound.
8. **Final EXR.** Template graph per P8 with the `CineWrittenFiles` Execute Script (Editor Only); `C.audit_render_settings(C.normalize_graph_snapshot(C.graph_snapshot(graph)))`; `C.render_jobs(plan, sequences=C.active_shot_paths(master, plan))`, `C.render_orchestration`, then `C.render_generator` (executor held globally) or `C.mrq_command_line` per shot (always `-notexturestreaming`) (P9). GATE: settings audit pass; `C.check_manifest`, `C.exr_checks` per sampled frame; after a crash, re-render `C.shots_to_render(...)` whole.
9. **Deliver.** EXRs per shot, `C.edl(plan)`, review MP4, `C.delivery_note(plan, settings)` (Resolve interpretation), JSON reports; notes split technical or creative, three creative rounds, then a live session (Glitch [00:32:37] [00:33:40]) (P11).

## Numbers

| Item                       | Value                                                                                                                                     | Relative to, source                                                  |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| Hierarchical bias          | root 0, +100 per level, equal values blend                                                                                                | shots doc                                                            |
| Pre-roll                   | 24 to 48 frames on cloth, hair, particles in motion                                                                                       | digest; tips doc                                                     |
| Engine Warm Up, idle cloth | more than 30 frames                                                                                                                       | tips doc                                                             |
| Temporal samples           | Frame Close: 24 base (95% of Blur's shots), 48 fast, 64 very fast; Frame Center: odd (15, 25, 49, 65; Faucher: 15 to 31 covers 95 to 98%) | AAAhD5tEUBs [00:39:32] [00:40:05]; fVg5ihB8Wdc [00:06:01] [00:10:58] |
| AA method                  | None above 8 total samples                                                                                                                | MRG image quality doc                                                |
| Warm-up sampling           | only the last 5 warm-up frames are sampled                                                                                                | 5.6 and 5.8 notes                                                    |
| Linear vs viewport         | about 1 stop darker                                                                                                                       | 2Q3CybANHKE [00:09:39]                                               |
| Review MP4 video bitrate   | fps x 2 x 1000 kb/s (48,000 at 24 fps)                                                                                                    | 2Q3CybANHKE [00:22:54]                                               |
| Characters                 | under 200 joints                                                                                                                          | Glitch [00:05:33]                                                    |
| Master lighting            | 10 to 13 per 400-shot episode, 1 to 2 days each                                                                                           | Glitch [00:28:51]                                                    |

## Quality gates

- **Measurable:** `check_plan`, `ready_to_animate`, `ready_for_final_lighting` and `audit_sequence` without fail; `audit_render_settings` without fail or unanswered warn; frame counts with exclusive ends (`check_render_output`, `check_manifest`); EXR half, no NaN or Inf, not black, values above 1.0 in bright shots when linear, metadata present; `first_frame_pop` and `cut_flash` false; luminance jumps only where intended.
- **Visual:** contact sheets, isolated pre-roll frames, first frames, every cut, DOF edges on hair and occluders, fastest motion blur, lighting against the masters through the grade's OCIO view, the cut with music.

## Common mistakes

| Mistake                                                    | What it looks like                    | Fix                                                                     |
| ---------------------------------------------------------- | ------------------------------------- | ----------------------------------------------------------------------- |
| Duplicating the master to experiment                       | a change leaks into the "backup"      | New Take (`new_take`) inside the shot                                   |
| Characters and cameras possessable                         | breaks in another map                 | spawnables; `empty_level_test`                                          |
| Animating a set piece as a possessable                     | it snaps back after its shot          | key it where needed, or spawnable (`bind.override`)                     |
| Hiding actors with the Outliner eye                        | back after reopening                  | Levels panel or a Level Visibility track                                |
| Several skeletal meshes, one animation track               | parts do not follow                   | Set Leader Pose Component (`check_characters`)                          |
| Long Python tool, no progress                              | "frozen" editor killed mid-write      | `editor_tool`                                                           |
| Animating before timing is locked                          | work on frames that get cut           | board, stingers on cuts, `ready_to_animate`                             |
| Engine Warm Up for a running character                     | cloth snaps at frame one              | pre-roll plus camera-cut warm-up                                        |
| Expecting the last frame                                   | "missing" frame 50 of 0 to 50         | end is exclusive; count `end - start`                                   |
| Raising samples for noise                                  | time up, noise unchanged              | fix the light or post-process setting                                   |
| Even samples with Frame Center, mixed temporal and spatial | stepping, waste                       | odd temporal only (or 24 with Frame Close)                              |
| Lighting shot by shot, no masters                          | late creative changes                 | approved masters first                                                  |
| Lighting in the default viewport, rendering linear         | look shifts a stop                    | viewport OCIO Display                                                   |
| Linear EXRs sent with no interpretation                    | dark, odd colors in Resolve           | `delivery_note`                                                         |
| Editing the shared graph per shot                          | every job changes                     | exposed variables per job                                               |
| Overnight local queue, or a local executor                 | a crash loses the queue; render stops | farm manager or one process per shot; `shots_to_render`; `start_render` |
| Headless render without `-notexturestreaming`              | soft first frames                     | `mrq_command_line`                                                      |

## Handoffs

- **Receives** from scenario-unreal-lighting-rendering: the lit level (sky, fog, key, unbound PPV, exposure policy, master lighting as a sub-level or data layer), noise fixed at the source, lit masters for approval. From scenario-unreal-animation: Animation Sequences with lengths and rate, characters under 200 joints with Set Leader Pose Component on multi-mesh Blueprints, cloth or physics flags. From scenario-unreal-vfx: Niagara systems with user parameters and warm-up needs. From scenario-unreal-world-building: the map and its set pieces.
- **Delivers** to the editor and colorist: EXRs per shot (`{sequence_name}/{sequence_name}.####.exr`, linear, half, metadata), `<prod>.edl`, the delivery note, the review MP4, contact sheets, JSON reports, the master. To scenario-unreal-lighting-rendering: shots failing continuity or noise, with frames. Farm commands to scenario-unreal-pipeline-automation; slow shots to scenario-unreal-performance.

## UE 5.8 notes

- MRG is Production Ready, new features graph-only, the queue opens in a Basic config; new: Light Modifier, layer warm-ups, DWAA/DWAB EXR, Accumulation DOF (experimental plugin) (5.8 notes; VP [00:33:35]).
- In MRG, Game Overrides act only while connected; tone curve on the renderer node, OCIO on the output node; the Execute Script node needs Editor Only mode for Python (transition doc; 5.8 notes).
- Spawnables are custom bindings; create them with `LevelSequenceEditorSubsystem.add_spawnable_from_class`; no `add_master_track`; time functions take `MovieSceneTimeUnit` (seq-py doc; version deltas).
- Playback honors the selection range; Sensor Aspect Ratio is not animatable; Take Recorder and VCam accept spawnables; Sandboxes for experiments.
- OpenColorIO 2.5.1 with ACES 2.0: view names may differ from "ACES 1.0 SDR Video" [verify].
- Mac: the MRG H.264 node is Windows only (encode with ffmpeg); ProRes on Mac is conflicting [verify]; path tracing needs macOS 26.4+.

## References

- `references/procedures.md`: P0 to P11, full code, plan fields, the template graph spec (P8). Load before writing Sequencer or render code.
- [`references/expert-notes.md`](references/expert-notes.md): judgment per expert, timestamps, deciding conditions.
- [`references/critique.md`](references/critique.md): the rubric, mapped to code checks.
- [`references/gui-paths.md`](references/gui-paths.md): menus and settings for the same procedures.
- `references/sources.md`: sources, credentials, URLs, timestamps; revision history.
- `scripts/ue_cine.py` (toolkit; its docstring lists every call) and `scripts/cine_render_callbacks.py` (the Execute Script class).