Theatre

Text-based linear dialogue system for Godot 4. Literally just a text file! Written in human-readable syntax and VCS-friendly. Edit it with your favourite editor or directly in Godot script editor while keeping your codes and story separate.

Note

This project is currently in its alpha stage and is subject to frequent changes and bugs.

Dia:
    "The syntax is designed to be human-readable.
    Similar to languages like YAML."

:
    "Although it's far more simplified and limited."

:
    "You can also do things like calling
    functions, inserting variables, ..."

# and adding comments!

Features

Dialogue tags

Fine-tune your dialogue flow with {delay} and {speed}.

Godette:
    "Hello!{delay = 0.7} nice to meet you"

Function calls

Connect your story to the game with function calls.

{player_name}:
    "Thanks! that feels so much better"
    player.heal(20)

Quick Start

Write your epic Dialogue!

# write it directly with triple quotation marks
var epic_dialogue = Dialogue.new("""

Dia:
   'But this is not the recommended
    way to write a dialogue'
:
    'Use the method below instead'

""")

# alternatively, write it in a *.dlg.txt file, and load it
var epic_dialogue = Dialogue.load("res://epic_dialogue.dlg.txt")

Set the Stage! define the Label & DialogueLabel node to display your Dialogue

@onready var stage = Stage.new({
    actor_label = $Label,
    dialogue_label = $DialogueLabel
})

# and progress the Dialogue
func _input(event):
    if event.is_action_pressed("ui_accept"):
        stage.progress()

And finally, start the Stage

func _ready():
    stage.start(epic_dialogue)