본문 바로가기
카테고리 없음

로블록스 스튜디오 Asset ID 오류 & 경로 확인법

by robydachi 2025. 7. 12.

게임이나 앱을 개발하면서 외부 리소스(에셋)를 불러오는 일은 흔한 작업입니다. 예를 들어 모델, 이미지, 사운드, UI, 텍스트 등 다양한 자산들을 프로젝트에 추가하고 코드에서 로드하게 되죠. 하지만 개발자라면 누구나 한 번쯤 이런 경험을 해보셨을 겁니다.

 

“분명 에셋 넣었는데, 실행하면 에러 나요.”
“Asset ID가 유효하지 않다고 나오는데 왜인지 모르겠어요.”

 

로블록스 스튜디오 Asset ID 오류 & 경로 확인법
로블록스 스튜디오 Asset ID 오류 & 경로 확인법

 

 

이 문제는 주로 에셋 경로 오류, Asset ID 설정 실수, 리소스 누락, 포맷 호환 문제 등으로 인해 발생합니다. 특히 Unity, Godot, Unreal 등 게임 엔진마다 자산을 불러오는 방식과 경로 체계가 다르기 때문에 더욱 헷갈릴 수 있습니다.

이번 포스트에서는 에셋이 정상적으로 불러와지지 않는 문제의 주요 원인 5가지와, 이를 정확하게 진단하고 해결하는 방법을 상세히 소개해드립니다.

에셋이 안 불러와지는 5가지 주요 원인과 해결법

1) Asset 경로 오류 – 대소문자, 슬래시, 확장자 실수
가장 흔한 원인입니다. 실제 파일 경로와 코드에서 사용하는 경로가 완전히 일치하지 않으면 에셋을 불러올 수 없습니다. 특히 대소문자 구분이 있는 운영체제(Linux, Android 등)에서는 Texture.png와 texture.png가 다른 파일로 인식됩니다.

 

🛠 해결 방법

경로를 하드코딩하지 말고, 항상 Resources.Load("경로")처럼 상대 경로 기준으로 설정

확장자 생략 여부 확인 (.png나 .mp3 포함 여부)

/(슬래시) 사용이 \ 또는 // 등으로 잘못되어 있지 않은지 확인

대소문자 정확히 일치시키기

 

💡 Unity 기준 예시:

Resources.Load("Images/Character01") // "Assets/Resources/Images/Character01.png"


2) Asset ID 누락 또는 잘못된 참조
에셋을 불러올 때 특정 Asset ID나 GUID(고유 식별자)를 사용하는 구조에서는, 해당 ID가 변경되거나 누락될 경우 불러오기에 실패합니다. Unity에서 종종 발생하는 대표적인 사례는 Prefab 연결이 끊어졌을 때입니다.

 

🛠 해결 방법

 

Unity
→ 연결된 에셋의 참조가 Missing으로 표시되는지 확인
→ Project 창에서 직접 클릭했을 때 "missing reference" 메시지가 나오는 경우 재연결
→ ScriptableObject나 Addressables를 사용할 경우, ID/GUID 일치 여부 확인

Unreal, Godot:
→ 프로젝트 설정에서 에셋의 UUID 또는 Resource Path가 변경되었는지 확인

 

💡 팁: Unity에서는 meta 파일이 사라지거나 재생성되면 GUID가 변경되어 참조가 끊어질 수 있으니, 소스 컨트롤로 함께 관리하세요.