Spoken Dialogue

The textdisplay_spoken entry renders a single line of dialogue as a floating 3D entity, usually above an NPC's head.

Configuration

text — String

The dialogue text.

speaker

"> The entity speaking. Determines the location and name tag.

duration — Duration

Typing animation duration.

position

"> Optional override for text position if no speaker is defined.

Styling

scale — Double

Text size multiplier.

billboard — Boolean

If true, text always faces the player.

backgroundColor — Color

Background color of the text box.

textOpacity — Double

Opacity of the text (0.0 - 1.0).

viewRange — Double

Maximum distance at which the text is visible.

Advanced Colors

speakerBackgroundColor — Color

Color behind the speaker's name.

textBackgroundColor — Color

Color behind the main text body.

instructionBackgroundColor — Color

Color behind instruction text (e.g. "Space to continue").

dialogue:
  type: textdisplay_spoken
  text: "Can you hear me?"
  speaker: "guide_npc"
  backgroundColor: "#00000088"