지원

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

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

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

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

이것은 대개 DanceXR 자체의 문제가 아니라 VR 런타임의 문제입니다.

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

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

OS 또는 하드웨어에 대규모 변경이 있을 경우, DanceXR은 이 시스템을 라이선스가 발급된 것과 동일한 시스템으로 인식하지 못할 수 있습니다. 활성화 단계를 다시 진행해 보세요 — 추가 비용은 없습니다. 활성화 및 라이선스 가이드를 참고하세요. 문제가 있으면 문의해 주세요.

VR을 실행할 수 없습니다

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

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

모델을 불러오면 전부 흰색입니다

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

• ZIP 패키지의 경우, DanceXR이 파일명을 파싱하는 방법을 알 수 있도록 패키지 이름에 인코딩을 추가하세요. 자세한 내용 →
• 파일명에 있는 추가 공백도 텍스처 로딩을 방해할 수 있습니다. PMXEditor에서 모델을 열고 텍스처 참조가 실제 파일명과 정확히 일치하는지 확인하세요.

머리카락 재질이 투명합니다

투명도 깊이 프리패스가 기본적으로 활성화되어 있습니다. 이는 최상위 투명 레이어만 렌더링하여 투명도가 정렬되도록 합니다 — 이 때문에 중첩된 투명 레이어(예: 겹친 머리카락)는 가장 위에 있는 것만 표시됩니다.

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

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

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

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