MovableNode module
- Last UpdatedOct 08, 2025
- 2 minute read
The MovableNode module allows to define the type of node to be used to navigate in the scene, such as Camera, Avatar, or AvatarControllerViewer. By specifying the three configurations available, the module automatically creates the necessary nodes and sets some of their base fields.
The Movable module can be used in isolation or combined with the Navigation module to implement navigation. See the Integration guide for further details.
How it works
Firstly, the module instantiates a Camera node, whose field type is set depending on the setting of collisionsEnabled.
-
If collisionsEnabled is false, field type is set to matrix.
-
If collisionsEnabled is true, field type is set to avatar.
Then, if collisionsEnabled is set to true, the module’s behavior is different depending on the platform.
-
On XR-Windows platform, the module instantiates an Avatar node, with the camera field set to the newly created Camera node, cameraMode set to behind and mode set to player, if thirdPersonEnabled is true, or controller, if thirdPersonEnabled is false. In the second case, an AvatarControllerViewer node with mode set to fly is created.
-
On other platforms, the module directly instantiates an Avatar node, with the camera field set to the newly created Camera node, mode set to controller and cameraMode set to behind, and an AvatarControllerViewer node with mode set to fly. The message "Avatar mode player not supported on NX, Avatar with mode controller and avatarController node will be used instead" is also logged.
Configuration fields
The configuration fields in the MovableNode module.
|
Name |
Type |
Default value |
Description |
|---|---|---|---|
|
movableNodePrefix |
sstring |
Player0 |
Prefix string used to name the instantiated Camera, Avatar and AvatarController nodes, such as Player0_Camera, Player0_Avatar and Player0_AvatarController. |
|
thirdPersonEnabled |
sbool |
false |
If set to false and collisionEnabled is set to true an AvatarControllerViewer node is created. |
|
collisionsEnabled |
sbool |
false |
If set to true an Avatar node is created. If false a Camera of matrix type is created instead. |
Output field
The output field in the MovableNode module.
|
Name |
Type |
Description |
|---|---|---|
|
MovableNode |
sstring |
Returns the name of the node used to navigate the scene, such as Camera node name, if collisionsEnabled is false, or Avatar node name, if collisionsEnabled is true. The name is composed as <movableNodePrefix_nodeType>. |