Documentation

Learn how to use NodeCanvas

  1. Getting Started
    1. Framework Concepts
    2. The GraphOwner Component
    3. The "Self" Parameter
    4. BBParameters
    5. Visual Debugging
  2. The Editor
    1. Controls & Shortcuts
    2. Assigning Tasks
    3. Canvas Groups
  3. The Blackboard
    1. Data Binding Variables
    2. Blackboard Parenting
    3. Global Variables
    4. Dynamic Variables
    5. Network Sync
    6. Save & Load
  4. Tasks (Actions & Conditions)
    1. Tasks Included
    2. The Reflection Tasks
    3. Using Task Lists
    4. Creating Custom Tasks
    5. Using Task Attributes
    6. Using BBParameters in Tasks
    7. Creating Generic Tasks
    8. Using FixedUpdate and OnGUI
  5. Behaviour Trees
    1. BT Nodes Reference
    2. Reactive Evaluation
    3. Creating Custom BT Nodes
  6. State Machines (FSM)
    1. FSM Nodes Reference
    2. FSM Callbacks
    3. Creating Custom FSM Nodes
  7. Dialogue Trees
    1. Dialogue Tree Nodes Reference
  8. Mapping Sub Graph Variables
  9. Using Graph Events
  10. Using Signal Events
  11. Working with Custom Types
  12. Working with AOT Platforms
  13. Using the Graph Console
  14. Using the Graph Refactor
  15. Using the Graph Explorer
  16. JSON Import/Export
  17. Scripting
    1. Interfacing with your code
    2. GraphOwner API
    3. Blackboard API
    4. Runtime Instantiation Tips
    5. Creating a Behaviour in Code
    6. Creating Custom Object Drawers
    7. Appending Custom AutoConverters
  18. FlowCanvas Integration
    1. Behaviour Tree -> FlowScript
    2. FSM -> FlowScript
    3. Dialogue Tree -> FlowScript
    4. FlowCanvas -> NodeCanvas
    5. Using Tasks in FlowScripts
  19. Full API

Data Binding Variables

Variables added in a Blackboard can be data-bound to public properties and/or fields of any component that exist on the same game object as the Blackboard, or be bound to a static property/field. Data binding can be one-way or even two-ways, depending on whether the property can read and/or can write. Data binding a variable to a property means that whenever you are getting the variable value, you will be getting the value of the property instead and whenever you are setting the variable value, you will be setting the property value instead. This is very powerful because it allows you to use Blackboard variables as a direct bridge to your own code without the need to use redundant tasks for setting that variable beforehand.

To bind a variable to a property you simply have to click the variable gear button and select the property you want to bind the variable to!

VariableBind

As a more practical example, let’s suppose you have this simple script attached to the same game object as the Blackboard.

And on that Blackboard, you have a float type variable. By clicking the variable options button you will get a context menu to bind the variable with any float type property existing on any component on the game object. In this case, our DataBindExample component. Alternatively, you can simply create a new data bound variable directly without having a variable pre-exist on the blackboard as shown below.

Yes No Suggest edit
65 of 67 users found this section helpful
« The BlackboardBlackboard Parenting »
Suggest Edit