We will create a simple scenario where the character welcomes the player and asks them about their evening or morning based on the player's time of day.

Step 1

Activate the Narrative Design for your character in the Playground. Then, create a new Section.

Step 2

In the Objective section of the new Section, add the following text:

The time of day currently is {TimeOfDay}. Welcome the player and ask him how his {TimeOfDay} is going.

Step 3

Now, let’s back to Unity and make the necessary adjustments. Click on your NPC.

Click the Add Component button and add the Narrative Design Key Controller Component.

Step 4

In the Name field, enter TimeOfDay. In the Value field, specify the corresponding value for that variable, which could be Morning, Evening, or anything else you choose.

Convai Playground

Step 1: Select your Character in which you want to enable Narrative Design

Step 2: Open Narrative Design in Convai Playground

Select the Narrative Design option from the side panel and create your narrative design

For this sample we have created the following Narrative design

You are all set to bring your character from Convai Playground to Unity, let's hope over to Unity to continue the guide

Unity Setup

Step 1: Add the Narrative Design Manager Component

Using Add Components Button in Convai NPC (Recommended Way)

1: Select your Convai Character in the scene and look for ConvaiNPC component in the inspector panel. Click on Add Components button

2: Select Narrative Design Manager checkbox and then click on Apply Changes button

Using Unity Inspector

1: Select your Convai Character and find Add Component button in the inspector panel

2: Search for Narrative Design Manager in the search box and select it

Step 2: Setup the Narrative Design Component

After adding the Narrative Design Component, you will be able to be the following component

Getting to know the Narrative Design Component

Expanding the section event, you will see two unity events you can subscribe to, one is triggered when section starts, and another one is triggered when section ends

Getting to know about Section Triggers

Section triggers are a way to directly invoke a section in narrative design and can be used to jump to a different section in your narrative design

Step 1: Select the game object you want to make a trigger, in this example we have selected a simple cube, but it's up to your imagination.

Step 2: Add Narrative design Trigger from Add Component menu by searching for it

Step 3: Make the collider a trigger.

Step 4: Assign your Convai NPC to Convai NPC field

Now you can select from the "Trigger" dropdown which trigger should be invoked when player enters this trigger box.

We have added a way for you to manually invoke this trigger also, you can use InvokeSelectedTrigger function to invoke the trigger from any where

Invoke Trigger from any script

You can use this code block as a reference to invoke the trigger from anywhere

if(convaiNPC.TryGetComponent(out NarrativeDesignTrigger narrativeDesignTrigger))
{
    //Optional message parameter if you want to send some message while invoking
    //the trigger 
    string message = "Player has collected enough resources";
    narrativeDesignTrigger.InvokeSelectedTrigger(message);
}