Function
Provides access to the transform values of a referenced asset.
The Transform Reference node outputs an asset's transform data as Vector3 values. These values can be used to read or modify an asset's Position, Rotation, and Scale through other nodes such as Set Value. The node also provides directional information based on the asset's orientation.
Can be connected to
- Face target node (Direction)
- Move node (Direction)
- Transform node
- Math Operation Nodes that support vectors
- Set Value Nodes
- Any node that accepts Vector3 outputs
Particularities & Node Configuration
- The Transform Reference node requires a referenced asset.
- The node exposes the asset's transform values as Vector3 outputs.
- Changes made through connected nodes are reflected on the asset in both Solo and Multiplayer modes.
- Position, Rotation, and Scale values correspond to the values displayed in the asset's Remix panel.
- When scaling a primitive Plane, the Z value always remains set to 1.
- The node is synchronized across the network and works in multiplayer.
- The node is serialized when saving a Space or Scenario.
The Transform Reference node contains the following outputs:
Direction Outputs
The top section of the node provides directional references based on the asset's orientation:
- Forward
- Back
- Right
- Left
- Up
- Down
These outputs follow the asset's local orientation.
Transform Outputs
The bottom section of the node provides the asset's transform values:
- Position
- Outputs the asset's current position as a Vector3 value.
- Rotation
- Outputs the asset's current rotation as a Vector3 value.
- Scale
- Outputs the asset's current scale as a Vector3 value.
Using the Transform Reference Node
Example: Change an asset's position when the simulation starts
In order to recreate this scenario, you'll need the following:
- An On Start Canvas node
- A Transform Reference node
- A Vector Value node
- A Set Value node
- A cube asset
When the simulation starts, the Transform Reference node outputs the cube's current Position value. The Set Value node then replaces this value with the Vector Value (2, 2, 2).
As a result, the cube is immediately moved to X: 2, Y: 2, Z: 2 when the simulation begins.