상담 신청
홈 › 작업 노트 › 개발 › 언리얼 버전 업데이트 때 프로젝트를 옮기는 순서

개발 · 도구 다루기

언리얼 버전 업데이트 때 프로젝트를 옮기는 순서

런처에 새 엔진 버전이 올라오면 프로젝트도 바로 옮기고 싶어집니다. 그런데 프로젝트 파일을 새 버전으로 열자마자 창 하나가 뜨고, 거기서 무엇을 누르느냐에 따라 되돌릴 수 없는 결과가 생길 수 있습니다. 업데이트의 목적부터 변환 뒤 확인까지 순서대로 짚어 봅니다.

작업 노트 519 · 읽는 시간 약 5분 · 2026.11.17 정리

옮기기 전에 왜 옮기는지부터 정합니다

새 버전에는 기능 추가와 버그 수정이 들어 있지만, 진행 중인 프로젝트에는 위험도 함께 들어옵니다. 쓰던 기능의 동작이 미묘하게 바뀌거나 플러그인이 아직 새 버전을 지원하지 않을 수 있습니다. 그래서 먼저 옮겨야 하는 이유를 한 줄로 적어 봅니다. 꼭 필요한 기능이 있다, 지금 버전의 특정 버그 때문에 막혀 있다 같은 이유가 분명해야 합니다.

마감이 가까운 프로젝트라면 옮기지 않는 것도 좋은 선택입니다. 포트폴리오 제출을 앞두고 엔진을 바꾸면 예상하지 못한 오류를 고치느라 남은 시간을 다 쓰게 될 수 있습니다. 실제 현업에서도 개발 중간에 엔진 버전을 바꾸는 일은 일정과 위험을 충분히 따져 본 뒤에 합니다. 연습용 프로젝트로 새 버전을 먼저 써 보는 것이 안전합니다.

팀 프로젝트라면 모두가 같은 버전을 쓰는지가 가장 중요합니다. 한 사람만 새 버전으로 저장한 에셋은 이전 버전을 쓰는 팀원이 열지 못합니다. 버전을 올리기로 했다면 날짜를 정해 함께 올리고, 그 전까지는 아무도 새 버전으로 프로젝트를 열지 않기로 약속합니다. 이 약속이 지켜지지 않으면 파일이 꼬이기 시작합니다.

변환 창의 세 가지 선택지 이해하기

공식 문서에 따르면 새 버전 엔진에서 이전 버전 프로젝트를 열면 변환 방식을 묻는 창이 뜹니다. 기본으로 보이는 선택은 사본을 만들어 변환해 여는 방식이고, 추가 옵션으로 원본을 그대로 변환하는 방식과 변환 없이 여는 방식이 있습니다. 메뉴 이름과 위치는 엔진 버전에 따라 조금 다를 수 있지만, 이 세 가지 개념은 같습니다.

가장 권장되는 것은 사본으로 여는 방식입니다. 원본 폴더는 건드리지 않고 새 폴더에 변환된 프로젝트가 생기므로, 문제가 생기면 원본으로 돌아가면 됩니다. 문서도 사본을 변환해 충분히 확인한 뒤에 옛 버전을 지우라고 안내합니다. 디스크 공간이 조금 더 필요하지만 그 값은 충분히 합니다.

원본을 그대로 변환하는 방식과 변환 없이 여는 방식은 실패하면 되돌릴 수 없는 데이터 손상이 생길 수 있다고 문서에 경고되어 있습니다. 게다가 한 번 변환한 프로젝트는 이전 버전 엔진으로 다시 열 수 없습니다. 이 두 가지 이유 때문에 백업 없이 원본을 변환하는 것은 피해야 할 첫 번째 실수입니다.

언리얼 과정에서 만드는 결과물 예시
언리얼 과정에서 만드는 결과물 예시

실제로 옮기는 순서

  1. 백업: 프로젝트 폴더를 압축해 따로 보관하거나 버전 관리 도구에 커밋합니다.
  2. 플러그인 확인: 쓰고 있는 플러그인이 새 버전을 지원하는지 배포처에서 확인합니다.
  3. 새 엔진 설치: 런처에서 새 버전을 설치하고, C++ 프로젝트라면 그 버전이 요구하는 개발 도구도 맞춥니다.
  4. 사본으로 변환: 새 버전에서 프로젝트를 열고 사본으로 변환하는 선택지를 고릅니다.
  5. 오류 확인: 변환이 실패하면 표시되는 오류 기록을 읽고 원인을 고친 뒤 다시 시도합니다.
  6. 전체 점검: 레벨, 블루프린트, 패키징을 차례로 확인합니다.

순서 중에서 가장 자주 건너뛰는 것이 플러그인 확인입니다. 마켓에서 받은 플러그인이나 외부 도구가 새 버전에 맞게 업데이트되지 않았다면 프로젝트가 열리지 않거나 특정 기능이 사라집니다. 쓰고 있는 플러그인 목록을 미리 적어 두고, 각각 새 버전 지원 여부를 확인한 다음에 변환을 시작해야 시간을 아낄 수 있습니다.

