언리얼 에디터와 주요 패널 이해
뷰포트·월드 아웃라이너·디테일·콘텐츠 브라우저의 역할을 익혀 기본 편집 작업 흐름을 구성합니다.
첫 번째 C++ 프로젝트 생성이 완료되었으므로, 이제 언리얼 엔진 개발 환경의 핵심인 언리얼 에디터(Unreal Editor)를 자세히 살펴봅니다.
언리얼 에디터는 게임 월드 구성, 에셋 배치, 게임플레이 테스트를 수행하는 통합 개발 도구입니다.
비주얼 스튜디오가 코드를 작성하는 공간이라면, 언리얼 에디터는 그 코드가 실제 동작으로 연결되는 장면을 시각적으로 구성하는 공간입니다.
패널 이름을 외우기보다 선택한 액터가 배치·구조·속성·에셋·실행 결과로 어떻게 이어지는지 본다.
- Compile / Play
코드 반영 뒤 동일한 레벨과 액터로 실행 결과를 재현한다.
- Viewport
월드 결과 액터의 배치, 이동, 충돌, 플레이 결과를 공간 안에서 확인한다.
- Outliner
선택 레벨 계층에서 검증할 액터를 찾는다.
- Details
상태 선택한 액터의 컴포넌트와 노출 속성을 대조한다.
- Content Browser
C++ 클래스, 블루프린트, 에셋이 같은 프로젝트 경로에 있는지 확인한다.
언리얼 에디터는 다양한 기능을 수행하는 여러 패널(Panel)들로 구성되어 있습니다.
이 패널들을 이해하고 효율적으로 사용하는 것이 언리얼 엔진 개발의 생산성을 높이는 데 핵심적인 역할을 합니다.
가장 기본적이고 자주 사용되는 패널들을 위주로 하나씩 살펴보겠습니다.
뷰포트(Viewport) 패널
언리얼 에디터를 열면 가장 크고 중앙에 위치한 것이 바로 뷰포트 패널입니다.
마치 3D 공간을 들여다보는 창문과 같습니다.
여러분이 만들고 있는 게임 월드의 모습을 실시간으로 보여주며, 이 안에서 액터(Actor)들을 배치하고, 이동하고, 회전하고, 크기를 조절하는 등 모든 시각적인 작업을 수행하게 됩니다.
- 탐색(Navigation): 마우스 오른쪽 버튼을 누른 채 WASD 키를 사용하여 게임처럼 자유롭게 이동할 수 있습니다. 마우스 휠을 스크롤하여 확대/축소하거나, ALT 키와 마우스 왼쪽/오른쪽 버튼을 조합하여 카메라를 회전시키고 팬(Pan)할 수 있습니다. 익숙해질 때까지 꾸준히 연습하는 것이 중요합니다.
- 기즈모(Gizmo): 뷰포트에서 액터를 선택하면 이동(W), 회전(E), 스케일(R)을 조절할 수 있는 기즈모가 나타납니다. 이 기즈모를 사용하여 액터를 직관적으로 조작할 수 있습니다.
월드 아웃라이너(World Outliner) 패널
월드 아웃라이너 패널은 현재 레벨(Level, 언리얼 엔진에서는 맵을 레벨이라고 부릅니다)에 존재하는 모든 액터의 목록을 트리(Tree) 구조로 보여줍니다.
마치 파일 탐색기처럼, 레벨에 있는 모든 오브젝트를 한눈에 파악하고 관리할 수 있습니다.
- 선택 및 검색: 월드 아웃라이너에서 액터를 클릭하면 뷰포트에서 해당 액터가 선택됩니다. 반대로 뷰포트에서 액터를 선택하면 월드 아웃라이너에서도 해당 액터가 강조됩니다. 상단의 검색창을 이용하면 특정 액터를 쉽게 찾아낼 수 있습니다.
- 계층 구조: 액터들은 부모-자식 관계를 가질 수 있으며, 월드 아웃라이너는 이러한 계층 구조를 시각적으로 보여줍니다. 예를 들어, 문이 달린 건물은 건물이 부모 액터이고 문이 자식 액터가 될 수 있습니다.
- 가시성 제어: 각 액터 옆의 눈 모양 아이콘을 클릭하여 뷰포트에서의 가시성을 켜고 끌 수 있습니다. 작업을 용이하게 하기 위해 특정 액터를 잠시 숨길 때 유용합니다.
디테일(Details) 패널: 액터의 모든 속성
어떤 액터를 선택하든, 디테일 패널은 해당 액터의 모든 속성(Property)과 설정(Setting)을 표시하고 편집할 수 있도록 해줍니다.
이 패널은 언리얼 에디터에서 가장 많이 사용될 패널 중 하나입니다.
- 변수(Variable) 조작: 액터의 위치, 회전, 스케일과 같은 변수는 물론, 메시, 머티리얼, 물리 설정 등 다양한 속성을 이곳에서 직접 변경할 수 있습니다.
- 컴포넌트(Components): 액터에 부착된 컴포넌트 목록을 보여주며, 새로운 컴포넌트를 추가하거나 기존 컴포넌트의 속성을 조작할 수 있습니다. C++로 컴포넌트를 만들고 부착하면 이 패널에서 코드 구조가 시각적으로 표시됩니다.
- 이벤트(Events): 블루프린트 스크립팅과 관련된 이벤트들을 추가하고 편집할 수 있습니다.
콘텐츠 브라우저(Content Browser) 패널
콘텐츠 브라우저는 여러분의 프로젝트에 사용되는 모든 에셋(Asset)들을 관리하는 패널입니다.
3D 모델(메시), 텍스처, 머티리얼, 사운드, 애니메이션, 블루프린트 클래스, C++ 클래스 등 모든 종류의 에셋이 이곳에 저장되고 관리됩니다.
- 에셋 임포트 및 생성: 외부에서 제작된 에셋(예: 3D 모델)을 프로젝트로 가져오거나, 언리얼 에디터 내에서 새로운 에셋(예: 머티리얼, 블루프린트)을 생성할 수 있습니다.
- 탐색 및 검색: 폴더 구조를 통해 에셋을 분류하고, 강력한 검색 및 필터링 기능을 통해 필요한 에셋을 빠르게 찾을 수 있습니다.
- C++ 클래스 생성: C++ 클래스를 생성할 때도 콘텐츠 브라우저에서 마우스 오른쪽 버튼을 클릭하여 컨텍스트 메뉴를 통해 진행하게 됩니다. 우리가 직접 작성할 C++ 코드 파일들 또한 이 콘텐츠 브라우저와 연동됩니다.
컴파일 및 플레이 버튼
언리얼 에디터 상단 툴바에는 게임 개발의 핵심적인 버튼들이 있습니다.
- 컴파일(Compile) 버튼: C++ 코드를 수정한 후에는 이 버튼을 눌러 코드를 컴파일해야 합니다. 컴파일이 성공적으로 완료되면, 여러분이 작성한 C++ 코드가 게임 내에 적용됩니다. 이는 비주얼 스튜디오에서 빌드하는 것과 유사한 과정이며, 언리얼 에디터 내에서 더 빠르게 반복 작업을 할 수 있도록 돕습니다.
- 플레이(Play) 버튼: 현재 레벨을 미리보기 모드로 실행합니다. 여러분이 구현한 게임 로직이나 배치한 액터들이 어떻게 동작하는지 직접 확인하고 테스트할 수 있습니다.
Alt + P단축키는 매우 자주 사용될 테니 기억해두는 것이 좋습니다.
에디터 레이아웃 커스터마이징
언리얼 에디터의 패널들은 드래그 앤 드롭으로 자유롭게 위치를 변경하거나, 도킹(Docking)하거나, 새 창으로 분리할 수 있습니다.
여러분의 작업 스타일에 맞춰 패널 레이아웃을 최적화하여 효율적인 작업 환경을 구축할 수 있습니다.
상단 메뉴의 창(Window)에서 원하는 패널을 켜거나 끌 수 있습니다.
패널 탐색 우선순위
C++ 프로젝트에서는 패널을 따로 보지 말고 코드 작성, 컴파일, 배치, 테스트가 돌아가는 순환 구조로 이해해야 합니다.
- C++ Class
- Editor Details
- Play & Log
- 클래스 작성
헤더에 노출할 속성과 함수의 책임을 먼저 정리합니다.
- 컴파일 확인
에디터 컴파일 또는 IDE 빌드로 반영 상태를 봅니다.
- 레벨 배치
Outliner와 Details에서 C++ 액터가 의도대로 노출되는지 확인합니다.
- 플레이 검증
Play와 Output Log로 런타임 동작과 경고를 확인합니다.
처음에는 모든 패널을 동시에 보려 하기보다, 아래 순서로 익히면 학습 부담이 줄어듭니다.
Viewport에서 액터 배치 결과를 먼저 확인World Outliner로 액터 구조를 정리Details에서 값 조정 후 즉시 다시 뷰포트 검증
이 순서를 고정하면 C++ 코드를 수정한 뒤 에디터에서 결과를 검증하는 반복 루프가 훨씬 빨라집니다.
이제 언리얼 에디터의 주요 패널들과 그 역할에 대해 기본적인 이해를 하셨을 겁니다.
에디터에서 각 패널을 직접 열어 보고, C++ 코드 변경 결과가 에디터에 어떻게 반영되는지 다음 장에서 실습합니다.
다음 장에서는 본격적으로 C++ 코드를 활용하여 언리얼 엔진에서 무언가를 만들어보는 실습에 돌입할 것입니다.
에디터 패널 운용 기준
컴파일 성공만 보지 말고 Viewport, Outliner, Details, Output Log가 같은 인스턴스를 가리키는지 확인한다.
| 패널 | 확인할 증거 | 어긋날 때 의심할 것 |
|---|---|---|
| Viewport | 배치, 이동, 충돌, 입력 반응이 화면에 보인다 | 다른 레벨이나 다른 액터를 보고 있다 |
| World Outliner | 선택한 액터가 방금 고친 클래스 인스턴스다 | 중복 배치 또는 이전 BP 인스턴스다 |
| Details | UPROPERTY 값과 컴포넌트 설정이 노출된다 | 지정자, 카테고리, 재컴파일 상태가 맞지 않다 |
| Output Log | 화면에서 본 인스턴스의 실행 로그가 남는다 | 로그는 맞지만 화면 대상이 다르다 |
언리얼 C++ 실습에서는 에디터 패널을 코드 검증 루프에 연결하는 습관이 중요합니다.
- 코드 수정 후에는 Viewport와 Details에서 결과를 즉시 검증합니다.
- World Outliner 정렬 규칙을 고정해 오브젝트 추적 비용을 줄입니다.
- 패널 배치를 프로젝트 초기에 확정해 반복 작업 손실을 줄입니다.
아래 다이어그램은 C++ 수정 이후 에디터에서 어떤 패널을 차례로 보며 결과를 확인할지 정리합니다.
컴파일 성공은 출발점이다. 실제 반영 여부는 Viewport의 배치, Outliner의 구조, Details의 노출 값, Content Browser의 에셋 연결을 묶어서 봐야 빠르게 분리된다.
- 1빌드 통과 확인
Compile 에디터 컴파일 또는 IDE 빌드 결과를 먼저 확인한다.
- 2액터 선택 또는 재배치
Place 기존 액터를 다시 선택하거나 새 액터를 레벨에 놓는다.
- 3패널 값 교차 확인
Inspect Outliner와 Details에서 코드 반영 상태를 함께 본다.
- 4동작 결과로 마무리
Play Viewport에서 플레이하며 화면 결과와 로그를 맞춰 본다.
에디터 패널과 C++ 작업 연결
에디터 패널은 단순한 UI가 아니라 C++ 클래스, 에셋, 로그를 확인하는 작업 창입니다.
패널 이름을 외우기보다 C++ 변경 결과가 어느 화면에 반영되는지 연결해 보는 습관이 중요하다.
| 패널 | 역할 | C++ 실습에서 볼 것 |
|---|---|---|
| Viewport | 레벨에 배치된 액터와 Play 결과를 본다 | 위치, 충돌, 입력 반응 |
| Outliner | 현재 월드의 액터 목록과 선택 대상을 추적한다 | 방금 만든 클래스 인스턴스 |
| Details | 노출한 값과 컴포넌트 설정을 조정한다 | UPROPERTY 카테고리와 권한 |
| Content Browser | C++ 기반 BP, 머티리얼, 위젯 에셋을 관리한다 | 클래스 기반 에셋의 위치 |