블루프린트 에디터 인터페이스

이제 블루프린트의 개념을 이해했으니, 실제 작업 공간인 블루프린트 에디터를 볼 차례입니다.

블루프린트 에디터는 노드 작성, 데이터 관리, 컴포넌트 조정까지 한 화면에서 처리할 수 있도록 설계된 전용 편집 환경입니다.

각 패널의 역할만 정확히 파악해도 작업 속도와 디버깅 효율이 크게 달라집니다.

블루프린트 에디터는 여러 패널로 구성되며, 각 패널은 서로 다른 목적을 담당합니다.

요리에서 칼, 도마, 팬이 역할을 나눠 갖듯이 에디터의 패널도 고유한 책임을 가지고 협업합니다.

아래에서 핵심 패널을 하나씩 짚어 보겠습니다.

Blueprint Editor 작업 흐름

각 패널의 책임을 알면 노드를 찾고, 값을 조정하고, 결과를 확인하는 이동 경로가 짧아진다.

1. 1
   Components:

   액터를 구성하는 기능 단위를 고른다.

2. 2
   Event Graph

   벤트와 액션을 노드로 연결하는 중심 공간

3. 3
   Details:

   선택한 노드와 컴포넌트 속성을 조정한다.

---

컴포넌트 패널

이 패널은 현재 작업 중인 블루프린트 액터(Actor)가 어떤 컴포넌트(Component)로 구성되는지 보여줍니다.

컴포넌트는 액터에 기능과 시각 요소를 붙이는 단위입니다.

예를 들어 움직임을 담당하는 Movement Component, 3D 모델을 표시하는 Static Mesh Component, 광원을 담당하는 Point Light Component가 대표적입니다.

컴포넌트 패널에서는 새로운 컴포넌트를 추가하거나, 기존 컴포넌트의 계층 구조를 변경하고, 특정 컴포넌트를 선택하여 디테일 패널에서 속성을 편집할 수 있습니다.

이는 마치 레고 블록으로 건물을 짓듯이, 필요한 기능을 가진 부품들을 조립하는 과정과 같습니다.

---

디테일 패널

선택된 노드, 변수, 컴포넌트 등의 상세 속성을 표시하고 편집할 수 있는 패널입니다.

블루프린트의 핵심적인 작업 공간 중 하나이며, 특정 기능의 작동 방식을 세밀하게 조정할 때 주로 사용됩니다.

예를 들어, Static Mesh Component를 선택하면 어떤 3D 모델을 사용할지, 그 모델의 크기는 얼마로 할지 등의 속성을 이곳에서 설정할 수 있습니다.

이 패널을 통해 개발자는 블루프린트의 각 요소가 어떤 값을 가질지, 어떻게 동작할지를 직관적으로 제어할 수 있습니다.

마치 자동차의 대시보드에서 속도, 연료량, 엔진 상태 등을 확인하고 조작하는 것과 비슷합니다.

---

변수/함수/매크로 패널

이 패널은 현재 블루프린트에 정의된 변수(Variables), 함수(Functions), 매크로(Macros) 목록을 보여줍니다.

• 변수: 게임 내에서 변하는 데이터를 저장하는 공간입니다. 플레이어의 체력, 점수, 오브젝트의 색상 등 다양한 정보를 변수로 관리할 수 있습니다.
• 함수: 특정 작업을 수행하는 코드 블록을 그룹화한 것입니다. 자주 사용하는 로직을 함수로 만들어두면 재사용성이 높아지고 코드의 가독성이 좋아집니다.
• 매크로: 여러 노드를 하나의 재사용 가능한 블록으로 묶는 기능입니다. 함수와 유사하지만, 입력과 출력 핀에 대한 유연성이 더 높다는 특징이 있습니다.

이 패널을 통해 필요한 변수나 함수를 빠르게 찾아 드래그 앤 드롭으로 그래프에 배치하거나, 새로운 변수나 함수를 생성하고 관리할 수 있습니다.

---

이벤트 그래프

블루프린트 에디터 역할 구조

