Common Issues (FAQ)

Can't start dialogue?

  • Confirm LoadDialogueDataAsset was called before StartDialogue

  • Check that SequenceName exists in the data asset

  • Ensure StartNodeID is valid and matches an existing node ID

  • Confirm the component has been added to the Actor


OnDialogueNodeExecuted not being called?

  • The first node must be a text type; choice/event/delay nodes do not trigger this event

  • For other node types, also bind OnDialogueChoiceNodeExecuted and OnDialogueEventTriggered

  • Check DisplayDelay settings (0 = immediate, >0 = delayed)

  • Event bindings must be completed before calling StartDialogue

  • Verify StartNodeID exactly matches the node's NodeID (copy-paste, don't generate)

  • Ensure node Conditions are empty or all conditions evaluate to true

  • Component and Actor must be tickable (not paused/disabled)

  • Verify event signature matches the delegate: Node(FDialogueNode), SpeakerInfo(FSpeakerInfo), NodeID(FGuid)


Conditions not working?

  • Variable names are case-sensitive

  • Value types must match the ValueType setting

  • Comparison values must be string representations (e.g., booleans: "true" or "false")

  • All conditions in the array must pass (AND logic)


Auto-advance not working?

  • Check that AutoAdvanceDelay > 0 on the text node

  • If AutoAdvanceDelay = 0, you need to manually call AdvanceDialogue()

  • Verify the component is ticking


Manual advance not working?

  • AdvanceDialogue() only works when:

    • The current node is a text type

    • AutoAdvanceDelay = 0

    • The node execution callback has completed

  • Other node types continue automatically


Choice timeout not triggering?

  • Verify SelectionTimeout > 0 on the choice node

  • Ensure TimeoutNodeID is set and points to a valid node

  • Check that the component is ticking


💬 Support

If you have any questions, feel free to reach out in the Discord community!

Last updated