Add an NPC to a Conversation

Prerequisites

• Create a persona

Now that you have created your first persona and refined its personality and knowledge through interacting with it in the Prompt Editor, you can add your NPC to a conversation. To converse with an NPC in game, you must:

• Define a new npc_behavior in Verse.

• Add your npc_behavior to your NPC Character Definition.

• Add your NPC Character Definition to an NPC Spawner.

• Ensure you have Voice Chat Enabled as Voice Chat is required to converse with persona NPCs.

Create an Empty NPC Behavior

To set up a custom NPC Behavior in Verse, follow these steps:

1. In the Menu Bar, select Verse > Verse Explorer.

2. In the Verse Explorer, right-click on your project name and choose Add new Verse file to project to open the Create Verse Script window.

3. In the Create Verse Script window, click NPC Behavior Basic to select it as your template.

4. Name the NPC Behavior persona_npc_behavior under Configure.

5. Select Create to create your Verse file.

The persona_npc_behavior is where you can define and add a persona_component to your NPC through Verse. All NPCs spawned by NPC Spawners are agents and have an associated entity. This associated entity is how you add Scene Graph Components, such as the persona_component to an NPC agent.

NPC Behaviors are defined in Verse inheriting from the base npc_behavior class. For more information about NPC Behaviors, see the Understanding NPC Behaviors page.

Edit your Persona NPC Behavior

Verse is required to add your NPC persona as a conversation target for the player. Without adding your NPC as a conversation target for your player, you cannot converse with your NPC persona.

Below is a Verse script defining the persona_npc_behavior in the section persona_npc_behavior.verse. To add this Verse code to your empty persona_npc_behavior, follow these steps:

• In the Menu Bar, select Verse > Open Project in VS Code…

• Once VS Code opens, find your persona_npc_behavior.verse file in the VS Code Explorer.

• Copy and paste the content of persona_npc_behavior.verse below into your Verse file in your project.

• Compile your Verse code either in the UEFN Toolbar or within VS Code.

For a step-by-step walkthrough of the Verse script, follow the steps under Explanation of Script.

persona_npc_behavior.verse

using { /Fortnite.com/AI }
using { /Fortnite.com/Playspaces }

using { /UnrealEngine.com/Conversations }
using { /UnrealEngine.com/Temporary/Diagnostics }

using { /Verse.org/Chat }
using { /Verse.org/SceneGraph }
using { /Verse.org/Simulation }

Explanation of Script

1. Import the necessary modules.

   Verse

   using { /Fortnite.com/AI }
   using { /Fortnite.com/Devices }
   using { /Fortnite.com/Playspaces }
   
   using { /UnrealEngine.com/Conversations }
   using { /UnrealEngine.com/Temporary/Diagnostics }
   
   using { /Verse.org/Chat }
   using { /Verse.org/SceneGraph }
   using { /Verse.org/Simulation }

   Copy full snippet(10 lines long)

2. Create a log channel. This is a good practice for logging. See Debugging and Troubleshooting in Verse for more information on logging.

   Verse

   persona_log := class(log_channel){}

   Copy full snippet(1 line long)

3. Add a logger to log any relevant messages to report errors, warnings, and important debug messages.

   Verse

   persona_npc_behavior := class(npc_behavior):
   
   	Logger:log = log{Channel := persona_log}
   

   Copy full snippet(3 lines long)

4. To ensure that your player can converse with your NPC as soon as play begins, you need to add the NPC as a conversation for your player. Define a new AddPlayerAsConversationTarget function. To add an NPC as a conversation target for a player, the NPC persona must belong to a team that the player belongs to and be added to a voice chat channel that the player belongs to. The simulation entity contains information about available voice channels.

   Verse

   persona_npc_behavior := class(npc_behavior):
   
   	# Fields
   	# ...
   
   	# Functions
   
          # Add the Player as a conversation target for this NPC 
          AddPlayerAsConversationTarget(Player:player):void=
              if:
   
   Expand code Copy full snippet(30 lines long)

5. Once play ends, NPCs should be cleared out as potential conversational targets for players. Define a new RemovePlayerAsConversationTarget function.

   Verse

   persona_npc_behavior := class(npc_behavior):
   
   	# Fields
   	# ...
   
   	# Functions
   	# ...
   
      	# Remove Player as a conversation target
       	RemovePlayerAsConversationTarget(Player:player):void=
   
   Expand code Copy full snippet(12 lines long)

6. Override OnBegin to automatically add this NPC as a conversation target for players.

   Verse

   persona_npc_behavior := class(npc_behavior):
   
   	# Fields
   	# ...
   
   	# Functions 
   	# ...
   
   	# NPC Behavior Events 
   	
   
   Expand code Copy full snippet(14 lines long)

7. Lastly, override OnEnd to remove this NPC as a conversation target for players.

   Verse

   persona_npc_behavior := class(npc_behavior):
   
   	# Fields
   	# ...
   
   	# Functions 
   	# ...
   
   	# NPC Behavior Events
   	# ...
   
   Expand code Copy full snippet(15 lines long)

Add NPC Behavior to NPC Character Definition

To add your persona_npc_behavior to your NPC Character Definition, follow these steps:

1. Navigate to your PersonaNPCDefinition in the Content Drawer.

   

2. Select the PersonaNPCDefinition to open for editing.

3. Under NPC Character Behavior, select Verse Behavior > persona_npc_behavior.

   

4. Ensure you save your changes to your NPC Character Definition before closing the tab.

Once your NPC Character Definition is added to an NPC Spawner, your NPC persona is automatically added as a conversation target for your player.

Add NPC Spawner with NPC Character Definition

To spawn an NPC with your customized persona, you must add an NPC Spawner to your level and add your PersonaNPCDefinition. To add an NPC Spawner Device, drag your PersonaNPCDefinition from the Content Drawer into the Viewport.

Converse with your NPC

To converse with your NPC, launch a session and start the game. Press the key or button on your input device indicated on-screen and converse with your NPC!

Next Up

• 

  Drive Gameplay with Structured Output

  Explore how to use Verse to refine NPC conversations and behaviors.