Dialogue

Fires a single line of spoken or on-screen text from a character. The runtime hands the text and speaker to the host game, which routes them to its dialogue UI. For the cross-cutting Condition and Timing properties shared by every event, see Event types.

Fields

Text

The line of dialogue to display. Plain string. ICU placeholders inside the string are resolved at fire time against the current locale; see ICU format for the supported subset.

Speaker

The character speaking the line. Pick from the editor’s character picker.

When omitted or null, the dialogue is treated as unattributed text (no speaker label).

Voice clip

Optional voice-over recording. Pick from the editor’s media picker. When set, the runtime fires the audio alongside the text so the dialogue UI can lip-sync or auto-advance on audio completion.

Duration

Optional auto-advance duration in seconds. When set, the dialogue UI typically advances after this duration elapses unless the player interrupts. When omitted, dialogue waits for explicit player advance.

Translator note

Optional note for translators (register, tone, scene context). Surfaced in the localization editor next to the source string. Has no runtime effect.

Max length

Optional advisory cap on translated text length, in characters. Surfaced in the localization editor as a translator hint. Has no runtime effect; the runtime does NOT enforce truncation.

Use cases

An unattributed line. Leave the Speaker blank so the line reads without a speaker label, and write the text in Text. The default shape for descriptive prose, narration, on-screen instructions, or any line that should not be tied to a character.

A character line with voice-over. Pick the character from the Speaker dropdown, write the spoken line in Text, and pick the matching recording in the Voice clip dropdown. The dialogue UI can lip-sync or auto-advance once the audio clip finishes playing.

A translator-noted line with auto-advance. Write the text with an ICU placeholder for the interpolated value, pick the Speaker, and set Duration so the UI advances after the line. Fill in Translator note with register and context guidance, then set Max length as a character cap so translations do not overflow the dialogue box.