Dialog Node
Dialog is the node you will use most. It gives the story a voice: a speaker, a line of text, and the next place the story should go.
Use Insert > Dialogue & Logic > Say Dialogue when the player should read a line before the route continues.
Properties
Section titled “Properties”| Field | What it does |
|---|---|
| Name | Optional editor-only name for the node. |
| Speaker | Character or narrator speaking this line. |
| Text | The line shown to the player. Supports variable templates such as {playerName}. |
| Next | Node that runs after the line finishes. |
| Inherit Previous Speaker | Reuses the previous speaker when set. |
| Speaker Label Override | Shows custom speaker text for this line only. |
| Append To Previous Text | Adds this line below the current text instead of replacing it. |
| Wait For Advance Input | When false, the line continues after a timer instead of waiting for player input. |
| No-Input Delay | Timer used when Wait For Advance Input is false. Falls back to the project no-input delay. |
| Typewriter Speed | Overrides the project typewriter speed for this line. |
| Scroll Sound Set | Overrides the typing sound for this line. |
| Skippable | Controls whether the typewriter text can be skipped. |
| Portrait Override | Shows a specific portrait for this line. |
| Emphasize Sprite | Emphasizes a visible sprite while the line is active. |
| Dialog UI Override | Uses a different dialog preset for this line. |
| Cues | Triggers audio or effects when specific text appears. |
Runtime behavior
Section titled “Runtime behavior”When a Dialog node runs, VNC resolves variable templates, updates the dialog UI, refreshes portrait and scroll sound choices, writes the line into the story log, then waits for input or a timer.
If Append To Previous Text is true, the new line is added under the previous text with a line break. This is useful for NVL-style passages and moments where a character continues a thought.
Cues watch for exact text as the line scrolls. Each cue can play an audio asset or trigger an effect. If the same trigger text appears more than once, VNC tracks each occurrence separately.
Common mistakes
Section titled “Common mistakes”| Problem | Fix |
|---|---|
| The line does not run | Make sure the scene starts at this node or another connected node reaches it. |
| The story stops after the line | Set Next unless this is intentionally the end of the path. |
| A portrait does not appear | Check the character default portrait or Portrait Override. |
| A variable template appears as blank | Check that the variable key exists and has a value before this line runs. |
Dialog nodes are the spine of most routes. Once the line reads correctly, the rest of the scene has something solid to connect to.