General troubleshooting

If you are encountering issues, try the following steps:

1. Restart Modeler - this can help clear temporary issues.
2. Restart your machine - this can help solve problems with Modeler starting or with configuration issues.
3. 🥽 Try resetting the connection to your VR headset. Use the Reset button at the top right of the Modeler window.
   
4. 🥽 Check that your OpenXR runtime is configured correctly. This is covered in the OpenXR section below.

Access Modeler's log files

Log files hold diagnostic information about your Modeler session, such as the order of actions you have taken, error and warning messages, and crash information. The log file is helpful for Modeler developers to understand the cause of errors and crashes, and the log file is automatically included when you submit an error report.

If you're encountering a recurring issue, you can use our Community channels to contact the Modeler team. We recommend submitting your log files when you report an issue in community channels for a faster response.

You can find Modeler's log files in your documents folder:

C:\Users\<your username>\Documents\Adobe\Adobe Substance 3D Modeler\Logs

A collection of logs are stored from previous sessions. Logs from the Beta version of Modeler have _Beta appended to the end of their name.

OpenXR configuration

Modeler uses OpenXR, and currently supports SteamVR or the Oculus app OpenXR runtimes. If you have both SteamVR and the Oculus app installed on your machine, you may need to change the default OpenXR runtime based on your headset. If Modeler doesn't enter VR mode when you put on your headset, it may be because your OpenXR runtime isn't set up correctly.

In general, if you are using an Oculus headset, you should use the Oculus app as the default OpenXR runtime. If you are using a non-Oculus headset, you should use SteamVR as the default OpenXR runtime.

To set Oculus as the default OpenXR runtime:

1. Open the Oculus app.
2. Navigate to Settings > General.
3. Next to "OpenXR Runtime" click "Set Oculus as active".

To set SteamVR as the default OpenXR runtime:

1. Launch SteamVR.
2. In the SteamVR status window, click the menu button in the top left.
3. Select Settings from the dropdown that appears.
4. In the Settings window, toggle Advanced Settings to "Show".
5. Select the Developer tab from the list on the left.
6. This menu will show the current OpenXR runtime. Click "Set SteamVR as OpenXR runtime" to update the runtime.

Known bugs

This page lists known issues and their workarounds if available.