top of page

Start Node

imagem_2025-06-05_232132086.png

The Start Node is automatically created when creating a Dialogus Container. In this node, you specify all actors that will participate in the Dialogus Container. Only actors listed here will be available in Dialogue and Subtitle Nodes.

Add actor button
 

  • Clicking this button adds an actor field. Assign the actors that will be present in this specific Dialogus Container.

imagem_2025-06-05_232208987.png

Dialogue Node

imagem_2025-06-05_232322068.png

The Dialogue Node facilitates the creation of multiple dialogue lines. For simple dialogues without branching, a single node can contain multiple actors lines.

At the bottom of the node, settings are available. Upon creation, these settings inherit default values from the global settings, streamlining development. Note: Depending on the current node style, some options may be hidden (e.g., if your style doesn't utilize actor icons, the icon option won't be available).

imagem_2025-06-05_232624245.png

  • Use Actor Name: Toggle to display the actor's name.

  • Use Actor Icon: Toggle to display the actor's icon. If enabled and the style supports multiple icons, two columns appear: Highlighted (when the actor is speaking) and Non-Highlighted (when the actor is not speaking). Each column allows customization of Color, Scale, and Smoothness (lerping scale).

  • Typewriter Effect (Click here to see more)

  • OnTriggerEvent: Assign a bridge event ID to be invoked when this node is executed

imagem_2025-06-05_232751488.png

After clicking add dialogue button, a dialogue field appears. This field represents the current line the actor will speak.
 
Dialogue Field Components:

  • Reordering Buttons: Arrow buttons at the top-right allow reordering of dialogue lines. These appear only after the dialogue data is saved.

  • Delete Button: The "X" button removes the dialogue field.

  • Actor Field: Displays actors specified in the Start Node.

  • Actor Icon and Expression: If icons are used, the actor's icon appears on the left with an expression dropdown below. The selected expression determines the sprite displayed.

imagem_2025-06-05_232850193.png

  • Dialogue Text Box: Located to the right of the actor's sprite (or below the actor field if icons aren't used), this is where the dialogue line is entered.

  • Audio Clip: Assigning an audio clip reveals an Enum Field to set the pass type:

    • Time: Buttons (e.g., choice or continue) appear after the specified time.

    • On Audio End: Buttons appear only after the audio finishes playing.

imagem_2025-06-05_233022923.png

Additional Foldouts:

  • Events: Assign bridge IDs to various events. Note: Some events may only be visible based on node settings (e.g., OnAudioPlay and OnAudioEnd appear only if an audio clip is assigned; OnTypewriterEnd appears only if the typewriter effect is enabled).

  • Overrides: Customize specific settings for this node. Note: Some overrides appear only if certain conditions are met (e.g., multiple icon overrides appear only if multiple icons are used).

Events

imagem_2025-06-05_234236925.png

Overrides

imagem_2025-06-05_234346524.png

  • Override Actor Name:

    • UseActorName: A boolean toggle that inverses the default setting. For example, if UseActorName is true in settings and the override is also true, the final value becomes false.

    • Bold and Italic: Toggle text styles for the actor's name.

    • Actor Name: If a string is provided, it overrides the default actor name displayed.

  • Override Icon:

    • UseActorIcon: Similar to UseActorName, this boolean toggle inverses the default icon setting.

  • Override Multiple Icon: (Only appears when using a style with multiple icons)

    • Actor: you can only select actors that are not assigned to the current field. As this overrides only not talking actors.

    • Expression: overrides the multiple icon field actor expression

    • Color: overrides the non highlighted color from the node.

imagem_2025-06-05_234438293.png

  • Override Text Style

    • Font: Toggle this to override the dialogue line for this field, allowing you to enter a different text from the default.

    • Font Size: When the bool on the left of the float field is enabled, float field should be enable

imagem_2025-06-05_234544068.png

When dialogue field pass type is not OnAudioEnd, time container should Below each field, when clicked it will show a float field and a x button. The x button will remove the wait time, and the float field will control the wait time.

Choice Node

imagem_2025-06-05_234544068.png

When dialogue field pass type is not OnAudioEnd, time container should Below each field, when clicked it will show a float field and a x button. The x button will remove the wait time, and the float field will control the wait time.

Subtitle Node

imagem_2025-06-05_234655244.png

The Subtitle Node is used to display a single subtitle line, usually for narration or a short message. This node requires an audio clip to work.

Configuration Options:

  • Actor: Optional. Select the actor (only required if "Use Actor Name" is enabled).

  • Text: Enter the subtitle text that will be shown.

  • Audio Clip: Assign the audio clip that will play along with the subtitle.

  • Extra Time: Float value. Adds extra wait time after the audio clip finishes.

  • Use Actor Name: If enabled, the actor's name will appear as a prefix to the text. (Requires actor selection)

  • Typewriter Effect: (Click me for more information)

 

Tip: If you don't want to use an audio clip, use a Dialogue Node and create a custom style that dont have the actor name and icon enabled, remove the background, and sets the continue button as a transparent. Assign the created style to the Dialogue Node.

Condition Node

imagem_2025-06-05_234907454.png

The Condition Node allows branching based on variables and comparisons.

Configuration Options:

  • Output Ports: True / False, depending on whether conditions are met.

  • Add Condition: Button to add new conditions.

  • Variable Field: Select which variable to check.

  • Operator: Choose comparison (e.g., =, >=, <=, >, <, True, False).

  • Value: Enter the value to compare with the variable.
     

If all conditions are true, the system goes through the True port; otherwise, it goes through the False port.

Note: if the condition wasnt created yet, condition node creates with the default values (Floats: 0 |  Bool: false)

Loop Node

imagem_2025-06-05_235002193.png

The Loop Node repeats part of the dialogue flow.
 

Configuration Options:

  • Repeat: Goes back to the previous dialogue node.

  • Return to Start: Goes back to the Start Node.

Wait Node

imagem_2025-06-05_235245822.png

The Wait Node delays the dialogue for a set time before moving on.
 

Configuration Options:

  • Wait Time: Float field (seconds). Time to wait before proceeding.

Event Node

imagem_2025-06-05_235353055.png

The Event Node triggers a bridge event by its ID.
 

Configuration Options:

  • Event ID: Enter the bridge event ID to trigger.
     

When the system reaches this node, it will trigger the corresponding bridge event.


For more information on events bridge, see the Events page.

Set Var Node

imagem_2025-06-05_235535058.png

The Set Var Node creates or modifies a variable during the dialogue.
 

Configuration Options:

  • Add Var: Button to add a variable operation.

  • Variable Name: Enter or select the variable to set/change.

  • Operation: Choose operation (Set True, Set False, Add, Subtract, Equal).

    • Set True/Set False: Creates or changes a boolean variable.

    • Add/Subtract/Equal: Creates or changes a float variable. If the variable already exists, only modifies its value.
       

For connecting your script variables to Dialogus, see the Scripting page.

bottom of page