SusDialogueBox

Dialogue molecule — speaker, portrait, SusTextFx reveal (Instant/PerChar/Vertex), choices, and UI cues; game owns the dialogue graph, kit owns the presentation.

Package

SusKit · Molecules (commercial)

Open in Playground

SusKit · Molecules

Props

Name	Type	Default
`Reveal`	`Prop<string>`	`"Instant"`
`CharsPerSecond`	`Prop<float>`	`30f`
`AutoAdvanceSeconds`	`Prop<float>`	`0f`
`BlipMinIntervalMs`	`Prop<float>`	`45f`

Slots

No slots.

Events

Name	Field	Payload
`Advance`	`OnAdvance`	—
`Choice`	`OnChoice`	`string`
`Completed`	`OnCompleted`	—

Style hooks

USS class contract — override appearance without touching C#. States toggle via these classes:

sus-dialogue-box
sus-dialogue-box__body
sus-dialogue-box__choice
sus-dialogue-box__choices
sus-dialogue-box__choices--empty
sus-dialogue-box__chrome
sus-dialogue-box__continue
sus-dialogue-box__continue--hidden
sus-dialogue-box__continue-hint
sus-dialogue-box__header
sus-dialogue-box__portrait
sus-dialogue-box__portrait--empty
sus-dialogue-box__speaker
sus-dialogue-box__speaker--empty
sus-dialogue-box__text
sus-dialogue-box--hidden

Usage

Presentation only — feed lines from your own dialogue graph. Reveal rides SusTextFx.Reveal01 (no second ticker). Open/Close/Confirm cues fire through the UI audio profile; per-glyph blips use PlayCustom("dialogue.blip").

csharp

var box = new SusDialogueBox();
box.Reveal.Value = "PerChar"; // Instant | PerChar | Vertex
box.CharsPerSecond.Value = 30f;
box.Show(new SusDialogueLine(
    "Captain",
    "We jump in <wave>three</wave>…",
    portrait: null,
    choices: new[]
    {
        new SusDialogueChoice("go", "Jump now"),
        new SusDialogueChoice("wait", "Hold"),
    }));
box.OnChoice = id => { /* branch */ };
box.OnAdvance = () => { /* next line when no choices */ };
// box.Advance(); box.Skip(); box.Hide();

Prop / API	Role
`Reveal`	`Instant` / `PerChar` / `Vertex`
`CharsPerSecond`	Reveal speed for PerChar/Vertex
`AutoAdvanceSeconds`	After reveal, wait then `Advance()` (`0` = manual only)
`BlipMinIntervalMs`	Throttle for `dialogue.blip`
`Show(line)` / `Advance()` / `Skip()` / `Hide()`	Line lifecycle
`OnAdvance` / `OnChoice` / `OnCompleted`	Host hooks

Notes

Storybook story Dialogue Box (dialogue-box).
Hub shot kit-dialogue-box.png — showcase, captured live from Play mode.

SusDialogueBox ​