Skip to main content

Spoken Cinematic

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

Configuration​

speaker

"> The speaker entity. Text will appear above their head.

position

"> Optional fixed override position if not using a speaker.

segments

"> The timeline of text to display.

Segment Definition​

startFrame — Int

Frame (tick) when text appears.

endFrame — Int

Frame (tick) when text disappears.

text — String

The text content to show.

Animation​

appearanceDelay — Duration

Delay before typing effect starts after spawn.

animationDuration — Duration

Time taken to fully animate/type the text.

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."