Skip to main content
Version: Next (dev)

Blackboard Nodes

Use a blackboard to exchange gameplay state with the animation graph. Configure the named entries with the expected types and make the blackboard available to the Animation Controller Component.

Reading Values​

  • Get Number reads BlackboardEntry and outputs Out Number.
  • Get Bool reads BlackboardEntry and outputs Out Bool.
  • Check Bool also outputs Out On True and Out On False when the observed boolean state changes.
  • Compare Blackboard Number compares BlackboardEntry with ReferenceValue using Comparison. It provides persistent Out Is True/Out Is False values and Out On True/Out On False triggers.
  • OnChanged outputs Out On Value Changed when the entry's change counter changes.

Checks can report the initial observed state as an event. Do not treat their trigger outputs as persistent conditions.

Writing Values​

Set Number and Set Bool write BlackboardEntry when In Activate is triggered. In Number or In Bool supplies the new value; if unconnected, the node uses its Number or Bool property.

A persistent boolean should pass through Bool To Event if a change should activate a setter. The old SetOnActivation/SetOnDeactivation properties are not used by these nodes.

Missing Entries​

Do not rely on missing values as normal control flow. Read and check nodes warn about missing or incompatible entries; without a blackboard they cannot read or write gameplay state. Initialize entries such as Speed (number) and IsGrounded (boolean) before relying on them.