# Cinematic Narrative Expansion

This document records the §131 implementation contract for director commentary,
ADR, origin comics, cinematography authoring, internal monologue, Codex lore,
the Cinematography Editor, and Year-1 story DLC seasons.

## Runtime Ownership

- Runtime module: `V2Cinematics`
- Config asset field: `UV2CinematicsConfigAsset::NarrativeExpansionCatalog`
- Blueprint builder:
  `UV2CinematicsBlueprintLibrary::BuildDefaultCinematicNarrativeExpansionCatalog`
- Automation: `V2.Cinematics.NarrativeExpansion.AssetContract`
- CI checker: `V2/ue/Tools/check-v2-cinematic-narrative-expansion.py`

## Commentary

The commentary catalog now covers the required Story, Side Story, Arcade ending,
and Character Episode director-commentary surfaces. Behind-the-scenes commentary
is attached to mocap galleries and includes both mocap-stage director and
stunt-coordinator speakers. Writer commentary is authored per character-defining
scene. Internal monologue uses the same toggleable per-cutscene resolver as
commentary and requires localized thought-pattern adaptation for `en-US`,
`fr-FR`, and `ja-JP`.

## ADR

`ADR.LiveEvents.NarrativeDLC.V2` schedules quarterly live-event sessions,
updates per-event voice-line banks, assigns per-locale directors, and includes
narrative-DLC session ids for every covered character/locale matrix. The
validation gate rejects catalogs that omit any of those requirements.

## Origin Comics

Every covered fighter gets a 3-5 issue digital origin mini-series with
commissioned art, per-locale translation, Codex reader presentation, per-page
art gallery ids, Mastery unlock gates, Side Story unlock gates, Founders Edition
physical extras, and standalone retail release tracking.

## Cinematography Library

Scene references live under `V2/balance/cinema/` and include mood boards,
reference frames, camera blocking docs, lighting fixture bindings, LUT metadata
by mood/fighter/faction/region, depth-of-field presets, close-up catchlights,
and volumetric atmospherics. Lighting fixture definitions live under
`V2/balance/cinema/lighting-fixtures/` and include light type, intensity, color
temperature, falloff curve, and flicker pattern.

## Codex Lore

The Codex lore contract stores per-fighter family-tree relationships for
relatives, mentors, students, and rivals. Cross-IP lore canon ids are allowed
only as contract-gated references for licensed cameo characters.

## Cinematography Editor

`Editor.Cinematography.Sequencer.V2` is modeled as a Sequencer-based authoring
workflow with cinematography library, LUT, lighting fixture, and depth-of-field
presets preloaded for narrative designers.

## Story DLC

The Year-1 plan includes four seasonal story arcs. Each season is validated at
2-4 hours of narrative content and must include ADR, cinematic scenes, comic
mini-series payloads, and new character episodes.