Support

Only the sky is visible — no UI or camera controls

This usually means something went wrong during startup. Try these steps in order:

• Remove license.txt and relaunch
• Remove (back up first) config.json — this resets all settings and fixes issues caused by a corrupted config
• Remove (back up first) cache.json from your content library

Crashes every launch — reverting to an older version doesn’t help

This is usually a VR runtime problem, not DanceXR itself.

• If you have multiple VR runtimes, try switching to a different one
• For SteamVR: disable startup overlays and addons you don’t need; try a clean reinstall
• Check the SteamVR driver folder for anything recently installed or updated that you can remove

Asked to activate again

Device IDs can change after an OS update, hardware upgrade, or other system changes. Just run through the activation steps again. Contact us if you have trouble.

Unable to launch VR

DanceXR uses OpenXR to initialize VR. If you have multiple VR runtimes installed, one needs to be set as the active OpenXR runtime:

• Oculus / Meta: Open the Oculus app → Settings → Beta → OpenXR Runtime → “Set Oculus as active”
• SteamVR: Open SteamVR → top-left menu → Settings → Developer → “Set SteamVR as OpenXR Runtime”
• Windows Mixed Reality: Download “Windows Mixed Reality OpenXR Developer Tools” from the Microsoft Store and set WMR as active from there

Model loads but everything is white

The most common cause is filename encoding — textures can’t be located when filenames use a different character encoding.

• For ZIP packages, add the encoding to the package name so DanceXR knows how to parse filenames. Details here →
• Extra spaces in filenames can also prevent textures from loading. Open the model in PMXEditor and verify that texture references match the actual filenames exactly.

Hair materials are see-through

Transparency depth prepass is on by default. It fixes transparency sorting by rendering only the topmost transparent layer — which means stacked transparent layers (like layered hair) only show the top one.

• Turn off transparency depth prepass to render all transparent layers. This may introduce sorting artifacts if the model’s material order isn’t correct.
• There is no perfect universal solution — try different configurations and use the one with fewer visual problems.

Sky sphere from a stage model has holes or looks pixelated

Also caused by transparency depth prepass — when multiple sky spheres are transparent, only the topmost layer renders fully in some areas.

• Turn off transparency depth prepass, or
• Find the background sky sphere and change its material from transparent to opaque