블루프린트 에디터는 컴포넌트 구성, 변수 관리, 이벤트 그래프, 상세 설정이 한 화면에서 맞물리는 작업 공간입니다.

1. 컴포넌트 구조

   액터에 붙은 Mesh, Collision, Camera 같은 구성요소를 먼저 확인합니다.

2. 변수와 함수

   My Blueprint에서 상태와 재사용 동작이 어디에 있는지 찾습니다.

3. 이벤트 그래프

   BeginPlay, Tick, 입력 이벤트에서 실행선이 어떻게 이어지는지 읽습니다.

4. 디테일 조정

   선택한 노드나 컴포넌트의 속성을 Details에서 마무리합니다.

블루프린트 에디터의 중심이자, 비주얼 스크립팅이 실제로 이루어지는 핵심 작업 공간입니다.

이곳에서 노드들을 배치하고 선으로 연결하여 게임 로직을 구현합니다.

이벤트(Event)에 반응하여 어떤 행동(Action)을 취할지를 시각적으로 설계하는 곳이죠.

예를 들어, 키보드 특정 키가 눌렸을 때 (Event) → 캐릭터가 점프한다 (Action)와 같은 일련의 흐름을 이벤트 그래프에서 노드로 표현하게 됩니다.

대부분의 블루프린트 개발 작업이 이 이벤트 그래프에서 이루어집니다.

---

뷰포트 패널

액터 블루프린트(Actor Blueprint)에서는 뷰포트 패널을 통해 3D 모델과 컴포넌트 배치를 직접 확인할 수 있습니다.

월드에 배치됐을 때의 모습을 미리 보고, 컴포넌트의 위치, 회전, 크기를 즉시 조정할 수 있기 때문에 반복 확인 비용이 크게 줄어듭니다.

실시간 확인과 수정이 가능하다는 점이 블루프린트 워크플로우의 큰 장점입니다.

---

패널 숙련 루틴

처음에는 모든 패널을 동시에 쓰기보다 다음 순서로 반복하면 학습 효율이 높습니다.

1. 이벤트 그래프에서 최소 노드 흐름 작성
2. 디테일 패널에서 노드/컴포넌트 속성 조정
3. 뷰포트 패널에서 배치 결과 확인
4. 변수/함수/매크로 패널로 중복 로직 정리

패널 이동은 기능 추가 순서에 맞춰 짧게 반복한다

처음부터 모든 패널을 외우기보다 그래프 작성, 속성 조정, 결과 확인, 중복 정리 순서로 고정하면 에디터 탐색 부담이 줄어듭니다.

1. 1
   최소 노드 흐름 작성

   Event Graph 입력 이벤트와 실행할 액션만 먼저 연결해 동작의 뼈대를 만듭니다.

2. 2
   선택 항목 속성 조정

   Details 노드, 변수, 컴포넌트를 선택한 뒤 필요한 값만 세밀하게 바꿉니다.

3. 3
   배치 결과 확인

   Viewport 컴포넌트 위치, 회전, 크기와 실제 화면 반응을 짧게 검증합니다.

4. 4
   중복 로직 정리

   My Blueprint 반복되는 값과 흐름을 분리한 뒤 다음 기능은 01부터 다시 시작합니다.

이 루틴을 유지하면 패널 간 이동이 목적 중심으로 정리되어 디버깅 속도가 빨라집니다.

수정 대상을 먼저 말하면 열어야 할 패널이 정해진다

패널 위치보다 “구성·값·로직·배치 중 무엇을 바꾸는가?”를 먼저 묻는다. 목적을 정하면 시작 패널과 확인 방법도 따라온다.

1. 구성
   Components

   구성 Components Mesh·Collision·Camera를 추가하고 계층을 잡은 뒤 Viewport에서 형태를 본다.

2. 값
   Details

   값 Details 선택한 노드나 컴포넌트의 숫자·참조·옵션을 고치고 선택 대상을 다시 확인한다.

3. 로직
   Event Graph

   직 Event Graph 이벤트에서 조건과 액션을 연결하고 Play 또는 디버거로 실제 실행 경로를 본다.

