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.

Before reporting a bug, try these quick fixes:

1. Update to the Latest Version — Your issue may already be resolved in a newer release.
2. Reset Configuration — Back up and then delete config.json to rule out a corrupted settings file.
3. Reset License — If the app fails to start or behaves weirdly, try removing license.txt from the installation directory and relaunching.
4. Clear Library Cache — Back up and delete cache.json from your content library folder to force the player to re-scan your files.
5. OpenXR Setup — If VR won’t launch, double-check that your active OpenXR runtime is set correctly in your VR software settings.

Where can I find the log files?

When reporting a bug, attaching your log files is extremely helpful. Please attach Player.log (current session) and Player-prev.log (previous session) to your bug report.

Windows PC Path:

C:\Users\[User]\AppData\LocalLow\VR Storm Lab\DanceXR [HD|LW|RT]\Player.log

Note: Replace [User] with your Windows username. If AppData is hidden, enable “Hidden items” in Windows Explorer.

Android & Meta Quest Path:

/Android/data/com.vrstormlab.dancexr/files/Player.log

Note: Connect your device to a PC via USB and use File Transfer to locate this file.

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.

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.

How do I set up my content library on Android or Meta Quest?

Android systems have strict file access rules. By default, the content library is located inside the app internal storage.

• Connect your device to a PC via USB, select “File Transfer”, and navigate to /Android/data/com.vrstormlab.dancexr/files/ or the root /DanceXR/ folder to copy your zip/image files.
• On Android and Meta Quest (from version 2024.3), grant DanceXR storage permission to use the system Files app or the built-in Content Manager app to share and manage your library.
• For more details, see the Content Library for Android & Quest guide.

Asked to activate again

After major OS or hardware changes, DanceXR may not recognize the system as the same one your license was issued for. Just run through the activation steps again — there’s no extra cost. See the Activation & Licensing guide. Contact us if you have trouble.