C++ 코드가 들어간 프로젝트는 변환 과정에서 다시 컴파일됩니다. 엔진 버전이 바뀌면서 이름이 바뀌거나 없어진 함수가 있으면 이때 오류가 납니다. 오류 줄에 적힌 파일과 함수 이름을 보고 새 버전의 변경 내역에서 대체 방법을 찾습니다. 블루프린트만 쓴 프로젝트는 이 단계가 비교적 수월한 편입니다.

변환 뒤에 꼭 확인할 것들

프로젝트가 열렸다고 끝이 아닙니다. 모든 블루프린트를 한꺼번에 컴파일해 경고와 오류를 확인합니다. 새 버전에서 더는 쓰지 않는 노드는 노란 경고와 함께 표시되는 경우가 있는데, 지금은 작동해도 다음 버전에서 사라질 수 있으니 목록으로 정리해 둡니다. 출력 로그에 새로 생긴 경고도 함께 메모합니다.

다음으로 레벨을 하나씩 열어 화면을 비교합니다. 조명과 그림자, 후처리 기본값이 버전마다 조금씩 달라져 같은 장면이 더 밝거나 어둡게 보이기도 합니다. 변환 전에 주요 장면 스크린숏을 찍어 두었다면 나란히 놓고 차이를 쉽게 찾을 수 있습니다. 머티리얼이 기본 재질로 바뀐 곳이 없는지도 봅니다.

마지막으로 실제 플레이와 패키징을 확인합니다. 에디터 안에서는 문제없던 기능이 패키징한 빌드에서만 어긋나는 경우가 있기 때문입니다. 조작, 저장과 불러오기, 레벨 전환처럼 핵심 흐름을 처음부터 끝까지 한 번 플레이하고, 이상이 없으면 그때 원본을 정리합니다. 확인 결과는 작업 노트에 날짜와 함께 남깁니다.

언리얼 과정 실습 장면 예시
언리얼 과정 실습 장면 예시

자주 하는 실수와 피하는 습관

흔한 실수 중 하나는 여러 버전을 건너뛰어 한 번에 옮기는 것입니다. 차이가 크면 바뀐 부분도 많아 오류 원인을 찾기 어렵습니다. 진행 중인 프로젝트를 오래 묵혀 두었다면 큰 버전 변화의 안내 문서를 먼저 읽고, 바뀐 기능 목록을 확인한 뒤 변환하는 것이 좋습니다. 큰 세대가 바뀌는 업데이트는 별도의 이전 안내가 나오기도 합니다.

또 하나는 변환된 사본과 원본을 번갈아 작업하는 것입니다. 원본에서 어제 고친 내용이 사본에는 없고, 사본에서 새로 만든 에셋은 원본에서 열리지 않습니다. 사본으로 옮겨 가기로 결정했다면 그 시점 이후로는 원본을 읽기 전용으로만 쓰고 새 작업은 모두 사본에서 하는 규칙을 세웁니다. 폴더 이름에 버전을 붙이면 헷갈림이 줄어듭니다.

엔진 버전 관리는 혼자 공부할 때는 잘 마주치지 않다가 팀 작업이나 장기 프로젝트에서 갑자기 커지는 문제입니다. 지금 쓰는 버전을 유지할지, 새 기능 때문에 옮길지 판단이 서지 않는다면 SBS아카데미게임학원 언리얼 과정 무료 상담에서 프로젝트 상황을 설명하고 버전 운영 방법을 함께 물어보세요.

자주 묻는 질문

변환한 프로젝트를 이전 버전으로 되돌릴 수 있나요?

공식 문서는 변환 뒤에는 이전 버전 엔진으로 열 수 없다고 안내합니다. 그래서 사본 변환과 백업이 사실상 유일한 되돌리기 방법입니다.

버전 업데이트는 얼마나 자주 해야 하나요?

정해진 주기는 없습니다. 진행 중인 프로젝트는 꼭 필요한 이유가 있을 때만 옮기고, 새 프로젝트를 시작할 때 최신 안정 버전을 고르는 방식이 많이 쓰입니다.

확인한 자료

외부 기관의 기준과 안내는 바뀔 수 있으니 최신 내용은 해당 기관에서 확인해 주세요.

언리얼 수업 예시
이 글과 이어지는 과정언리얼 과정 안내

수업 순서, 목표별 결과물, 가까운 센터를 한 페이지에서 볼 수 있습니다.

과정 보기 →

함께 읽으면 좋은 노트

무료 상담 신청

읽은 글과 관련해 궁금한 점이나 지금 상황을 남기면 담당자가 연락드립니다.

상담·컨설팅 무료 · 전화 상담 010-2135-9730

전화상담 신청