Fyrox Dialog

Example: Building a Dialog Graph

Define conversations in code with the Free tier, or use the visual editor in Pro.

use fyrox_dialog::{DialogGraph, TextNode, ChoiceNode, ConditionNode, ActionNode, EndNode};
use fyrox_ai::blackboard::Blackboard;

// Build a simple branching dialog
let mut graph = DialogGraph::new();

// Add nodes
let greeting = graph.add_node(TextNode {
    speaker: "Merchant".into(),
    text: "Welcome, traveler! Looking to trade?".into(),
});

let choice = graph.add_node(ChoiceNode {
    choices: vec![
        "Show me your wares".into(),
        "Not today".into(),
        "Any special deals?".into(),
    ],
});

// Condition: check if player has enough gold
let gold_check = graph.add_node(ConditionNode::from_blackboard(
    "gold", Condition::gte(100),
));

let deal_yes = graph.add_node(TextNode {
    speaker: "Merchant".into(),
    text: "I have a rare sword, just for you!".into(),
});

let deal_no = graph.add_node(TextNode {
    speaker: "Merchant".into(),
    text: "Come back when you have more coin.".into(),
});

let goodbye = graph.add_node(ActionNode { action: "close_shop".into() });
let end = graph.add_node(EndNode);

// Wire the graph
graph.connect(greeting, choice);
graph.connect_choice(choice, 0, deal_yes);   // "Show me your wares"
graph.connect_choice(choice, 1, goodbye);    // "Not today"
graph.connect_choice(choice, 2, gold_check); // "Any special deals?"
graph.connect_condition(gold_check, true, deal_yes);
graph.connect_condition(gold_check, false, deal_no);
graph.connect(deal_yes, end);
graph.connect(deal_no, end);
graph.connect(goodbye, end);

// Run the dialog
let mut runner = DialogRunner::new(&graph, &blackboard);
while let Some(event) = runner.next_event() {
    match event {
        DialogEvent::Text { speaker, text } => show_text(speaker, text),
        DialogEvent::Choice { choices } => {
            let pick = show_choices(&choices);
            runner.select_choice(pick);
        }
        DialogEvent::Action { action } => handle_action(action),
        DialogEvent::End => break,
    }
}