Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

XR 工具简介

Out of the box Godot gives you all the basic support to setup an XR project. XR specific game mechanics however need to be implemented on top of this foundation. While Godot makes this relatively easy this can still be a daunting task.

For this reason Godot has developed a toolkit called Godot XR Tools that implements many of the basic mechanics found in XR games, from locomotion to object interaction to UI interaction.

This toolkit is designed to work with both OpenXR and WebXR runtimes. We'll be using this as a base for our documentation here. It helps developers hit the ground running but for more specific use cases building your own logic is just as valid. In that case XR tools can help in providing inspiration.


The current stable release of Godot XR Tools available on the Asset Library is the version for Godot 3. The port of Godot XR Tools for Godot 4 is available for download from the github website. We will walk through the step of downloading and installing it here. We will update the documentation once Godot XR Tools becomes available for Godot 4 through the asset library.

安装 XR 工具

Continuing on from our project we started in 设置 XR we want to add in the Godot XR Tools library. This can be downloaded from the Godot XR Tools releases page. Simply find the latest pre-release for Godot 4 and then under assets download the godot-xr-tools.zip file.

Once downloaded unzip the file. You will notice the files are held within a godot-xr-tools subfolder. Inside of this folder you will find an addons folder. It is this folder that you want to copy in its entirety to your Godot project folder, your project should now look something like this:


Now open up your project in Godot, if you haven't already, and give it a minute or so to import all the resources of the plugin.

Next open the Project menu and select Project Settings... Now go to the Plugins tab and enable the plugin.



Just to get a feel of things we're going to add a few standard components that dress up our scene starting with hands for our player.

OpenXR supports full hand tracking however there currently are significant differences in capabilities between the different XR Runtimes.

As a reliable alternative Godot XR Tools comes with a number of rigged hand scenes that react on trigger and grip inputs of your controller. These hands come in low and high poly versions, come in a few configurations, a number of animation files to control finger positions and a number of different textures.

In your scene tree select your left hand XRController3D node. Now click on the instantiate Child Scene button to add a child scene. And select addons/godot-xr-tools/hands/scenes/lowpoly/left_hand_low.tscn.

As you can see from the path of this scene, low poly models are in the lowpoly subfolder while high poly models are in the highpoly subfolder. You will want to use the low poly versions if you plan to release your game on mobile devices.


  • tac_glove -手戴手套,手指外露

  • full_glove -手戴着覆盖整个手的手套


We repeat the same for the right hand.



在接下来的几页中,我们将继续使用 Godot XR 工具为我们的教程项目添加功能。有关工具包的更多详细信息,请访问工具包帮助页面 <https://godotvr.github.io/godot-xr-tools/>`_。