icon

안동민 개발노트

1장 : 블루프린트 입문

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


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

블루프린트 에디터는 노드 작성, 데이터 관리, 컴포넌트 조정까지 한 화면에서 처리할 수 있도록 설계된 전용 편집 환경입니다. 각 패널의 역할만 정확히 파악해도 작업 속도와 디버깅 효율이 크게 달라집니다.

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

요리에서 칼, 도마, 팬이 역할을 나눠 갖듯이 에디터의 패널도 고유한 책임을 가지고 협업합니다. 아래에서 핵심 패널을 하나씩 짚어 보겠습니다.


컴포넌트 패널

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

컴포넌트는 액터에 기능과 시각 요소를 붙이는 단위입니다. 예를 들어 움직임을 담당하는 Movement Component, 3D 모델을 표시하는 Static Mesh Component, 광원을 담당하는 Point Light Component가 대표적입니다.

컴포넌트 패널에서는 새로운 컴포넌트를 추가하거나, 기존 컴포넌트의 계층 구조를 변경하고, 특정 컴포넌트를 선택하여 디테일 패널에서 속성을 편집할 수 있습니다. 이는 마치 레고 블록으로 건물을 짓듯이, 필요한 기능을 가진 부품들을 조립하는 과정과 같습니다.


디테일 패널

선택된 노드, 변수, 컴포넌트 등의 상세 속성을 표시하고 편집할 수 있는 패널입니다. 블루프린트의 핵심적인 작업 공간 중 하나이며, 특정 기능의 작동 방식을 세밀하게 조정할 때 주로 사용됩니다. 예를 들어, Static Mesh Component를 선택하면 어떤 3D 모델을 사용할지, 그 모델의 크기는 얼마로 할지 등의 속성을 이곳에서 설정할 수 있습니다.

이 패널을 통해 개발자는 블루프린트의 각 요소가 어떤 값을 가질지, 어떻게 동작할지를 직관적으로 제어할 수 있습니다. 마치 자동차의 대시보드에서 속도, 연료량, 엔진 상태 등을 확인하고 조작하는 것과 비슷합니다.


변수/함수/매크로 패널

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

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

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


이벤트 그래프

블루프린트 에디터의 중심이자, 비주얼 스크립팅이 실제로 이루어지는 핵심 작업 공간입니다. 이곳에서 노드들을 배치하고 선으로 연결하여 게임 로직을 구현합니다. 이벤트(Event)에 반응하여 어떤 행동(Action)을 취할지를 시각적으로 설계하는 곳이죠.

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


뷰포트 패널

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

월드에 배치됐을 때의 모습을 미리 보고, 컴포넌트의 위치, 회전, 크기를 즉시 조정할 수 있기 때문에 반복 확인 비용이 크게 줄어듭니다. 실시간 확인과 수정이 가능하다는 점이 블루프린트 워크플로우의 큰 장점입니다.


패널 숙련 루틴

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

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

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


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

처음에는 화면이 복잡해 보일 수 있지만, 패널별 역할을 이해하고 반복 사용하면 빠르게 익숙해집니다. 다음 절에서는 이 에디터를 사용해 블루프린트를 직접 생성해 보겠습니다.

학습 밀도 보강 메모

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

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

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

다음 절에서는 블루프린트 생성과 기본 노드 연결을 실습합니다. 이번 절의 패널 역할 구분을 유지하면 실습 속도와 정확도를 동시에 확보할 수 있습니다. 노드 추가 전 입력/출력 흐름을 한 줄로 먼저 적어두면 그래프 재작업 빈도를 크게 줄일 수 있습니다.

목차