Dialogues

A huge topic in game and multimedia app development is good and none-redundant dialogue or conversation management. With Gorilla3D you have an easy-to-use component which is also able to handle complex conversations.

• Complex & flexible design in tree structure
• (Un)lockable items
• Crosslinking of items possible
• Set question, answer or floating item display time - for fast-reaction games
• Design of dialogues & monologues with colloquist information
• Multilingual system easily definable
• Auto-language selection
• Set variables to implement gaming elements
• Set parameters to interact back with your game/application
• Events for: showing text and images, playing audio, video and animations, executing method calls, property settings, redirection & more
• Events with different scopes: dialogue item, UI-element, gaming element
• Pause, stop and skip dialogues and items
• Storable as single or multiple dialogue files/streams (dynamic loading possible)
• Storeable in xml format
• Loadable from xml file/stream
• Readable and understandable xml format, to outsource design & management of dialogues.
• Fully customizable in Delphi

We already built a helper tool for you to setup dialogues by a flow chart editor.

• Create dialogues, items and events simply by drag & drop
• Move, rearrange and delete items & events
• Configure every dialogue, item and event in detail
• Treeview for easy dialogue navigation
• Preview dialogues in sandbox viewer

The dialogue system is the basis component for setting up and manage multiple dialogues/conversations and variables. Imagine the dialogue system as a hierarchy, which is able to jump between leaves (items) and execute events, to playback animations, sounds or execute scripts:

DialogueSystem

1. Dialogues
   1. Characters (conversation partner)
   2. Items (Textfragments of conversation)
      1. Events (do something)
2. Variables

To start setting up a system, a few properties are important to know:

Simply set up a dialogue system at runtime like in the following code snippet:

uses
  Gorilla.Utils.Dialogue.System;
 
[...]
 
FDialogueSys : TGorillaDialogueSystem;
FDialogue : TGorillaDialogue;
 
[...]
 
// create a dialogue system on our form (its a none-visual component)
FDialogueSys := TGorillaDialogueSystem.Create(Self);
 
// create a new dialogue
FDialogue := FDialogueSys.Dialogues.Add() as TGorillaDialogue;

A TGorillaDialogue instance is a single closed conversation. So if you want to have a dialogue between character A and B this is the point to start. A TGorillaDialogue manages items and characters. An item can be seen as a text-fragment in your conversation but is much more. A character is a helper structure to organize your conversation. Because it's always important to know who is speaking. Besides this simple fact, a character is used as variable, which can be accessed.

As you've seen above, you add a new dialogue by adding a collection item in the TGorillaDialogueSystem.Dialogues collection. In the next step we should add two characters for our conversation partners, which is also done by adding a collection item. You can of course add more than 2 characters, but to keep it simple, we'll stay here with A and B.

FCharacterA := FDialogue.Characters.Add() as TGorillaDialogueCharacter;
FCharacterA.Name := 'A';
 
FCharacterB := FDialogue.Characters.Add() as TGorillaDialogueCharacter;
FCharacterB.Name := 'B';

Once you've done that, we can start adding our text fragments.

A text fragment is an entity representing a snippet of a conversation or monologue. In most cases its a phrase, a sentance or longer text passage spoken by a single character. So the main duty for setting up a conversation is to split it up the complete text into parts or so called items.

A TGorillaDialogue and a TGorillaDialogueItem are both inherited from TGorillaDialogueParentItem, which is able to hold further sub-items. So you can to setup a hierarchy, that represents a text playback order automatically.

Dialogue
    "Hello World!"
        "How are you?"
            "I'm fine"

The example above will playback the text fragments in order:

1. “Hello World”
2. “How are you?”
3. “I'm fine”

Each item also has the possibility to register events to control the text flow. Those events allow the dialogue system to handle even complex conversation flow. What events can do for you, you can read further below.

A dialogue seldomly is just a text flow. You nearly always will have questions, answers to choose from or points to which to return to. Our dialogue system allows to configure those variations easily.