지원

하늘만 보이고 UI나 카메라 조작이 안 됩니다

시작 시 문제가 발생했음을 의미하는 경우가 많습니다. 다음 단계를 순서대로 시도해 보세요:

• license.txt를 삭제하고 재실행
• config.json을 백업 후 삭제 — 모든 설정이 초기화되어 손상된 설정 파일로 인한 문제가 해결됩니다
• 콘텐츠 라이브러리의 cache.json을 백업 후 삭제

매번 충돌이 발생하고 이전 버전으로 되돌려도 해결되지 않습니다

이는 대부분 DanceXR 자체의 문제가 아니라 VR 런타임의 문제입니다.

• 여러 VR 런타임이 설치되어 있다면 다른 것으로 전환해 보세요
• SteamVR의 경우: 불필요한 시작 오버레이와 애드온을 비활성화하고 재설치를 시도해 보세요
• SteamVR의 driver 폴더에서 최근에 설치되거나 업데이트된 항목이 있는지 확인하세요

다시 활성화하라는 메시지가 나타납니다

OS 업데이트, 하드웨어 업그레이드 또는 기타 시스템 변경 후 기기 ID가 변경될 수 있습니다. 활성화 단계를 다시 진행하면 해결됩니다. 문제가 있으면 문의해 주세요.

VR을 실행할 수 없습니다

DanceXR은 OpenXR을 사용하여 VR을 초기화합니다. 여러 VR 런타임이 설치된 경우 하나를 활성 OpenXR 런타임으로 설정해야 합니다:

• Oculus / Meta： Oculus 앱 열기 → 설정 → 베타 → OpenXR 런타임 → “Oculus를 활성으로 설정”
• SteamVR： SteamVR 열기 → 왼쪽 상단 메뉴 → 설정 → 개발자 → “SteamVR을 OpenXR 런타임으로 설정”
• Windows Mixed Reality： Microsoft Store에서 WMR OpenXR 개발자 도구를 다운로드하여 WMR을 활성으로 설정

모델을 불러오면 전부 흰색으로 나타납니다

가장 일반적인 원인은 파일명 인코딩 문제입니다 — 다른 문자 인코딩을 사용하면 텍스처를 찾을 수 없습니다.

• ZIP 패키지의 경우 패키지 이름에 인코딩 정보를 추가하면 DanceXR이 파일명을 올바르게 파싱할 수 있습니다. 자세한 내용 →
• 파일명의 불필요한 공백도 텍스처 로딩을 방해할 수 있습니다. PMXEditor로 모델을 열어 텍스처 참조가 실제 파일명과 정확히 일치하는지 확인하세요

머리카락 재질이 투명하게 보입니다

기본적으로 투명도 깊이 프리패스가 활성화되어 있습니다. 이는 가장 위에 있는 투명 레이어만 렌더링하기 때문에 겹쳐진 투명 레이어(겹친 머리카락 등)에서는 맨 위 레이어만 보입니다.

• 투명도 깊이 프리패스를 끄면 모든 투명 레이어가 렌더링되지만, 모델의 재질 순서가 올바르지 않은 경우 정렬 문제가 발생할 수 있습니다
• 완벽한 해결책은 없습니다 — 다양한 설정을 시도하여 문제가 가장 적은 것을 사용하세요

스테이지 모델의 스카이 스피어에 구멍이 생기거나 픽셀화되어 보입니다

이것도 투명도 깊이 프리패스 때문입니다 — 여러 스카이 스피어가 투명할 경우 일부 영역에서는 맨 위 레이어만 완전히 렌더링됩니다.

• 투명도 깊이 프리패스를 끄거나
• 배경 스카이 스피어를 찾아 재질을 투명에서 불투명으로 변경하세요