Skip to content

Commit 3edaa9b

Browse files
committed
Add troubleshooting document regarding Meta XR plugin crash
1 parent 1dc5420 commit 3edaa9b

File tree

3 files changed

+30
-0
lines changed

3 files changed

+30
-0
lines changed

docs/setup/platforms/meta.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -61,6 +61,10 @@ The Epic Games Developer Portal still references to the identity provider as "Oc
6161

6262
If you have not done so already, [download and install the Meta XR plugin](https://developers.meta.com/horizon/documentation/unreal/unreal-quick-start-install-metaxr-plugin) for Unreal Engine from the Meta Developer website.
6363

64+
:::danger
65+
Due to an known issue in Unreal Engine, you **must** [apply patches to the Meta XR plugin's source code](/docs/support/troubleshooting//netdrivers_oculusxr.mdx) to prevent the editor from crashing on launch.
66+
:::
67+
6468
## Download the OVR Platform SDK
6569

6670
Separate to the Meta XR plugin, you must also [download the OVR Platform SDK](https://developers.meta.com/horizon/downloads/package/oculus-platform-sdk) and place it in one of the following locations:
Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
---
2+
title: Networking drivers incorrect when using the Meta XR (Oculus XR) plugin
3+
description: Learn how to mitigate the "networking drivers incorrect" assert when enabling the Meta XR plugin.
4+
---
5+
6+
The Meta XR plugin uses the `UpdateSinglePropertyInConfigFile` function during startup and when saving Oculus XR project settings. Unfortunately this function is buggy in the engine, and causes all dynamic configuration layers to be removed. The Redpoint EOS Online Framework plugin uses dynamic configuration layers to automatically set up networking drivers so that EOS P2P and network encryption works correctly.
7+
8+
To mitigate this, you need to find all calls to `UpdateSinglePropertyInConfigFile` in the Meta XR plugin's `Source` folder, and comment these lines out. For example, the final call inside `UOculusXRHMDRuntimeSettings::PostInitProperties()` should change from:
9+
10+
```cpp
11+
UpdateSinglePropertyInConfigFile(GetClass()->FindPropertyByName(GET_MEMBER_NAME_CHECKED(UOculusXRHMDRuntimeSettings, SBCPath)), GetDefaultConfigFilename());
12+
```
13+
14+
to:
15+
16+
```cpp
17+
// UpdateSinglePropertyInConfigFile(GetClass()->FindPropertyByName(GET_MEMBER_NAME_CHECKED(UOculusXRHMDRuntimeSettings, SBCPath)), GetDefaultConfigFilename());
18+
```
19+
20+
You will need to do this for all calls to `UpdateSinglePropertyInConfigFile` in the Meta XR plugin.
21+
22+
We can't automatically workaround this for you in the Redpoint EOS Online Framework plugin. You will need to apply this fix until either:
23+
24+
- The Meta XR plugin is updated to no longer call `UpdateSinglePropertyInConfigFile`.
25+
- Unreal Engine's implementation of `UpdateSinglePropertyInConfigFile` is fixed to no longer remove dynamic configuration layers.

sidebars.js

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,7 @@ module.exports = {
5050
"support/troubleshooting/steaminvite",
5151
"support/troubleshooting/anticheat",
5252
"support/troubleshooting/room_transactions_throttled",
53+
"support/troubleshooting/netdrivers_oculusxr",
5354
],
5455
},
5556
"support/blueprints_only",

0 commit comments

Comments
 (0)