문제 해결

가장 흔한 문제들을 증상별로 묶어 빠른 해결책을 정리했습니다. 여기서 해결되지 않으면 게임의 로그를 확보한 뒤(로그를 찾는 곳 참고) 지원 페이지를 통해 연락해 주세요.

• “Unsupported archive format” — Aurora는 zip, 7z, rar, tar, tar.gz, bz2 압축 파일을 지원합니다. 다운로드한 파일이 자동 압축 해제형 .exe 설치 파일이라면 먼저 컴퓨터에서 압축을 풀고 게임 폴더를 지원되는 형식으로 다시 압축하세요.
• “No RPG Maker game found in this archive” — Aurora는 압축 파일 안에서 게임 파일을 찾습니다 (XP/VX/VX Ace는 Game.ini 또는 게임 데이터, MV/MZ는 index.html과 js 폴더). 압축 파일에 런처나 일부만 받은 다운로드가 아니라 전체 게임 폴더가 실제로 들어 있는지 확인하세요. 파일 형식을 참고하세요.
• “Insufficient Disk Space” — 압축 해제에는 압축 파일 크기의 약 2–3배에 해당하는 여유 공간이 필요합니다. 저장 공간을 확보한 뒤 가져오기를 다시 시도하세요.
• “Copy Failed” — Aurora가 원본 위치에서 압축 파일을 읽을 수 없었습니다. 파일이 클라우드 저장소(iCloud Drive, Google Drive 등)에 있다면 먼저 기기에 완전히 다운로드되었는지 확인한 뒤 다시 시도하세요.

다음을 순서대로 시도해 보세요:

1. Ruby 런타임을 바꿔 보세요. 게임의 Settings → Compatibility → Ruby Runtime을 열고 다른 옵션(Auto / Modern 3.1 / Legacy 1.8 / Ace 1.9)을 시도하세요. 오래된 게임(대략 2012년 이전 XP/VX 타이틀)은 대개 **Legacy (1.8)**가 필요하며, 변경은 다음 실행부터 적용됩니다. 시대별로 어떤 런타임이 맞는지는 지원 엔진을 참고하세요.
2. Debug / Cheat Mode를 끄세요. 치트를 켠 직후부터 게임이 실행되지 않는다면 게임의 Settings → Cheats에서 Debug / Cheat Mode를 비활성화하세요. 일부 게임의 디버그 메뉴는 부팅 시 충돌합니다.
3. 게임이 완전한지 확인하세요. 일부 팬 게임은 전체 에셋 팩(배틀러 스프라이트 팩, 생성된 스프라이트시트 등)이 빠진 소스 저장소 형태로 배포됩니다. 이런 게임은 파일이나 비트맵 누락 오류와 함께 시작 직후 충돌합니다. 게임의 공식 정식 릴리스를 다시 다운로드해 가져오세요.
4. 로그를 읽어 보세요. 게임은 대개 종료 직전에 정확한 오류를 기록합니다 — 로그를 찾는 곳을 참고하세요.

• 충돌 직후 게임 로그를 확인하세요 — 대부분의 스크립트 오류는 실패한 스크립트 이름과 함께 기록되며, 이는 종종 누락된 파일이나 게임 자체의 버그를 가리킵니다.
• 게임 설정의 호환성 토글을 시도하세요: Known-Game Fixes와 Error Tolerance Shims가 흔한 스크립트 문제를 우회할 수 있습니다.
• 게임 도중의 파일 누락 오류는 대개 불완전한 다운로드(위 참고)이거나, 구형 XP/VX 게임의 경우 RTP 에셋 누락입니다 — Aurora가 RTP를 다운로드하거나 가져올 수 있습니다. RTP 가이드를 참고하세요.
• 충돌이 재현된다면 직전에 무엇을 했는지 기록해서 로그와 함께 지원 요청에 포함하세요.

• 흐릿하거나 지나치게 선명한 픽셀 — 게임의 Settings → Display에서 Smooth Scaling을 토글하세요.
• 늘어난 화면 — Settings → Display에서 Fixed Aspect Ratio를 활성화하세요.
• 잘못되거나 깨진 맵 타일 — 게임의 Settings → Compatibility에서 Native Tilemap을 끄고(다음 실행부터 적용) 저희가 고속 경로를 수정할 수 있도록 게임을 신고해 주세요.
• 누락되거나 검게 표시되는 스프라이트/타일 — 거의 항상 Aurora 버그가 아니라 게임 에셋 누락입니다. 게임의 완전한 사본을 다시 가져오세요 (게임이 실행 시 충돌해요 참고).

• Aurora는 무음/벨소리 스위치가 켜져 있어도 오디오를 재생하므로, 먼저 볼륨을 확인하세요: 기기 볼륨 버튼, 그다음 Aurora 설정의 Master Volume 슬라이더. Bluetooth 오디오를 사용 중이라면 연결을 끊었다가 다시 연결하세요.
• 효과음은 나오는데 특정 구간에서만 음악이 없는 경우(예: 인트로)는 대개 Aurora가 아니라 게임 자체 스크립트 문제입니다 — 다른 게임의 같은 지점에서 비교해 보세요.
• 다른 게임은 잘 나오는데 한 게임만 완전히 무음이라면, 해당 게임의 로그에서 오디오 오류를 확인하고 지원팀에 보내주세요.

Aurora Link는 로컬 네트워크로 근처 플레이어를 찾으므로 두 기기 모두 권한과 연결이 필요합니다:

1. 로컬 네트워크 권한 — 두 기기 모두. iOS 설정 → 개인정보 보호 및 보안 → 로컬 네트워크에서 Aurora가 활성화되어 있는지 확인하세요. 가장 흔한 원인입니다: iOS는 한 번만 물어보며, 앱을 재설치하면 선택이 초기화됩니다.
2. 같은 Wi-Fi 네트워크 — 두 기기가 같은 네트워크에 있어야 하고 Wi-Fi가 켜져 있어야 합니다 (셀룰러만으로는 안 됩니다).
3. 두 플레이어 모두 로비에 — 한 기기가 세션을 호스팅하면 다른 기기의 Link 로비에 몇 초 안에 표시되어야 합니다.
4. 온라인 세션: 같은 앱 버전 — 온라인 매치메이킹이 계속 멈춰 있다면 두 기기가 같은 Aurora 릴리스를 실행 중인지 확인하세요 (TestFlight/베타 버전과 App Store 버전은 서로 매칭되지 않을 수 있습니다).

전체 설정 단계는 Aurora Link 가이드를 참고하세요.

모든 게임은 자체 오류 로그를 보관합니다:

1. 라이브러리에서 게임의 상세 페이지를 엽니다
2. 메뉴를 열고 Logs(로그)를 탭합니다
3. 로그를 선택하고 Share(공유) 버튼으로 저장하거나 전송합니다

게임이 스크립트 오류를 만나면 종료 전에 상세 내용을 로그에 기록합니다 — 지원 요청에 첨부할 수 있는 가장 유용한 자료입니다.

지원 페이지에서 연락 방법과 신고에 포함할 내용(Aurora 버전, 기기, 게임 이름, 단계, 로그)을 확인하세요.