Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Einführung in XR-Tools

Godot bietet Ihnen von Haus aus die grundlegende Unterstützung für die Einrichtung eines XR-Projekts. XR-spezifische Spielmechaniken müssen jedoch auf dieser Grundlage implementiert werden. Obwohl Godot dies relativ einfach macht, kann es dennoch eine herausfordernde Aufgabe sein.

Aus diesem Grund hat Godot ein Toolkit namens Godot XR Tools entwickelt, das viele der grundlegenden Mechanismen implementiert, die in XR-Spielen zu finden sind, von der Fortbewegung über die Objektinteraktion bis hin zur Interaktion mit der Benutzeroberfläche.

Dieses Toolkit ist so konzipiert, dass es sowohl mit OpenXR- als auch mit WebXR-Runtimes funktioniert. Wir werden es hier als Grundlage für unsere Dokumentation verwenden. Es hilft Entwicklern beim Einstieg, aber für spezifischere Anwendungsfälle ist das Erstellen einer eigenen Logik ebenso sinnvoll. In diesem Fall können die XR-Tools als Inspirationsquelle dienen.

Installation der XR-Tools

Continuing on from our project we started in Einrichten von XR we want to add in the Godot XR Tools library. This can be downloaded from the Godot XR Tools releases page. Find the latest release for Godot 4, and under Assets, download the godot-xr-tools.zip file. You can also find it in the asset library with the title "Godot XR Tools for Godot 4".

If you're using the zip file, once it's downloaded unzip it. 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:

../../_images/godot_xr_tools_root_folder.webp

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. If it asks for a path to Blender to be set you can just click the option to disable blender import and restart the editor.

After the import finishes you may notice that several "failed to load script" messages popped up, that's normal, the plugin just needs to be enabled in the project settings.

Als nächstes öffnen Sie das Menü Projekt und wählen Projekteinstellungen. Gehen Sie nun auf den Plugins-Tab und aktivieren Sie das Plugin.

../../_images/godot_xr_tools_enable.webp

After doing that you need to close and re-open your project so everything is properly enabled.

Grundlegende Hände

Um ein Gefühl für die Dinge zu bekommen, fügen wir ein paar Standardkomponenten hinzu, die unsere Szene ausschmücken, angefangen mit den Händen für unseren Spieler.

OpenXR unterstützt vollständiges Hand-Tracking, allerdings gibt es derzeit erhebliche Unterschiede in den Fähigkeiten der verschiedenen XR-Runtimes.

Als zuverlässige Alternative bietet Godot XR Tools eine Reihe von geriggten Handszenen, die auf Trigger- und Grip-Eingaben Ihres Controllers reagieren. Diese Hände gibt es in Low- und High-Poly-Versionen, in mehreren Konfigurationen, einer Reihe von Animationsdateien zur Steuerung der Fingerpositionen und einer Reihe von verschiedenen Texturen.

In your scene tree select your left hand XRController3D node. Now click on the instantiate Child Scene button to add a child scene. Click the addons toggle so the addons folder can be searched. Then search for left_hand_low.tscn, and select it.

Wie Sie am Pfad dieser Szene sehen können, befinden sich die Low-Poly-Modelle im Unterordner lowpoly und die High-Poly-Modelle im Unterordner highpoly. Sie werden die Low-Poly-Versionen verwenden wollen, wenn Sie planen, Ihr Spiel auf mobilen Geräten zu veröffentlichen.

Die Default-Hand, die wir gewählt haben, ist nur eine Hand. Die anderen Optionen sind:

  • tac_glove - die Hand trägt einen Handschuh, mit unbedeckten Fingern

  • full_glove - die Hand trägt einen Handschuh, der die gesamte Hand bedeckt

Schließlich gibt es jede Hand in einer Physik-Version. Diese legt alle Knochen frei. Wir werden in einem anderen Tutorial sehen, wie das verwendet werden kann.

Wir wiederholen das Gleiche für die rechte Hand.

../../_images/xr_tools_basic_hands.webp

Weitere Informationen

Auf den nächsten Seiten werden wir mit dem Hinzufügen von Funktionen zu unserem Tutorial-Projekt mithilfe von Godot XR-Tools fortfahren. Ausführlichere Informationen über das Toolkit finden Sie auf den Hilfeseiten des Toolkits.