Up to date
This page is up to date for Godot
If you still find outdated information, please open an issue.
Basic XR Locomotion¶
For basic locomotion we're going to continue using our Godot XR Tools library. The library contains both basic movement features as more advanced features.
Adding our player body¶
The first step we need to do is to add a helper node to our XROrigin3D node.
Because XR supports roomscale tracking you can't simply add your XR setup to a CharacterBody3D node and expect things to work.
You will run into trouble when the user moves around their physical space and is no longer standing in the center of their room.
Godot XR Tools embeds the needed logic into a helper node called
Select your XROrigin3D node and click on the
instantiate Child Scene button to add a child scene.
addons/godot-xr-tools/player/player_body.tscn and add this node.
Adding a floor¶
This node governs the in game movement of your character and will immediately react to gravity. So to prevent our player from infinitely falling down we'll quickly add a floor to our scene.
We start by adding a StaticBody3D node to our root node and we rename this to
We add a MeshInstance3D node as a child node for our
Then create a new PlaneMesh as it's mesh.
For now we set the size of the mesh to 100 x 100 meters.
Next we add a CollisionShape3D node as a child node for our
Then create a
BoxShape as our shape.
We set the size of this box shape to 100 x 1 x 100 meters.
We also need to move our collision shape down by 0.5 meters so the top of our box is flush with the floor.
To make it easier to see that we're actually moving around our world, a white floor isn't going to do it. For this we add a material to our PlaneMesh and set the albedo to a grid texture we've created with Wahooneys excellent free texture generator.
We're going to start adding some basic direct movement to our setup. This allows the user to move through the virtual world using joystick input.
It is important to note that moving through the virtual world while the player is standing still in the real world, can be nausea inducing especially for players who are new to VR. The default settings on our movement functions are fairly conservative. We advise you to stick to these defaults but offer features in game to enable less comfortable settings for more experienced users who are used to playing VR games.
We want to enable this on the right hand controller.
We do this by adding a subscene to the right hand XRController3D node.
addons/godot-xr-tools/functions/movement_direct.tscn as the scene to add.
This function adds forward and backwards movement to the player by using the joystick on the right hand controller. It has an option to also add left/right strafe but by default this is disabled.
Instead, we are going to add the ability for the player to also turn with this joystick.
We will add another subscene to our controller node, select
addons/godot-xr-tools/functions/movement_turn.tscn for this.
The turn system b