Variables and Tags

Nathan: The value of some property is {{SomeGlobal.some_property}}.
Nathan: Your health is {{player_health}}.
Nathan: You have {{gold}} gold coins.

{{SomeGlobal.some_character_name}}: My name was provided by the player.
{{player_name}}: Hello, I'm {{player_name}}!
{{npc_name}}: Nice to meet you!

~ start
set npc_name = "Bob"
if player_level < 5
	set npc_name = "Mysterious Stranger"

{{npc_name}}: Hello there!
{{player_name}}: Who are you?
{{npc_name}}: I'm {{npc_name}}, nice to meet you.
=> END

~ start
set locals.counter = 0
set locals.player_choice = "none"

Nathan: What would you like to know?

- Tell me about yourself [if not locals.asked_about_nathan]
	set locals.asked_about_nathan = true
	set locals.counter += 1
	Nathan: Well, I'm a game developer who loves making dialogue systems.
	=> start

- What's your favorite color? [if not locals.asked_favorite_color]
	set locals.asked_favorite_color = true
	set locals.counter += 1
	Nathan: I'd say blue. It's calming.
	=> start

- That's all for now
	Nathan: You asked me {{locals.counter}} questions!
	=> END

Nathan: [#happy, #surprised] Oh, Hello!

func _on_dialogue_line(line: DialogueLine) -> void:
	if "happy" in line.tags:
		character_sprite.play("happy_animation")
	if "surprised" in line.tags:
		play_sound("gasp")

Nathan: [#mood=happy] Oh, Hello!
Nathan: [#emotion=surprised, #volume=loud] What?!
Coco: [#animation=wave, #speed=fast] Hi there!

func _on_dialogue_line(line: DialogueLine) -> void:
	var mood = line.get_tag_value("mood")
	if mood:
		character_sprite.play(mood + "_animation")
	
	var animation = line.get_tag_value("animation")
	var speed = line.get_tag_value("speed", "normal")  # Default to "normal"
	if animation:
		play_animation(animation, speed)

Nathan: [#happy] You have {{gold}} gold coins!
Nathan: [#emotion=surprised, #intensity=high] {{player_name}}! I can't believe it's you!
Coco: [#anim=celebrate] You're level {{player_level}} already!

~ start
set locals.conversation_mood = "neutral"

Nathan: [#anim=wave, #emotion=happy] Hello, {{player_name}}!
Nathan: [#camera=closeup] I see you're level {{player_level}}.

if player_level >= 10
	set locals.conversation_mood = "impressed"
	Nathan: [#emotion=impressed] That's quite impressive!
elif player_level >= 5
	set locals.conversation_mood = "encouraging"
	Nathan: [#emotion=encouraging] You're making good progress!
else
	set locals.conversation_mood = "supportive"
	Nathan: [#emotion=supportive] Everyone starts somewhere!

Nathan: You have {{gold}} gold and {{inventory_count}} items.

if gold < 10
	Nathan: [#emotion=concerned] You're running low on gold.
	Nathan: [#ui=highlight_gold] You should do some quests.

Nathan: What would you like to do?
- Buy item [if gold >= 50]
	set gold -= 50
	set inventory_count += 1
	Nathan: [#anim=give, #sfx=purchase] Here you go!
	Nathan: You now have {{inventory_count}} items.
	=> start
- Sell item [if inventory_count > 0]
	set gold += 30
	set inventory_count -= 1
	Nathan: [#anim=take, #sfx=coins] Thanks!
	Nathan: You now have {{gold}} gold.
	=> start
- Check stats
	Nathan: [#ui=show_stats] Here are your stats:
	Nathan: Level: {{player_level}}
	Nathan: Gold: {{gold}}
	Nathan: Items: {{inventory_count}}
	Nathan: Mood: {{locals.conversation_mood}}
	=> start
- Goodbye
	Nathan: [#anim=wave, #emotion=friendly] Safe travels, {{player_name}}!
	=> END

# In your game code
var GameState = {
	"player_name": "Hero",
	"gold": 150,
	"level": 5
}

# Variables are automatically resolved when dialogue runs
# "You have {{gold}} gold" becomes "You have 150 gold"

func _on_dialogue_line(line: DialogueLine) -> void:
	# Check if a tag exists
	if "happy" in line.tags:
		print("Character is happy!")
	
	# Get all tags
	print("All tags: ", line.tags)  # ["emotion=happy", "anim=wave"]
	
	# Get specific tag value
	var emotion = line.get_tag_value("emotion")
	if emotion:
		character.play_emotion(emotion)
	
	# Get tag value with default
	var anim = line.get_tag_value("anim", "idle")
	character.play_animation(anim)
	
	# Handle multiple tags
	for tag in line.tags:
		if tag.begins_with("sfx="):
			var sfx_name = tag.split("=")[1]
			audio_player.play(sfx_name)