Troubleshooting

• No “Enter XR” button: Ensure your site is served over HTTPS. Check that sessionMode is correctly configured and the browser supports WebXR.
• Hand tracking not available: Add requiredFeatures: ['hand-tracking'] to your XR session configuration.
• GLXF not found: Verify that generateGLXF outputs to /public/glxf.
• UI config 404: Confirm that UIKitML compiled JSON files are located under /public/ui.
• Optimizer asset duplication: Rely on the plugin’s dependency blocking to prevent duplicate assets during optimization.