Flow Tutorial

PaleBlue provides a number of node blocks. This section describes some of the main use cases for Flow.

Show UI Dialogs

Dialogs allow to present certain information, or to ask questions to assess knowledge and understanding.

Here’s how to create a simple UI dialog with a question:

1. Right click in Flow to Add node, then select PaleBlue → UI Dialog
2. A new UI Dialog node is created and its properties are opened

3. You can make your UI Dialog a Yes/No dialog by selecting the appropriate buttons in the Buttons dropdown
4. Set the Title and the Dialog Text fields to have the title and a question, like shown above
5. Connect the In port for Flow coming in, and the Out ports for Yes and No for Flow coming out

6. Can be a good idea to make a Notification to the user on whether the answer was correct or not, see the Notification section below

Give Positive and Negative Notifications

Notifications are those Green and Red icons with a distinct sound, that make player aware of whether the action was correct or incorrect.

Here’s a simple example: depending on the player’s answer in a UI dialog, either Positive or Negative notification will be shown:

In order to create a Notification that’s Positive:

1. Right click in Flow to Add node, then select PaleBlue → Notification Correct
2. This notification will play a sound and show a correct icon when flow reaches it
3. Connect the In and Done ports according to your logic

In order to create a Notification that’s Negative:

1. Right click in Flow to Add node, then select PaleBlue → Notification Wrong
2. This notification will play a sound and show a correct icon when flow reaches it
3. Connect the In and Done ports according to your logic

Speak with Text-to-Speech Voice

It’s a great way to guide the user through the course by using voice for briefing and feedback. We have an automated voice system built-in, so you don’t need voice actors!

1. Open Flow
2. Right click in Flow to Add node, then select PaleBlue → Play Voice
3. A new Play Voice node is created and its properties are opened
4. Type in the text you want the system to speak out into the Text field

5. Connect the Play Voice node to other nodes in your flow

6. Note that this node has two exit ports.
1. Out is executed immediately after voice playback starts
2. Done waits first for the voice to fully play, and executes only then - it’s usually a good idea to wait with other actions until voice is fully played
7. That’s it. You can run your flow, and the voice will be played when this Play Voice node is reached.

Show and Hide Scene Objects

A lot of scenarios in training involve objects appearing or hiding. This is usually the case when some new taks is given, and new interactive equipment is presented. Or, when a task is done, objects can be removed from the scene and the player can move on to something else.

This is done by having all the objects in place in the scene from the very start, and hiding and showing them as the scenario flow progresses.

So let’s take a look how hiding is done.

1. Right click in Flow to Add node, then select PaleBlue → Show Hide Objects
2. A new Show Hide Objects node is created and its properties are opened

3. Point Selectable Object to some pre-existing object in the scene.
4. Make sure that Active State is off, as we will be hiding it
5. Connect the In port for Flow coming in, and the Out port for going out

6. That’s it! When this node is executed, the object in question will be hidden.