AssetRipper Wiki독립 Unity 에셋 가이드
한국어
문제 해결 안내

AssetRipper 파일이 로드되지 않음: 원인별 확인 방법

AssetRipper 파일이 로드되지 않음이라는 메시지만으로는 선택한 폴더가 비어 있는지, 폴더 단계가 맞지 않는지, 처리가 계속 중인지 알 수 없습니다. 현재 상태를 먼저 기록하고, 확인 권한이 있는 Unity 입력 하나를 시험한 뒤 버전을 바꾸기 전에 로그를 보관하세요.

AssetRipper 파일이 로드되지 않음: 먼저 처리 상태 확인

입력을 선택한 뒤 AssetRipper가 처리를 끝냈는지, 계속 작업하는지 기록하세요. 처리가 끝난 뒤 No files loaded가 보이면 선택한 위치나 데이터 종류를 살펴봅니다. 진행 단계가 바뀌고 있다면 폴더가 비었다는 뜻은 아닙니다. 다시 시작하기 전에 화면 상태를 남기세요.

문제가 발생한 순서도 구분해야 합니다. 폴더 선택은 데이터 인식 전이며, 읽기 오류는 파일에 접근한 뒤, 내보내기 중 종료는 로드 이후에 발생합니다. 각 상황에는 다른 증거가 필요하므로 빈 입력 문제에 내보내기 해결법을 적용하지 마세요.

아래 표는 다음 확인 항목을 고르는 기준이지 확정 진단은 아닙니다. 표시된 메시지, 선택 경로, 작은 시험 결과를 함께 보면 폴더 이름이나 기다린 시간만으로 추측하는 것보다 정확합니다.

관찰한 내용알 수 있는 점다음 확인
처리가 끝난 뒤 No files loaded 표시인식된 결과가 표시되지 않음경로를 확인하고 알려진 입력 시험
처리가 계속 진행 중앱이 아직 작업하는 중일 수 있음현재 단계를 기록하고 변화 관찰
assets 파일을 읽는 중 오류파일에 접근했지만 읽지 못함읽기 오류 안내를 보고 로그 보관
내보내기 중 앱 종료로드 이후 단계에서 문제가 발생함내보내기 종료 점검 및 리소스 기록

선택한 폴더와 바로 안쪽의 파일 확인

폴더 이름만으로 AssetRipper가 내용을 인식할 수 있는지 판단할 수 없습니다. 가장 바깥 폴더에는 실행 파일, 설명서, 플랫폼별 폴더, 또 다른 압축 파일이 있고 Unity 데이터는 더 안쪽에 있을 수 있습니다. 다른 빌드를 시험하기 전에 선택 위치의 내용을 확인하세요.

한 번에 한 경로만 따라가며 실제 시험한 위치를 적어 두세요. Data, Content, StreamingAssets 같은 이름은 단서일 뿐 모든 프로젝트에 적용되는 표준 폴더 구조가 아닙니다. 확인 권한이 있는 데이터만 사용하세요.

아래 그림은 압축 해제, 실행, 입력 선택의 일반적인 흐름을 보여 줍니다. 실제 AssetRipper 화면이 아니며 Unity의 필수 폴더 구조를 뜻하지도 않습니다.

01

선택한 경로 기록

선택한 파일이나 폴더와 상위 폴더를 적습니다. 공개 보고서에는 계정명과 개인 경로를 넣지 마세요.

02

위아래 폴더 단계 살펴보기

선택한 위치에 파일이 있는지 하위 폴더만 있는지 확인합니다. 데이터가 안쪽에 있으면 그 위치를 따로 시험하세요.

03

확실히 아는 입력 선택

확인 권한이 있는 Unity 빌드에서 설명할 수 있는 작은 파일이나 폴더를 사용합니다. 이미지, 실행 파일, README가 적절한 입력이라는 보장은 없습니다.

04

선택 위치만 변경

더 구체적인 경로를 선택하되 AssetRipper 빌드와 출력 설정은 그대로 유지하고 다시 시험합니다.

