[UE5] .uproject가 증발해버렸다… Unreal Engine 5 프로젝트 복구기 + 월드 꾸미기 과제

1. 문제 상황

간단한 월드 꾸미기 과제를 하면서 오브젝트 배치, 크기 조정, 위치 조정까지 마친 뒤 프로젝트를 정상 종료했다.
그런데 머티리얼을 적용하지 않았다는 것이 떠올라 다시 프로젝트를 열려고 보니, 에픽게임즈 런처 프로젝트 목록에 해당 프로젝트가 보이지 않았다.

수상해서 프로젝트 폴더로 직접 들어가 확인해보니, 딱 하나, .uproject 파일만 사라져 있는 상태였다.
Content, Config, Saved 등 다른 폴더는 모두 멀쩡했지만 정작 프로젝트를 여는 핵심 파일이 없어 실행 자체가 불가능했다.

uproject 파일 어디감..

미리 캡처해둔 이미지만 남음..

2. 원인 분석

• .uproject 파일이 삭제되면서 언리얼이 프로젝트를 인식하지 못한 것.
• 다행히도 콘텐츠 파일들은 손상되지 않아, uproject만 제대로 만들어주면 복구 가능한 상태였다.

복구 방법을 찾던 중,
“새 빈 프로젝트를 만든 뒤 기존의 살아 있는 파일을 붙여넣으면 된다”는 글을 발견했고, 그대로 시도해보기로 했다.

 

3. 해결 방법

✔️ 1) 새 빈 프로젝트 생성

Unreal Engine에서 새 Empty 프로젝트를 하나 만들고, uproject 파일을 포함한 기본 구조를 준비했다.

✔️ 2) 살아 있는 기존 파일 복사

기존 프로젝트에서 살아남은 Content, Config, Plugins 등을 새 프로젝트에 모두 덮어썼다.
그대로 엔진에서 실행해보니… 정상적으로 레벨과 에셋이 열렸다!

이후 머티리얼을 변경하여 여러 차례 수정을 거쳤다.

✔️ 3) 캐릭터 움직임 문제 발견

월드를 확인하려고 캐릭터를 배치해 Possess까지 했는데,
캐릭터가 전혀 움직이지 않는 문제가 발생했다.

블루프린트 → Character 클래스에서 보니 컴파일 경고가 떴고, 아래 이미지와 같은 문구가 계속 나왔다.

 

✔️ 4) 원인 파악

편집 → 프로젝트 세팅 → 입력(Input) 메뉴를 확인해보니…

• Enhanced Input이 아닌 기존 Input 시스템을 사용하는 샘플
• 그런데 복사 과정에서 옛날 "축 매핑(Axis Mappings)" 값들이 싹 날아간 상태

즉, 캐릭터의 InputAxis MoveForward, MoveRight, TurnRight, LookUp 같은 옛날식 Input 이벤트는 그대로 남아 있는데,
프로젝트 설정에는 해당 축 이름이 존재하지 않으니 언리얼이 “알 수 없는 액션/축”으로 경고를 띄운 것이다.

기존 입력 매핑

현재 입력 매핑

✔️ 5) 입력 매핑 수동 복구

잃어버렸던 입력 매핑을 기존 프로젝트와 동일하게 키보드 부분만 다시 추가했다.

4. 결과

• .uproject 파일만 사라져도 프로젝트 전체를 열 수 없지만,
  빈 프로젝트를 생성해 콘텐츠를 재삽입하는 방식으로 완전히 복구 가능했다.
• 단, 입력 시스템이 기존 방식(InputAxis/Action Mapping)이었다 보니
  입력 매핑 값들이 사라져 캐릭터 조작이 안 되는 문제가 발생했다.
• 입력 매핑을 기존 값대로 다시 추가한 뒤에는
  캐릭터 이동·회전 기능이 모두 정상적으로 복구되었다.

이번 경험을 통해 느낀 점:

• 향상된 입력 시스템(Enhanced Input)이 훨씬 관리가 편하다는 것을 체감했다.
• Config/Input 손실만으로도 캐릭터 기능이 모두 마비될 정도로
  전통 입력 시스템은 프로젝트 복구 시 취약하다.
• 앞으로는 반드시 Enhanced Input으로 통일해서 작업해야겠다는 결심을 하게 되었다.