Skip to main content
Dialogue balloons are the UI elements that display dialogue to players. Dialogue Manager includes an example balloon to help you get started.

​
Using the Example Balloon

The simplest way to show dialogue is using show_dialogue_balloon(): 
DialogueManager.show_dialogue_balloon(resource, label)
​
resource
DialogueResource
required
The dialogue resource (*.dialogue file) to display
​
label
String
default:"0"
The starting label to begin dialogue from

​
Example Usage

# Load and show dialogue
var dialogue_resource = load("res://dialogue/intro.dialogue")
DialogueManager.show_dialogue_balloon(dialogue_resource, "start")
This will show the example balloon by default, but you can configure it in Settings to use your custom balloon.

​
Configuration Options

You can configure the default balloon scene in your project settings:
1

Open Project Settings

Navigate to Project > Project Settings in Godot
2

Find Dialogue Manager Settings

Scroll to the Dialogue Manager section
3

Set Custom Balloon

Set the Balloon Scene path to your custom balloon scene

​
Using Multiple Balloons

If you have multiple balloon styles in your game, you can specify which one to use: 
# Use a specific balloon scene
DialogueManager.show_dialogue_balloon_scene(
    "res://balloons/narrator_balloon.tscn",
    dialogue_resource,
    "start"
)

​
Adding Balloons to Scenes

You can also add a balloon directly to your scene:
1

Add Balloon Node

Add your balloon scene as a node in your game scene
2

Configure in Inspector

  • Set the Dialogue Resource property
  • Set the Start From Label property
  • Optionally enable Auto Start
3

Start Manually (Optional)

If not using auto start, call start() on the balloon node:
$Balloon.start()
The example balloon blocks other input while dialogue is active. You can customize this behavior in your own balloon implementation.

​
Next Steps

Build docs developers (and LLMs) love

Get started for freeTalk to us