가져오기 문제

Sakura는 NScripter와 ONScripter 게임 압축 파일을 기기에서 직접 가져옵니다. 전체 단계별 흐름은 게임 가져오기를 참고하세요 — 이 페이지에서는 과정 중 문제가 생겼을 때 해야 할 일을 다룹니다.

증상: 압축 파일 선택을 탭했을 때 시스템 파일 선택기에서 압축 파일이 흐리게 표시되거나 목록에 없습니다.

원인: 파일 확장자 필터 설정은 기본적으로 인식된 압축 파일 확장자만 보여줍니다.

해결 방법:

1. 설정 > 일반으로 이동합니다
2. 파일 확장자 필터를 끕니다
3. 다시 가져오기를 시도합니다

증상: .exe 파일을 가져오면 지원되지 않는 형식이 표시됩니다: “이 .exe는 인식된 설치 프로그램(NSIS, Inno Setup)이나 자체 압축 해제 파일(zip/7z/LHA SFX)이 아닙니다 — CAB은 지원되지 않습니다. 컴퓨터에서 추출한 뒤 게임을 zip, 7z, rar, tar.gz로 다시 압축하세요.”

원인: Sakura는 NSIS 설치 프로그램, Inno Setup 설치 프로그램, zip/7z/LHA 자체 압축 해제 파일을 가져올 수 있지만, CAB 기반 자체 압축 해제 파일은 지원되지 않습니다 — iOS에는 이 컨테이너 형식을 풀 방법이 없습니다.

해결 방법: 컴퓨터에서 설치 프로그램을 추출한 뒤 게임 폴더를 .zip, .7z, .rar, .tar.gz 중 하나로 다시 압축하고, 그 압축 파일을 대신 가져오세요.

증상: “지원되지 않는 압축 형식입니다. 지원되는 형식: zip, 7z, rar, tar, tar.gz, bz2.”

원인: 해당 파일이 Sakura가 지원하는 압축 형식이 전혀 아닙니다.

해결 방법: 게임을 위에 나열된 지원 형식 중 하나로 다시 압축하세요.

증상: 추출이 완료되거나(또는 시작 전에 중단되며) 다음 메시지가 표시됩니다: “이 압축 파일은 ONScripter 게임처럼 보이지 않습니다. 0.txt, nscript.dat, 또는 arc.nsa 팩이 포함된 압축 파일을 찾아보세요.”

원인: Sakura는 가져오기 전에 압축 파일에서 인식 가능한 NScripter/ONScripter 표식을 스캔합니다 — 0.txt, 00.txt, nscript.dat, nscr_sec.dat, nscript.___, 0.utf, 00.utf, pscript.dat 같은 부트 스크립트나, script.file(Umineko 같은 게임이 사용하는 ONScripter-RU 팩 스크립트 형식), 또는 arc*.nsa, *.ns2, *.sar 같은 팩 압축 파일입니다. 이 중 어느 것도 발견되지 않으면 손상된 게임으로 가져오는 대신 압축 파일 자체를 거부합니다.

해결 방법:

• 압축 파일에 실제로 게임의 스크립트/데이터 파일이 들어 있는지 확인하세요. 설치 프로그램 래퍼나 관련 없는 폴더 내용만 있는 것이 아닌지 확인하세요.
• 압축 파일이 여러 폴더 깊이 중첩되어 있다면(예: Title 1.0/Title 1.0/게임 파일…) Sakura는 이미 최대 6단계 깊이까지 자동으로 검색합니다 — 하지만 실제 게임 폴더가 그보다 더 깊이 묻혀 있지 않은지 확인하세요.
• 유효한 ONScripter 게임이 확실한데도 계속 거부된다면 지원을 참고하세요.

증상: “RAR 추출이 불완전합니다: 필수 파일 N개가 누락되었거나 잘렸습니다(예: {sample}). 게임을 ZIP이나 7z로 다시 압축한 뒤 가져오세요.”

원인: .rar 압축 파일을 추출한 후, Sakura는 부팅에 필수적인 파일이 실제로 디스크에 온전히 저장되었는지 다시 확인합니다. 손상된 다운로드나 특이한 RAR 변형으로 인해 파일이 누락되거나 잘렸다면, 반쯤 추출된 상태로 두는 대신 가져오기가 중단됩니다.

해결 방법: 가능하다면 압축 파일을 다시 다운로드하거나, 컴퓨터에서 .zip이나 .7z로 다시 압축한 뒤 가져오세요.

증상: Sakura가 *“이 압축 파일은 암호로 보호되어 있습니다. 계속하려면 암호를 입력하세요”*라고 안내하고, 입력한 암호를 거부합니다.

원인: 암호 지원은 .zip, .rar, .7z 압축 파일로 한정되며, 암호가 정확히 일치해야 합니다.

해결 방법: 암호를 다시 확인하세요(뒤에 붙은 공백이나 대소문자 구분에 주의하세요). 압축 파일이 완전히 다른 암호화 방식을 사용한다면 지원되지 않을 수 있으니, 먼저 컴퓨터에서 암호를 해제해 보세요.

증상: “이 압축 파일을 추출할 여유 공간이 부족합니다. 저장 공간을 확보한 뒤 다시 시도하세요.”

원인: 압축 파일을 추출하려면 임시로 추가 여유 공간이 필요합니다 — 파일을 먼저 로컬에 준비해야 하는 경우(예: iCloud Drive에서 가져올 때)는 압축 파일 크기의 약 3배, 이미 기기에 있는 경우는 2배가 필요합니다.

해결 방법: 저장 공간 관리자를 사용해 공간을 확보한 뒤 다시 시도하세요.

증상: 가져오기가 멈춘 것 같거나 압축 파일이 실제로 복사되지 않는 것 같습니다.

원인: 압축 파일이 iCloud Drive에 있지만 아직 기기로 다운로드되지 않았다면, Sakura는 추출하기 전에 먼저 로컬로 실체화해야 합니다 — 느린 연결에서는 시간이 걸릴 수 있습니다.

해결 방법: 파일 앱을 열고 압축 파일을 수동으로 먼저 다운로드한 뒤(파일을 탭하거나 “지금 다운로드” 사용), Sakura에서 가져오세요.

증상: 가져온 일본어 게임 내부의 파일명이 읽을 수 있는 일본어 문자 대신 깨진 문자로 표시됩니다.

원인: 앱 내 가져오기 중에는 zip 항목 이름이 먼저 UTF-8로 디코딩되고, 실패 시 자동으로 Shift-JIS로 대체되어 대부분의 경우 문제가 해결됩니다. 대신 브라우저 측 추출을 사용해 웹 전송으로 게임을 전송한 경우, 브라우저는 유니코드가 아닌(Shift-JIS) 파일명을 보존할 수 없어 Sakura가 “일본어 파일명이 감지되었습니다” 안내를 표시합니다.

해결 방법: 이 안내가 표시되면 “손상된 파일명을 자리 표시자로 대체하는” “브라우저 추출로 계속” 대신, 기기가 직접 압축 파일을 추출하여 원본 파일명을 유지하는 **“압축 파일을 그대로 전송(권장)“**을 선택하세요.

위 단계를 시도해도 압축 파일을 가져올 수 없다면, 게임 이름과 정확한 오류 메시지를 포함해 지원으로 문의하세요.