게임 가져오기

Sakura는 컴퓨터 없이도 기기에서 직접 NScripter와 ONScripter 게임(Umineko 같은 ONScripter-RU 게임 포함)을 가져옵니다. 이 문서는 앱 내 가져오기 흐름 전체를 다룹니다. 컴퓨터의 브라우저에서 가져오고 싶다면 웹 전송을 참고하세요.

• 라이브러리에서 게임 가져오기 카드를 탭합니다(.zip, .7z, .rar, .tar, .gz, .bz2, .exe).
• 라이브러리가 비어 있으면 게임 없음 화면에도 자체 가져오기 버튼이 있습니다.

이렇게 하면 ONScripter 게임 가져오기 팝업이 열리며, 지원되는 파일 형식이 나열되고 ONScripter 게임 루트 폴더가 자동으로 감지된다는 설명이 표시됩니다. 압축 파일 선택을 탭해 시스템 파일 선택기를 열고 아카이브 하나를 선택하세요.

• zip — ZIPFoundation으로 추출(암호 보호된 경우 SSZipArchive)
• 7z — PLzmaSDK로 추출
• rar — UnrarKit로 추출
• tar / gz / bz2 / tgz — 내장 스트리밍 tar/gzip/bzip2 리더
• lzh / lha — 네이티브 LHA 추출기
• exe(설치 프로그램/자동 압축 해제 파일만) — NSIS 설치 프로그램, Inno Setup 설치 프로그램, 그다음 내장된 7z/zip 자동 압축 해제 페이로드를 찾기 위한 첫 16MB 스캔, 마지막으로 LHA-SFX 순서로 감지

1. 준비. 아카이브가 iCloud Drive에 있으면 Sakura가 먼저 로컬로 다운로드합니다. 그다음 여유 공간을 확인합니다 — 사본을 준비해야 하면 아카이브 크기의 약 3배, 파일이 이미 로컬에 있으면 2배가 필요합니다. 공간이 부족하면 **“저장 공간 부족”**이 표시됩니다: “이 압축 파일을 추출할 여유 공간이 충분하지 않습니다. 저장 공간을 확보한 후 다시 시도하세요.”

2. 암호 확인. 아카이브가 암호화되어 있으면(zip/rar/7z만 해당) 다음과 같이 안내됩니다: “이 압축 파일은 암호로 보호되어 있습니다. 계속하려면 암호를 입력하세요.” 암호가 틀리면 **“암호가 올바르지 않습니다. 다시 시도하세요.”**가 표시됩니다.

3. 사전 스캔. 추출 전에 Sakura는 항목 이름을 스캔해 인식 가능한 NScripter/ONScripter 표지를 찾습니다 — 0.txt, 00.txt, nscript.dat, nscr_sec.dat, nscript.___, 0.utf, 00.utf, pscript.dat 같은 부팅 스크립트나, Umineko 같은 ONScripter-RU 게임이 사용하는 패킹된 스크립트 형식인 script.file, 그리고 arc*.nsa, *.ns2, *.sar 같은 패킹된 아카이브입니다. 사전 스캔이 불가능한 tar 및 기타 형식은 추출 직후에 확인됩니다.

   아무것도 일치하지 않으면 다음과 같이 표시됩니다: “이 압축 파일은 ONScripter 게임처럼 보이지 않습니다. 0.txt, nscript.dat, 또는 arc.nsa 팩을 포함한 압축 파일을 찾아보세요.”

4. 추출. 추출이 시작되기 전 짧은 카운트다운(“시작 중…”)이 실행되고, 이후 실시간 진행률과 취소 옵션이 제공됩니다. 형식별 세부 사항 몇 가지:

   • Zip 파일 이름은 먼저 UTF-8로 디코딩을 시도하고, 실패하면 Shift-JIS로 대체합니다 — 일본어 아카이브의 문자 깨짐을 방지합니다.
   • RAR 추출은 부팅에 필수적인 파일에 대한 추출 후 무결성 검사를 거칩니다. 누락되거나 잘린 파일이 있으면 다음과 같이 표시됩니다: “RAR 추출이 불완전합니다: 필수 파일 N개가 누락되었거나 잘렸습니다(예: {sample}). 게임을 ZIP 또는 7z로 다시 압축하여 가져오세요.”
   • __MACOSX 폴더는 자동으로 삭제됩니다.

5. 게임 루트 감지. Sakura는 위의 NScripter 표지 중 하나를 포함한 가장 얕은 폴더를 찾기 위해 제한된 검색(최대 6단계 깊이)을 수행합니다 — 따라서 Title 1.0/Title 1.0/게임 파일…처럼 중첩된 아카이브도 올바르게 해석됩니다.

6. 설치. 게임은 모드나 번역 패치를 위한 빈 Patches 폴더와 함께 라이브러리 내 자체 폴더에 설치됩니다. 같은 이름의 아카이브가 이미 가져와져 있으면 숫자 접미사가 추가됩니다.

추출이 취소되면 취소됨과 함께 닫기 / 다시 시작이 표시됩니다. 문제가 발생하면 치명적 오류 팝업이 닫기 또는 **다른 항목을 가져오시겠습니까?**를 제공합니다.

가져오기가 성공한 후, 사용자화 단계에서 게임 이름(감지된 이름으로 미리 채워짐)을 설정하고 아이콘을 선택할 수 있습니다 — 아이콘 후보를 찾는 방법은 게임 아이콘을 참고하세요. 선택 사항을 유지하려면 저장을 탭하고, 기본값을 그대로 두려면 건너뛰기를 탭하세요.

마지막 화면에서 게임 이름과 함께 **“게임 가져옴”**이 확인되며, 바로 열 수 있도록 닫기 또는 **게임으로 이동하시겠습니까?**를 제공합니다.

• “지원되지 않는 형식” 또는 **“지원되지 않는 압축 형식”**이 보이나요? 위의 형식별 안내를 참고하세요 — 특히 CAB .exe 설치 프로그램은 먼저 컴퓨터에서 압축을 풀고 다시 압축해야 합니다.
• **“이 압축 파일은 ONScripter 게임처럼 보이지 않습니다”**가 보이나요? 아카이브에 실제로 게임의 스크립트 파일이 포함되어 있는지(설치 프로그램 래퍼나 관련 없는 파일 폴더가 아닌지) 다시 확인하세요.
• 더 일반적인 가져오기 문제는 가져오기 문제를 참고하세요.