4. 배치
   Viewport

   배치 Viewport 위치·회전·크기를 조정하고 월드에 놓였을 때의 모습과 충돌 범위를 확인한다.

---

블루프린트 에디터는 패널들이 유기적으로 연결되어 하나의 작업 흐름을 만듭니다.

처음에는 화면이 복잡해 보일 수 있지만, 패널별 역할을 이해하고 반복 사용하면 빠르게 익숙해집니다.

다음 절에서는 이 에디터를 사용해 블루프린트를 직접 생성해 보겠습니다.

패널 작업 기준 메모

블루프린트 에디터를 처음 다룰 때는 화면 구성 암기보다 작업 순서를 고정하는 것이 더 효과적입니다.

• 이벤트 그래프에서 최소 동작을 먼저 만들고, 디테일 패널 조정은 그다음에 진행합니다.
• 변수/함수 추가는 '중복 로직 제거'가 필요한 시점에만 수행하여 그래프 복잡도를 통제합니다.
• 뷰포트 확인은 기능 추가 직후마다 짧게 반복해 회귀를 즉시 발견합니다.

블루프린트 다음 절 연결 메모

다음 절에서는 블루프린트 생성과 기본 노드 연결을 실습합니다.

이번 절의 패널 역할 구분을 유지하면 실습 속도와 정확도를 동시에 확보할 수 있습니다.

노드 추가 전 입력/출력 흐름을 한 줄로 먼저 적어두면 그래프 재작업 빈도를 크게 줄일 수 있습니다.

마무리 점검 다이어그램

에디터 패널 사용 체크

블루프린트 에디터는 패널마다 책임이 다르므로 수정 위치를 먼저 고르면 실수가 줄어듭니다.

1. 구조 기준

   패널 역할 구조 컴포넌트 패널에서는 액터가 가진 부품과 계층을 확인합니다.

2. 속성 기준

   속성 디테일 패널에서는 선택한 항목의 기본값과 노출 옵션을 조정합니다.

3. 로직 기준

   직 이벤트 그래프에서는 실제 실행 흐름과 노드 연결을 검증합니다.

블루프린트 에디터 패널을 작업 목적별로 이동하는 기준을 덧붙입니다.

Viewport와 Details는 선택한 액터를 보고 수정하는 기본 동선이다

화면에서 액터를 고르고, Details에서 위치·컴포넌트·속성을 바꾸며, Outliner로 계층을 확인한다.

1. 화면 선택 영역
   화면 선택 영역 레벨 안 액터

   보고 선택

2. 액터 계층 목록
   액터 계층 목록 현재 레벨의 액터 목록

   계층

3. 선택 속성 패널
   선택 속성 패널 선택한 액터의 속성

   컴포넌트 설정

4. 에셋 배치 목록
   에셋 배치 목록 에셋

   찾아 레벨이나 BP에 배치

기준	해석
선택 후 수정 루틴	선택 → 속성 수정 → 플레이 확인
레벨/에셋 편집 구분	레벨 액터 수정과 Blueprint asset 수정 구분
Details 표시 결정 기준	어디를 선택했는지가 Details 내용을 결정한다

블루프린트 에디터에서는 패널마다 책임이 다르므로, 수정하려는 대상이 구성인지 값인지 로직인지 먼저 나눕니다.

Blueprint Editor는 Components, Graph, Details가 함께 움직인다

컴포넌트를 고르면 Details가 구성 요소 설정을, 그래프 노드를 고르면 노드 입력과 옵션을 보여준다.

1. Components
   Components

   BP가 가진 Mesh, Collision, Camera 목록

2. Graph
   Graph Event

   함수 노드를 연결하는 실행 공간

3. My Blueprint
   My Blueprint 변수, 함수, 매크로

   벤트 목록

4. Details
   Details 선택 대상의 속성

   노출 옵션

기준	해석
읽는 기준	선택 대상이 무엇인지 먼저 확인
작업 기준	구성은 Components, 동작은 Graph
핵심	패널은 따로 놀지 않고 선택 상태를 공유한다