압축 파일 해제부터 내보낸 파일 확인까지 보여 주는 다섯 단계 편집용 일러스트
압축 파일에서 결과를 확인하는 일반적인 순서이며 실제 화면은 아닙니다.

압축 파일을 완전히 풀고 관련 파일 함께 보관

입력이 ZIP 같은 압축 파일 안에 있으면 선택하기 전에 압축을 푸세요. 파일 관리자는 압축된 내용을 보여 줄 수 있지만 앱은 원본 압축 파일을 대상으로 하고 있을 수 있습니다. 쓰기 가능한 위치에 압축을 풀고 완료를 기다린 뒤 결과 폴더를 확인하세요.

첫 시험에서는 옆에 있는 파일과 폴더를 함께 둡니다. 파일을 옮기거나 보조 데이터를 이름 변경하거나 다른 빌드와 섞으면 필요한 연결 관계가 사라질 수 있습니다. 원본은 보존하고 다시 시험할 수 있는 새 복사본을 사용하세요.

압축 해제 오류가 있거나 폴더가 불완전해 보이면 사용 권한이 있는 원본에서 새 복사본을 만드세요. 암호화, 접근 제어, 사용자 지정 보호는 폴더 선택 문제와 다르며 우회해서는 안 됩니다.

증상

선택한 항목이 ZIP 또는 중첩 압축 파일

가능한 원인: 필요한 파일이 일반 폴더로 풀리지 않았을 수 있음.

다음 시도: 압축 해제 완료를 기다린 뒤 풀린 폴더를 선택합니다.

증상

풀린 폴더에 설명서, 이미지, 실행 파일만 있음

가능한 원인: Unity 데이터가 있는 위치가 아닐 수 있음.

다음 시도: 하위 폴더를 살피고 빌드에 포함된 허가된 입력을 시험합니다.

  • 작은 시험이 성공하기 전까지 원본 압축 파일을 그대로 보관합니다.
  • 쓰기 가능한 로컬 경로를 사용하고 서로 다른 빌드의 파일을 섞지 않습니다.
  • 압축 해제 문제와 AssetRipper 로드 메시지를 구분해 기록합니다.

허가된 입력 하나로 조건을 통제해 시험

큰 설치 폴더에는 현재 확인과 무관한 파일이 많을 수 있습니다. 같은 출처의 잘 알려진 Unity 파일 하나나 작은 폴더부터 시험하세요. 결과가 나오면 관련 폴더나 종속성을 하나씩 추가합니다. 결과가 없으면 입력은 그대로 두고 유형과 로그를 살펴본 뒤 범위를 넓히세요.

비교 가능한 시험을 위해 같은 AssetRipper 빌드와 원본 복사본을 사용하고 비어 있는 출력 폴더를 새로 만듭니다. 한 번에 조건 하나만 바꾸세요. 버전, 경로, 권한을 동시에 바꾸면 어떤 변경이 결과에 영향을 줬는지 알기 어렵습니다.

01

작은 기준 입력 정하기

내용을 설명할 수 있고 검사 권한이 있는 파일이나 작은 폴더를 선택합니다. 원본은 바꾸지 않습니다.

02

빈 출력 위치 준비

쓰기 권한과 여유 공간이 있는 별도 폴더를 사용하고 이전 부분 결과를 재사용하지 않습니다.

03

명확한 상태까지 관찰

처리가 끝났는지, 경고가 나왔는지, 계속 중인지 적습니다. 입력별 공통 대기 시간은 없으므로 상태와 로그를 확인하세요.

04

기준 시험 후에만 범위 확대

성공하면 관련 종속성을 하나 추가합니다. 실패하면 문제를 재현하는 가장 작은 예를 보존하세요.

빌드나 경로를 바꾸기 전에 로그 저장

