애니메이션 블루프린트 에디터(Animation Blueprint Editor) 는 블루프린트 에디터(Blueprint Editor)와 기능이 유사하지만 캐릭터 애니메이션 스트립팅에 도움이 되는 몇 가지 다른 기능, 툴, 창을 포함합니다.
이 문서에서는 애니메이션 블루프린트 에디터 인터페이스의 사용법을 간략히 살펴봅니다.
전제조건
- 애니메이션 블루프린트를 만들어서 열어두어야 합니다.
- 블루프린트 비주얼 스크립팅(Blueprint Visual Scripting)에 대한 기본적인 이해가 있어야 합니다. 애니메이션 블루프린트 에디터의 인터페이스와 행동 다수는 여기서 파생됩니다.
애니메이션 블루프린트를 열면 다음과 같은 인터페이스가 표시됩니다.

- 툴바 에는 애니메이션 블루프린트 관리 및 에디터 타입 전환을 위한 버튼이 있습니다.
- 뷰포트(Viewport) 에서는 캐릭터의 애니메이션 블루프린트 로직의 행동을 프리뷰할 수 있습니다. 보다 자세한 정보는 애니메이션 에디터 페이지의 뷰포트 섹션을 참조하세요.
- 내 블루프린트(My Blueprint) 는 블루프린트 에디터에서도 찾아볼 수 있으며 그래프, 함수, 변수 및 기타 애니메이션 블루프린트 내의 관련된 프로퍼티 목록을 포함합니다. 또한 여기 있는 포즈 워치 매니저(Pose Watch Manager) 패널에 관한 자세한 정보는 애니메이션 단축키 및 팁 페이지를 참조하세요.
- 그래프 에는 애니메이션 블루프린트 내 비주얼 스크립팅을 위한 여러 종류의 그래프가 표시됩니다.
- 디테일(Details) 에는 선택된 항목의 프로퍼티가 표시됩니다..
- 애님 프리뷰 에디터(Anim Preview Editor) 에서는 변수 및 클래스 디폴트를 변경할 수 있습니다. 별도의 탭으로 도킹되어 있는 에셋 브라우저(Asset Browser) 에서 이 스켈레톤과 연관된 애니메이션 에셋을 보고 열 수 있습니다. 자세한 정보는 애니메이션 시퀀스 에디터 페이지의 에셋 에디터(Asset Editor) 섹션을 참조하세요.
툴바
툴바에서는 블루프린트를 컴파일 및 저장 하고, 콘텐츠 브라우저 의 애니메이션 블루프린트 에셋을 찾고, 클래스 세팅 및 클래스 디폴트 세팅을 정의합니다. 여기 있는 여러 버튼과 툴은 프리뷰 메시 등 대다수 애니메이션 에디터에서 공통적으로 나타납니다. 공통 메뉴에 대한 자세한 정보는 애니메이션 에디터 툴바 섹션을 참조하세요.

