Skip to content

Update Renderer recommendation for VR Projects (4.7) #12078

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
mhilbrunner merged 1 commit into from
Jun 22, 2026
Merged

Update Renderer recommendation for VR Projects (4.7) #12078

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 7 additions & 6 deletions tutorials/rendering/renderers.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -65,16 +65,17 @@ Choose **Forward+** if:

Choose **Mobile** if:

- You are developing for newer mobile devices, desktop XR, or desktop.
- You are developing for newer mobile devices, desktop XR, standalone XR, or
desktop.
- You have relatively new hardware which supports Vulkan, Direct3D 12, or Metal.
- You are developing a 3D game.
- You want to use advanced rendering features, subject to the limitations
of mobile hardware.

Choose **Compatibility** if:

- You are developing for older mobile devices, older desktop devices, or
standalone XR. The Compatibility renderer supports the widest range of hardware.
- You are developing for older mobile devices, or older desktop devices.
The Compatibility renderer supports the widest range of hardware.
- You are developing for web. In this case, Compatibility is the only choice.
- You have older hardware which does not support Vulkan. In this case,
Compatibility is the only choice.
Expand Down Expand Up @@ -151,9 +152,9 @@ Overall comparison
| | | | optimized. Use Mobile or |
| | | | Compatibility instead. |
+---------------------+--------------------------+--------------------------+--------------------------+
| XR | ✔️ Yes. Recommended for | ✔️ Yes. Recommended for | ⚠️ Supported, but poorly |
| | standalone headsets. | desktop headsets. | optimized. Use Mobile or |
| | | | Compatibility instead. |
| XR | ⚠️ Supported, but not | ✔️ Yes. Recommended for | ⚠️ Supported, but poorly |
| | recommended. Use Mobile | desktop and standalone | optimized. Use Mobile or |
| | instead. | headsets. | Compatibility instead. |
+---------------------+--------------------------+--------------------------+--------------------------+
| Web | ✔️ Yes. | ❌ No. | ❌ No. |
+---------------------+--------------------------+--------------------------+--------------------------+
Expand Down
6 changes: 3 additions & 3 deletions tutorials/xr/setting_up_xr.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -38,9 +38,9 @@ Which Renderer to use

Godot has 3 renderer options for projects: Compatibility, Mobile, and Forward+.
The current recommendation is to use the Mobile renderer for any desktop VR project,
and use the Compatibility renderer for any project running on a standalone headset
like the Meta Quest 3. XR projects will run with the Forward+ renderer, but it isn't
well optimized for XR right now compared to the other two.
or any project running on a standalone headset like the Meta Quest 3. XR projects
will run with the Forward+ renderer, but it isn't well optimized for XR right now
compared to the other two.

OpenXR
------
Expand Down
Loading