다시 시작하기 전에 정확한 메시지와 관련 로그 줄을 저장합니다. 선택한 파일이나 폴더, 처리가 끝났는지, 단계가 바뀌었는지 기록하세요. 잠시 멈춘 상태와 완료 후 빈 결과는 서로 다른 관찰입니다.

공식 이슈에 오래된 버전에서 특정 파일 로드가 Editor Format Conversion 단계에 머문 사례가 있습니다. 이는 한 사례를 설명할 뿐 현재 버전에도 같은 문제가 있다는 증거나 더 오래 기다리면 항상 해결된다는 뜻은 아닙니다. 사용 중인 버전, 입력, 로그를 기준으로 비교하세요.

기준 상태를 보관한 뒤 공식 빌드와 릴리스 정보를 비교할 수 있습니다. 알 수 없는 미러에서 파일을 받거나 로드를 위해 운영체제 보호 기능을 끄지 마세요.

경고, 데이터 파일, 선택된 폴더를 연결해 보여 주는 편집용 일러스트
여러 조건을 바꾸기 전에 입력과 관찰한 상태를 기록하세요.

도움이 되고 안전한 문제 보고 준비

허가된 작은 입력에서도 No files loaded가 계속되면 다른 사람이 따라 할 수 있는 내용을 정리하세요. AssetRipper 버전이나 배포 채널, 운영체제와 CPU 구조, 입력 종류, 멈춘 단계, 정확한 메시지와 짧은 로그를 포함합니다. 기대한 결과와 실제 결과도 설명하세요.

재현 자료는 작게 유지하고 개인 정보를 지웁니다. 소유권이 있는 게임 파일, 계정 정보, 자격 증명, 개인 경로, 공유 권한이 없는 파일은 첨부하지 마세요. 입력을 공개할 수 없다면 종류와 구조를 설명하고 유지 관리자에게 추가로 제공할 수 있는 증거를 문의하세요.

  • 애플리케이션 버전과 배포 채널
  • 운영체제와 프로세서 구조
  • 파일 또는 폴더 종류와 선택한 경로 단계
  • 처리가 종료, 중단, 진행 중 중 어느 상태였는지
  • 정확한 메시지, 관련 로그, 작은 시험 결과
자주 묻는 질문

AssetRipper 파일 로드 문제 질문

AssetRipper에서 파일이 로드되지 않는 이유는 무엇인가요?

선택한 경로에 인식할 Unity 데이터가 없거나, 입력이 아직 압축 파일 안에 있거나, 처리가 진행 중일 수 있습니다. 빌드를 바꾸기 전에 상태를 확인하고 허가된 입력을 시험하세요.

파일과 폴더 중 무엇을 선택해야 하나요?

입력 출처에 맞는 안내를 따르고 선택 경로에 필요한 데이터가 있는지 확인하세요. 큰 상위 폴더에서 결과가 없으면 다른 설정은 그대로 두고 구체적인 하위 위치를 시험합니다.

파일이 로드될 때까지 얼마나 기다려야 하나요?

모든 입력에 적용할 고정 시간은 없습니다. 상태와 로그가 변하는지 살피고 같은 단계에서 멈추면 빈 결과로 단정하지 말고 그 상태를 저장하세요.

최신 AssetRipper 버전이면 해결될까요?

공식 변경 기록을 확인하거나 같은 입력으로 비교하기 전에는 해결된다고 가정하지 마세요. 현재 빌드와 조건을 기록하고 공식 배포본을 비교합니다.

암호화되었거나 보호된 파일은 폴더를 바꾸면 열 수 있나요?

아니요. 폴더 선택으로 암호화, DRM, 접근 제어, 권한을 우회할 수 없습니다. 허가된 데이터만 사용하고 보호 때문에 접근할 수 없으면 중단하세요.

문제 보고에 무엇을 포함해야 하나요?

버전, 운영체제, 입력 종류, 폴더 단계, 정확한 메시지, 관련 로그, 작은 시험 결과를 적으세요. 개인 경로를 지우고 공유할 수 없는 파일은 첨부하지 마세요.