Dialogue System
The Dialogue System for Unity
integration lets behavior trees start conversations, barks, sequences, and quest
operations and wait for their completion.
Set up the integration
- Install Dialogue System for Unity.
- Import
DialogueSystem.unitypackagefrom the Behavior Designer Integrations
folder or the Opsive downloads page. - Add Dialogue System Callback to the GameObject assigned as the
conversation Actor. Waiting conversation tasks are matched by that actor’s
Transform, which may differ from the GameObject owning the Behavior Tree. - Configure a Dialogue Manager and dialogue database through the Dialogue
System workflow.
Start a conversation
- Add Start Conversation to a Sequence.
- Enter the exact conversation title from the dialogue database.
- Assign the actor and any optional conversational partner required by that
conversation. - Enable Wait For Conversation Completion, then put the next behavior
after the task.
In Play Mode, Start Conversation remains Running while it waits. When the
Dialogue System callback reports completion, the task returns its result and
the Sequence advances.
The Dialogue System side of the integration can also synchronize Lua values
and start or stop Behavior Trees with sequence commands. See the
Dialogue System Behavior Designer integration guide
for those provider-owned features.
Troubleshooting
- The task never finishes: check the task’s Actor assignment, add
Dialogue System Callback to that actor, and confirm the conversation
reaches its completion path. A callback only on a different tree owner cannot
resolve the waiting conversation task. - No conversation starts: verify the database is assigned to the Dialogue
Manager and the task’s conversation title matches exactly. - The task category is missing: import the integration after Dialogue System
is installed and resolve the first Console compile error.