Unreal Engine 플러그인

설치

uVersion 플러그인은 미리 컴파일된 바이너리로 배포되며 desktop 클라이언트가 관리합니다. 직접 컴파일할 필요도, 소스 파일을 다룰 필요도 없습니다.

지원되는 Unreal 버전: 5.6 이상.

절차

1. uVersion desktop 클라이언트를 설치합니다
2. Unreal 프로젝트가 들어 있는 워크스페이스를 클라이언트에 추가합니다
3. Unreal 패널이 자동으로 .uproject를 감지합니다
4. 클라이언트가 사용 중인 Unreal 버전과 플랫폼에 맞는 플러그인을 설치합니다
5. Unreal에서 프로젝트를 열면 플러그인이 즉시 활성화됩니다

업데이트

desktop 클라이언트는 프로젝트를 열 때와 6시간마다 새 버전을 확인합니다. 사용 중인 Unreal에 더 새로운 버전이 있으면 클라이언트의 Unreal 패널에 « Update ready » 배지가 나타납니다. Unreal 에디터를 닫은 다음 배지를 클릭하여 업데이트를 적용하세요(플러그인은 로드된 상태에서는 교체할 수 없습니다).

첫 연결

Unreal 에디터에서: Tools → Source Control → Connect to Source Control로 이동한 뒤, Provider 드롭다운에서 uVersion을 선택합니다.

자격 증명은 desktop 클라이언트에서 자동으로 가져옵니다. 다시 입력할 필요가 전혀 없습니다. 어떤 이유로든 desktop 클라이언트가 설치되어 있지 않으면, 에디터가 서버 주소와 자격 증명을 입력하는 양식을 표시합니다.

플러그인이 Unreal에서 하는 일

네이티브 Source Control

checkout, checkin, revert, history: 모든 기능을 Content Browser의 우클릭 메뉴에서 사용할 수 있으며, 다른 Unreal Source Control Provider와 완전히 동일하게 작동합니다. 아티스트가 새로 배울 것은 전혀 없습니다.

편집 시 자동 잠금

에셋을 수정하면 플러그인이 수동 checkout 없이 자동으로 서버 측 잠금을 설정합니다. 작업에 집중하는 동안 플러그인이 조용히 잠금을 처리합니다.

시각적 Blueprint 차이 비교

Blueprint의 두 리비전을 에디터의 표준 시각적 차이 비교 도구로 Unreal 내에서 직접 비교합니다. 히스토리의 어떤 커밋에서도 작동합니다.

checkin 전 검증

전송할 때마다 플러그인은 수정된 파일에 대해 일련의 검사를 실행합니다: Blueprint 컴파일, 명명 규칙, 텍스처 크기, 누락된 종속성, 순환 종속성 등. 오류는 checkin을 차단하고, 경고는 주의 사항으로 표시됩니다. 규칙은 desktop 클라이언트의 Admin 패널에서 프로젝트별로 활성화하고 구성할 수 있습니다.

redirector 정리

에셋의 이름을 바꾸거나 이동하면 Unreal이 쌓이기 쉬운 redirector를 생성합니다. 플러그인은 checkin 시점에 이를 자동으로 감지하고 정리하며, 영향을 받는 모든 에셋의 참조를 업데이트합니다.

시작 시 조정

프로젝트가 열리면 플러그인은 에셋의 상태를 확인하고 상태를 서버와 동기화합니다. 편집 중이던 파일은 자동으로 다시 잠기며, 이는 팀원이 여러분이 시작한 작업을 실수로 가져가는 것을 방지합니다.

잠금 해제 요청

팀원이 잠근 에셋을 수정하려는 경우, 플러그인을 통해 해제 요청을 보낼 수 있습니다. 알림이 팀원의 desktop 클라이언트에 도착합니다.

자주 발생하는 문제

« Failed to connect to source control »

desktop 클라이언트에 제대로 로그인되어 있는지 확인하세요. 자격 증명을 보유하는 것은 클라이언트입니다.

플러그인이 업데이트되지 않음

먼저 Unreal 에디터를 닫으세요: 플러그인은 로드된 상태에서는 교체할 수 없습니다. 그런 다음 desktop 클라이언트의 Unreal 패널에서 플러그인 상태 배지를 클릭하여 검사를 다시 실행하고 업데이트를 적용하세요.