diff --git a/doc/classes/ProjectSettings.xml b/doc/classes/ProjectSettings.xml
index cf24126584d..532818ebf4f 100644
--- a/doc/classes/ProjectSettings.xml
+++ b/doc/classes/ProjectSettings.xml
@@ -2391,6 +2391,9 @@
Specify the default reference space.
+
+ If [code]true[/code], Godot will display an alert modal when OpenXR initialization fails on startup.
+
If [code]true[/code], OpenXR will manage the depth buffer and use the depth buffer for advanced reprojection provided this is supported by the XR runtime. Note that some rendering features in Godot can't be used with this feature.
diff --git a/main/main.cpp b/main/main.cpp
index f4d2dbef52b..545092555ae 100644
--- a/main/main.cpp
+++ b/main/main.cpp
@@ -1859,6 +1859,7 @@ Error Main::setup(const char *execpath, int argc, char *argv[], bool p_second_ph
GLOBAL_DEF_BASIC(PropertyInfo(Variant::INT, "xr/openxr/reference_space", PROPERTY_HINT_ENUM, "Local,Stage"), "1");
GLOBAL_DEF_BASIC("xr/openxr/submit_depth_buffer", false);
+ GLOBAL_DEF_BASIC("xr/openxr/startup_alert", true);
#ifdef TOOLS_ENABLED
// Disabled for now, using XR inside of the editor we'll be working on during the coming months.
diff --git a/modules/openxr/register_types.cpp b/modules/openxr/register_types.cpp
index c39e49387a5..b7d239fc737 100644
--- a/modules/openxr/register_types.cpp
+++ b/modules/openxr/register_types.cpp
@@ -29,6 +29,7 @@
/**************************************************************************/
#include "register_types.h"
+#include "core/config/project_settings.h"
#include "main/main.h"
#include "openxr_interface.h"
@@ -113,10 +114,19 @@ void initialize_openxr_module(ModuleInitializationLevel p_level) {
ERR_FAIL_NULL(openxr_api);
if (!openxr_api->initialize(Main::get_rendering_driver_name())) {
- OS::get_singleton()->alert("OpenXR was requested but failed to start.\n"
- "Please check if your HMD is connected.\n"
- "When using Windows MR please note that WMR only has DirectX support, make sure SteamVR is your default OpenXR runtime.\n"
- "Godot will start in normal mode.\n");
+ const char *init_error_message =
+ "OpenXR was requested but failed to start.\n"
+ "Please check if your HMD is connected.\n"
+ "When using Windows MR please note that WMR only has DirectX support, make sure SteamVR is your default OpenXR runtime.\n"
+ "Godot will start in normal mode.\n";
+
+ WARN_PRINT(init_error_message);
+
+ bool init_show_startup_alert = GLOBAL_GET("xr/openxr/startup_alert");
+ if (init_show_startup_alert) {
+ OS::get_singleton()->alert(init_error_message);
+ }
+
memdelete(openxr_api);
openxr_api = nullptr;
return;