애니메이션 블루프린트 에디터 툴바에는 다음과 같은 버튼 및 메뉴가 있습니다.
이름 | 아이콘 | 설명 |
---|---|---|
컴파일 | ![]() |
이 애니메이션 블루프린트를 컴파일합니다. 이 아이콘은 블루프린트의 컴파일 상태에 따라 달라집니다. 대부분의 경우 그래프가 변경되면 리컴파일해야 합니다. 옵션 메뉴를 클릭하면 컴파일 시의 추가 행동이 표시됩니다. 컴파일시 저장(Save On Compile) 은 애니메이션 블루프린트를 컴파일할 때 자동으로 저장합니다. 오류 노드로 점프(Jump to Error Node) 를 활성화하여 컴파일 성공을 방해하는 그래프를 자동으로 프레이밍할 수도 있습니다. ![]() |
버전비교 | ![]() |
언리얼 엔진에서 소스 컨트롤 패키지를 사용하는 경우 이 드롭다운 메뉴로 현재 애니메이션 블루프린트를 이전 리비전과 비교할 수 있습니다. |
찾기 | ![]() |
모든 그래프에서 함수, 이벤트, 변수, 노드, 핀에 대한 레퍼런스를 찾을 수 있는 검색 패널을 엽니다. Ctrl + F 를 눌러도 됩니다. 또한 Ctrl + Shift + F 를 누르면 프로젝트 내의 모든 블루프린트, 애니메이션 등을 검색할 수 있는 창이 열립니다. |
관련 없는 노드 숨김 | ![]() |
이 항목을 활성화하면 현재 선택되지 않았거나 그래프에서 선택된 노드와 직접 링크되지 않은 모든 노드가 페이드 아웃됩니다. 옵션 메뉴에서 노드 상태 잠금(Lock Node State) 을 활성화하여 이후 선택과 무관하게 모든 노드의 현재 숨겨진 상태를 유지할 수 있습니다. ![]() |
클래스 세팅 | ![]() |
클릭하면 여러 블루프린트 클래스 세팅이 디테일 패널에 노출됩니다. 이 프로퍼티 대부분은 일반적인 블루프린트 클래스 세팅입니다. 하지만 다음 세팅은 애니메이션 블루프린트 전용 세팅입니다.
|
클래스 디폴트 | ![]() |
클릭하면 블루프린트 클래스의 디폴트 변수를 포함하는 블루프린트 변수가 디테일 패널에 노출됩니다.
|
플레이/시뮬레이트 | ![]() |
이 버튼은 에디터 내 테스팅 프레임워크를 사용하여 애니메이션 블루프린트를 플레이하거나 시뮬레이션하는 데 쓸 수 있습니다. |
디버그 오브젝트 | ![]() |
이 드롭다운 메뉴는 애니메이션 블루프린트 뷰포트를 시뮬레이션 또는 플레이 중인 세션의 활성 애니메이션 인스턴스에 링크합니다. 그러면 컨트롤 릭 뷰포트에서 해당 세션의 현재 애니메이션 프리뷰를 볼 수 있습니다. 또한 그래프 노드는 입력 및 세션에서 발생한 변경사항에 반응하므로 그래프 및 캐릭터 스테이트를 디버그할 수 있습니다. |
애니메이션 에디터/블루프린트 | ![]() |
스켈레톤의 애니메이션 블루프린트를 만들 때 이 버튼은 애니메이션 에디터 모드 영역 내에서 선택 가능 에디터 타입으로 표시됩니다. 여기를 클릭하면 애니메이션 블루프린트가 열립니다. 두 개 이상의 애니메이션 블루프린트가 이 스켈레톤을 사용한다면 이 버튼 옆의 옵션 드롭다운 메뉴를 클릭하고 특정 블루프린트를 선택해도 됩니다. |
그래프
그래프 패널에서는 게임플레이 중에 캐릭터를 제어할 로직을 생성합니다. 그래프에는 세 가지 주요 타입이 있으며, 서로 인터페이스가 다릅니다.
-
이벤트 그래프(Event Graph) 에서는 블루프린트 기반 로직을 구성하여 다른 그래프 영역에 정보를 제공하는 노드 프로퍼티 및 변수를 정의합니다.
-
애님 그래프(Anim Graph) 에서는 현재 프레임에서 스켈레탈 메시의 최종 포즈를 평가하는 포즈 기반 로직을 구성합니다.
-
스테이트 머신(State Machines) 에서는 스테이트 기반 로직을 구성합니다. 보통 로코모션에 쓰입니다.
여러 그래프 타입 및 애니메이션 블루프린트에서의 그래프 작업에 대한 자세한 정보는 애니메이션 블루프린트에서 그래프 사용하기 및 스테이트 머신 페이지를 참조하세요.
애님 프리뷰 에디터
애님 프리뷰 에디터에서는 뷰포트에서 스켈레탈 메시를 업데이트하는 변수를 변경할 수 있습니다(클래스 디폴트 포함).

프리뷰 편집(Edit Preview) 을 클릭하면 이 패널의 행동이 변경되어 변수를 일시적으로만 편집하게 됩니다. 원본이 손상되는 편집 없이 여러 변수 상태를 프리뷰하려고만 할 때 유용합니다. 변경할 때 해당 변경 사항을 디폴트로 적용할 것인지 선택할 수 있는 프롬프트가 표시됩니다.
