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

  1. Install Dialogue System for Unity.
  2. Import DialogueSystem.unitypackage from the Behavior Designer Integrations
    folder or the Opsive downloads page.
  3. 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.
  4. Configure a Dialogue Manager and dialogue database through the Dialogue
    System workflow.

Start a conversation

  1. Add Start Conversation to a Sequence.
  2. Enter the exact conversation title from the dialogue database.
  3. Assign the actor and any optional conversational partner required by that
    conversation.
  4. 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.