Common Issues (FAQ)
Can't start dialogue?
Confirm
LoadDialogueDataAssetwas called beforeStartDialogueCheck that
SequenceNameexists in the data assetEnsure
StartNodeIDis valid and matches an existing node IDConfirm the component has been added to the Actor
OnDialogueNodeExecuted not being called?
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
OnDialogueChoiceNodeExecutedandOnDialogueEventTriggeredCheck
DisplayDelaysettings (0 = immediate, >0 = delayed)Event bindings must be completed before calling
StartDialogueVerify
StartNodeIDexactly matches the node'sNodeID(copy-paste, don't generate)Ensure node
Conditionsare empty or all conditions evaluate to trueComponent 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
ValueTypesettingComparison 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 > 0on the text nodeIf
AutoAdvanceDelay = 0, you need to manually callAdvanceDialogue()Verify the component is ticking
Manual advance not working?
AdvanceDialogue()only works when:The current node is a text type
AutoAdvanceDelay = 0The node execution callback has completed
Other node types continue automatically
Choice timeout not triggering?
Verify
SelectionTimeout > 0on the choice nodeEnsure
TimeoutNodeIDis set and points to a valid nodeCheck that the component is ticking
💬 Support
If you have any questions, feel free to reach out in the Discord community!
Last updated