> ## Documentation Index
> Fetch the complete documentation index at: https://docs.borntocraftstudio.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Spoken Cinematic

> Floating text in cutscenes.

The `textdisplay_spoken_cinematic` entry is a **Cinematic Primary Entry**. It displays floating dialogue text synchronized with timeline frames, perfect for cutscenes.

## Configuration

<ResponseField name="speaker" type="Ref<SpeakerEntry>">
  The speaker entity. Text will appear above their head.
</ResponseField>

<ResponseField name="position" type="Var<Position>">
  Optional fixed override position if not using a speaker.
</ResponseField>

<ResponseField name="segments" type="List<Segment>">
  The timeline of text to display.
</ResponseField>

### Segment Definition

<ResponseField name="startFrame" type="Int" required>
  Frame (tick) when text appears.
</ResponseField>

<ResponseField name="endFrame" type="Int" required>
  Frame (tick) when text disappears.
</ResponseField>

<ResponseField name="text" type="String" required>
  The text content to show.
</ResponseField>

### Animation

<ResponseField name="appearanceDelay" type="Duration" default="1s">
  Delay before typing effect starts after spawn.
</ResponseField>

<ResponseField name="animationDuration" type="Duration" default="2s">
  Time taken to fully animate/type the text.
</ResponseField>

<CodeGroup>
  ```yaml Example theme={null}
  cinematic:
    type: textdisplay_spoken_cinematic
    speaker: "hero_npc"
    segments:
      - startFrame: 0
        endFrame: 60
        text: "Look at that view!"
      - startFrame: 70
        endFrame: 120
        text: "It's breathtaking."
  ```
</CodeGroup>