Nodes give objects attributes and behaviors.
Nodes can be attached to any object.
By default, objects from the asset library already have a Visual Node, which controls the visual properties of the object including it's 3D model & visual materials. Some objects may also have a Physical Node that define physical properties.
Objects that do not have a Visual Node appear in the editor as colored tiles that are generated upon adding new Nodes from the Logic panel. These objects are invisible during gameplay.
All objects can hold up to 9 nodes (not including Visual & Object Nodes).
Each Node has editable parameters that can be accessed via the Advanced Details panel when an object is selected.
Add new Nodes from the ➕ icon at the bottom of the Advanced Details panel, and remove them via the 🗑️ icon next to the node name.
Executing a Node means that the Node performs its function.
¶ Node Links
Links allow Nodes to work together to create mechanics and logic functions.
Nodes on a selected object can be linked to other nodes and objects by dragging from the link icon on the right of the object widget. This creates a link that indicates its direction by the little arrows traveling along with the link line.
This is just one example of creating a link. There are many different ways to create links and many different types of links.
Link types are identified by different colors:
🔴 Red & ⚫ Grey links can both transmit data to the linked node.
For example a Number Node passes it's value to the Amount of a Transform
A red link also executes the receiving Node. Executing means that it activates the Node once. Sometimes the red link will only execute the linked Node.
For example, pressing a Button executes a Random.
Grey links share data without executing the linked Node.
In the following example each Button press adds a value of 1 to the Number but since the Number Node is not executed it is just holding that value.
🟠 Orange links share values or vectors. Number or Vector Nodes can share values with any Node setting that uses a value or vector. Tap the Node setting in the Advanced Details panel to link it to a Number or Vector Node.
Orange links do not need to be executed.
In the example below anytime the value in the Number Node is updated it will automatically be changed in the Text Node and displayed to the player.
🟢 A green link only sends a "target" to the receiving Node.
For example a Spawner Node targets an object to be the object it will spawn.
¶ Details Panels
When an item is selected a details panel will appear in the upper right corner of the screen. Visual Objects show the Basic details panel while objects with no visual properties will only show the Advanced Details Panel. Switch between Basic and Advanced details panels by tapping the tabs at the top of the panel.
¶ Basic Details
| Asset | Tap the image of the asset to swap it out with a new asset from the Asset Library. See Replace Asset for more. |
| Visual Materials |
The 4 colored spheres represent the Visual Material used by the object. Change the object’s visual materials by tapping on the spheres and selecting. Note: This menu always shows 4 visual material options even if the object uses less visual materials. For example, in the image above the tree only uses the first 2 visual materials. |
| Physics Type |
Quickly change the object’s physics type to one of 3 commonly used options:
Unmovable Object - The object has a physical body but cannot be moved by physics. This is the “Static” setting in the Physical component. Dynamic Object - The object has a physical body and can be physically moved by other objects or forces. This is the Dynamic setting in the Physical component Note: Setting this to Unmovable Object or Dynamic Object will automatically add a Physical Node in the Advanced Details Panel. |
 |
Tap the 3 dots to collapse the details panel. Tap anywhere in the minimized panel to expand it back to the Quick Details panel. |
¶ Advanced Details
In the Advanced Details Panel you can access all of the Nodes contained within the object. Additional Nodes can be added by tapping the + Icon to the right of the Object Node.
Tap on a Node to expand its view and edit its parameters.
With the view expanded a small question mark appears over the Node Icon, tap that question mark to access the Wiki entry for that Node.
Links made using nodes in an object will be visualized by lines connecting the component's to the object it is targeting. While the details panel is open this visualization can be changed with the Link Visualization icon at the bottom of the details panel. With this option turned on links will appear between the Details Panel and the targeted objects. With it turned off links will run between the object holding the Nodes and the targeted object.
¶ Node Debug Overlay
Sometimes things may not be working as expected. When this happens it's very helpful to be able to look at a node's properties while the game is running to see what it is doing.
When playtesting, open the Playtest Menu and enable the logic view to see your logic nodes in the scene while you play.
Use the playtest camera to find nodes outside the game camera's view.
Select an object or node and the details panel will appear in the upper right allowing you to see what is happening in any node while the game is running.
Starting a playtest while an object or node is selected will automatically enable the logic view and display the details panel for that object or node.
Note: not all Nodes are supported.