안동민 개발노트 아이콘

안동민 개발노트

1장 : 블루프린트 입문

첫 번째 블루프린트 생성 및 실행

이제 블루프린트 에디터의 주요 인터페이스를 살펴보았으므로 첫 블루프린트를 만들고 실행합니다. 기본 블루프린트를 생성하고 간단한 메시지를 출력해 이벤트 그래프의 실행 흐름을 확인합니다.

우리가 만들 첫 번째 블루프린트는 게임이 시작될 때 화면에 간단한 환영 메시지를 띄우는 액터 블루프린트가 될 것입니다.


새로운 액터 블루프린트 생성하기

언리얼 엔진에서 블루프린트를 만드는 방법은 매우 간단합니다.

콘텐츠 브라우저(Content Browser)를 엽니다. 이 패널은 언리얼 엔진 프로젝트의 모든 에셋(Asset)을 관리하는 곳입니다.

콘텐츠 브라우저의 빈 공간에서 마우스 오른쪽 버튼을 클릭합니다.

컨텍스트 메뉴에서 블루프린트 클래스(Blueprint Class)를 선택합니다.

부모 클래스 선택(Pick Parent Class) 창이 나타나면, 다양한 블루프린트의 종류 중 Actor를 선택합니다. Actor는 게임 월드에 배치될 수 있는 모든 오브젝트의 기본 클래스입니다.

새로 생성된 블루프린트 파일의 이름을 BP_WelcomeMessage라고 입력한 후 엔터를 누릅니다.

이제 콘텐츠 브라우저에 BP_WelcomeMessage라는 이름의 새로운 블루프린트 에셋이 생성된 것을 확인할 수 있습니다.


블루프린트 에디터 열기 및 이벤트 노드 추가

생성된 BP_WelcomeMessage 블루프린트 에셋을 더블클릭하여 블루프린트 에디터를 엽니다. 앞서 본 패널 구성이 표시됩니다.

우리는 게임이 시작될 때 메시지를 출력하고 싶으므로, 게임 시작 이벤트를 담당하는 노드를 추가해야 합니다.

이벤트 그래프(Event Graph) 패널로 이동합니다.

이벤트 그래프의 빈 공간에서 마우스 오른쪽 버튼을 클릭하여 컨텍스트 메뉴를 엽니다.

검색창에 BeginPlay를 입력합니다.

Event BeginPlay 노드를 선택하여 그래프에 추가합니다.

  • Event BeginPlay 노드는 이 블루프린트가 게임 월드에 배치되고 게임이 시작될 때(또는 시뮬레이션이 시작될 때) 딱 한 번 실행되는 특수한 이벤트 노드입니다.

메시지 출력 노드 연결하기

이제 Event BeginPlay 노드가 실행될 때 화면에 메시지를 출력하도록 만들어봅시다. 메시지 출력은 Print String 노드를 사용합니다.

Event BeginPlay 노드의 오른쪽에 있는 실행 핀(Execution Pin)을 마우스로 클릭한 채 드래그합니다.

마우스를 떼면 검색창이 나타나는데, 여기에 Print String을 입력하고 해당 노드를 선택합니다.

  • Print String 노드는 개발자가 디버깅 목적으로 화면에 문자열 메시지를 쉽게 출력할 수 있도록 도와주는 매우 유용한 노드입니다.

Print String 노드의 In String입력 핀에 주목해주세요. 이곳에 출력하고 싶은 메시지를 입력할 수 있습니다. 기본적으로 Hello라고 적혀 있을 텐데, 클릭하여 내용을 나 혼자 언리얼 블루프린트 시작! 으로 변경합니다.

이제 Event BeginPlay 노드의 실행 핀과 Print String 노드의 실행 핀이 흰색 선으로 연결되어, 게임 시작 시 Print String 노드가 실행되도록 설정되었습니다.


블루프린트 컴파일 및 저장

블루프린트 변경 사항을 적용하려면 컴파일(Compile) 과정이 필요합니다. 컴파일은 여러분이 만든 비주얼 스크립팅 로직을 언리얼 엔진이 이해할 수 있는 형태로 변환하는 과정입니다.

블루프린트 에디터의 좌측 상단에 있는 컴파일(Compile) 버튼을 클릭합니다.

컴파일이 성공하면 버튼 옆에 초록색 체크 표시가 나타납니다.

그 옆에 있는 저장(Save) 버튼을 클릭하여 작업 내용을 저장합니다.


블루프린트를 레벨에 배치하고 실행하기

마지막으로, 우리가 만든 블루프린트가 게임 내에서 작동하도록 레벨에 배치해야 합니다.

블루프린트 에디터를 닫고 언리얼 엔진 메인 에디터로 돌아옵니다.

콘텐츠 브라우저에서 BP_WelcomeMessage 에셋을 찾아 마우스로 드래그하여 뷰포트(Viewport)로 끌어다 놓습니다.

이제 메인 에디터 상단의 플레이(Play) 버튼을 클릭하여 게임을 시작합니다.

게임을 실행하면, 화면 좌측 상단에 우리가 입력했던 나 혼자 언리얼 블루프린트 시작!이라는 메시지가 잠시 나타났다가 사라지는 것을 확인합니다. 이벤트 그래프와 출력 문자열이 정상적으로 연결된 상태입니다.


이번 절에서는 블루프린트를 생성하고 간단한 로직을 구현해 실행하는 과정을 실습했습니다. 컴파일, 배치, 실행 결과 확인이 기본 작업 흐름입니다.

마무리 점검 다이어그램

첫 번째 블루프린트가 실제로 실행되는지 확인하는 검수표를 추가합니다.

첫 블루프린트 실습은 에셋 생성, 이벤트 연결, 컴파일, 레벨 배치, 플레이 확인이 하나의 루프로 이어져야 합니다.