캐릭터 애니메이션 적용

애니메이션 블루프린트 이해하기

1️⃣ 애니메이션 블루프린트 (Anim Blueprint)란?

애니메이션 블루프린트는 언리얼 엔진에서 캐릭터의 골격(스켈레톤) 기반 애니메이션을 시각적으로 설계하는 데 특화된 전용 Blueprint입니다.
일반 블루프린트가 게임 로직 (Game Logic)(예: 캐릭터의 이동, 공격, 상호작용)을 시각적으로 구현하는 것과 유사하게, 애니메이션 블루프린트는 캐릭터의 골격 움직임과 모션 전이(Transition) 등을 그래프나 State Machine을 통해 손쉽게 구현하도록 돕습니다.
보통은 스켈레탈 메시, 애니메이션 시퀀스, State Machine 등을 연결하는 “중간 다리” 역할을 하며, 캐릭터가 달리는 동작, 점프하는 동작, 아이들(Idle) 동작 등을 매끄럽게 전환시키는 다양한 로직을 담게 됩니다.

2️⃣ 애니메이션 블루프린트 생성

Content Browser에서 우클릭 → Animations → Animation Blueprint를 선택하여 새 애니메이션 블루프린트를 생성합니다.
생성 시, 스켈레톤 (Skeleton)과 부모 클래스를 선택해야 하는데, 여기서는 SK_Mannequin 스켈레톤과 부모 클래스로 AnimInstance를 선택합니다.
- UAnimInstance는 언리얼 엔진의 애니메이션 시스템에서 핵심 역할을 하는 클래스이며, 이 클래스를 통해 캐릭터 애니메이션 상태를 전환하거나 제어할 수 있습니다.

새 애니메이션 블루프린트 이름은 ABP_Main라고 설정합니다.
Prefix ABP 는 Animation Blue Print 의 약자 입니다.

혹은 사용하기 원하는 스켈레톤 메쉬를 우클릭 해서 만들수도 있습니다.

UE 공식문서: https://dev.epicgames.com/documentation/unreal-engine/animation-blueprints-in-unreal-engine?application_version=5.7&utm_source=editor&utm_medium=docs&utm_campaign=rich_tooltips

Animation Blueprints in Unreal Engine | Unreal Engine 5.7 Documentation | Epic Developer Community

Animation Blueprints are visual scripts that are used for the creation and control of complex animation behaviors.

dev.epicgames.com

3️⃣ Anim Graph & Event Graph

애니메이션 블루프린트에는 크게 Anim Graph와 Event Graph 두 가지 그래프가 있습니다.
Anim Graph (애니메이션 그래프)
- 입력 노드 → 블렌딩 (Blend) → 출력 노드 (Output Pose) 순으로, 최종적으로 캐릭터가 어떤 포즈와 애니메이션을 취할지 결정합니다.
  - 예: 캐릭터가 걷기 (Walk)에서 달리기 (Run)로 전환할 때, 얼마나 부드럽게 (Blend Time) 섞어줄지, 또 속도에 따라 Walk 애니메이션과 Run 애니메이션의 비율을 어떻게 조절할지를 정의합니다.
Preview Animation 설정
- Preview Setting -> Mesh

변경 전

변경 후

Event Graph (이벤트 그래프)
- 일반 블루프린트와 유사한 이벤트 그래프입니다.
- Tick 이벤트나 BlueprintImplementableEvent 등을 활용해 C++ 혹은 게임 로직과 애니메이션을 연동할 수 있습니다.
- 예) 공격 모션 중 특정 타이밍에 데미지를 가한다든지, Idle 상태가 5초 이상 지속될 경우 자동으로 ‘긴장 풀린’ 애니메이션을 재생하는 식의 이벤트 로직을 추가할 수 있습니다.

4️⃣ 애니메이션 연결 (Output Pose 테스트)

Asset Browser (오른쪽 하단)에서 프로젝트에 들어 있는 다양한 애니메이션 시퀀스를 확인할 수 있습니다.
- 애니메이션 시퀀스 (Sequence)는 캐릭터가 실제로 움직이는 모션 데이터를 담고 있는 클립 (Clip)이라고 볼 수 있습니다.

Anim Graph 창에서 Output Pose 노드에 예시로 MM_Idle 애니메이션 시퀀스를 직접 연결해보세요. 이렇게 연결하면, 우선 캐릭터가 Idle 애니메이션을 출력하게 됩니다.

MM_Idle을 선택한 상태에서 Details 창의 Loop Animation을 체크하면, Idle 동작이 지속적으로 반복 재생됩니다.

5️⃣ 캐릭터 클래스에 애니메이션 블루프린트 적용

캐릭터 블루프린트 BP_MainCharacter를 열고, Mesh 컴포넌트를 선택합니다.
Details 창에서 Animation 항목의 Animation Mode를 "Use Animation Blueprint"로 설정하고, Anim Class에 우리가 만든 ABP_Main를 할당합니다.

이벤트 그래프에서 Character Movement Component 정보 받아오기

1️⃣ 캐릭터 Character Movement Component 변수화

Character Movement Component는 캐릭터의 이동 속도, 가속도, 점프, 낙하 여부 등 다양한 이동 관련 정보를 제공합니다.
애니메이션 블루프린트와 캐릭터를 연동해, 캐릭터의 이동 상태에 따라 다른 애니메이션을 재생하기 위해서는 이 Movement Component의 정보가 필수적입니다.

1. 필요한 변수 생성

애니메이션 블루프린트의 Event Graph에서 변수 두 개를 만듭니다.
1. Character : 타입 - Character Object Reference
2. CharacterMovement : 타입 - Character Movement Component Object Reference
이렇게 해두면, 캐릭터와 캐릭터의 Movement Component를 쉽게 참조할 수 있습니다.

2, 이벤트 그래프에서 변수 초기화

Event BlueprintInitializeAnimation 노드 사용
- 애니메이션 블루프린트가 초기화될 때(즉, 한 번만 호출) 실행되는 이벤트입니다.
- 여기서 Get Owning Actor 노드로 현재 애니메이션을 재생 중인 액터를 가져옵니다.
- 캐스팅을 통해 우리가 사용 중인 캐릭터가 맞는지 확인하고, 성공하면 해당 객체를 Character 변수에 저장합니다.
- Character에서 Get Character Movement 노드를 사용해 Movement Component를 얻어, 이를 CharacterMovement 변수에 저장합니다.

2️⃣ 매 프레임마다 캐릭터의 수평 속도 가져오기

Event BlueprintUpdateAnimation 노드는 프레임마다 호출되어 애니메이션 로직을 업데이트하는 핵심 이벤트입니다.
- 실시간으로 호출되는 함수
- Tick 과 매우 흡사
여기서 캐릭터의 현재 이동 속도, 가속도 등을 매번 체크하여 Anim Graph에서 참조할 변수를 계속 갱신합니다.

Valid 체크

먼저 Character가 유효한지 (Null이 아닌지) Is Valid? 노드 등을 통해 확인합니다.
- 우클릭스 Option이 보입니다.
캐릭터가 제대로 셋업되지 않았다면, 이후 로직을 수행하지 않도록 합니다.

Ground Speed 계산

CharacterMovement의 Get Velocity 노드로 캐릭터의 현재 속도 벡터(X, Y, Z)를 가져옵니다.
Vector Length XY 노드를 사용해 X, Y 성분의 길이(즉, 2D 평면상의 속도)만 구합니다. 이를 예를 들어 Ground Speed라는 float 변수에 저장합니다.
- 이렇게 하면 캐릭터가 수평으로 어느 정도 빠르게 움직이고 있는지 알 수 있게 됩니다.
전체 속도 벡터는 Velocity라는 Vector 변수에 저장해둡니다. 점프 중인 경우 Z축 속도를 확인해야 하는 상황 등이 있을 수 있기 때문입니다.

3️⃣ 매 프레임마다 캐릭터의 수평 속도 가져오기

캐릭터가 정지 상태 (Idle) 인지 이동 중 (Walk/Run) 인지를 구분하는 기본적인 로직을 구현해봅시다.
Ground Speed가 어느 정도 이상이면 (3.0f 이상) “캐릭터가 움직이고 있다”고 판단할 수 있습니다.
CharacterMovement의 Get Current Acceleration 노드로 현재 가속도 값을 가져올 수도 있습니다.
가속도 벡터가 (0, 0, 0)에 가깝다면, 입력 중이 아닌 상태일 수 있습니다.
이동 여부와 사용자 입력(가속도 여부)을 AND 조건 등으로 조합해, "캐릭터가 실제로 이동 중인지”를 판정하는 변수를 만들어 둘 수 있습니다.
- IsMoving = (Ground Speed > 3.0) AND (Acceleration != 0)

4️⃣ 매 프레임마다 캐릭터의 낙하 여부 저장하기

캐릭터가 점프 중이거나 공중에 있는 상태를 판별하기 위해 다음 정보를 사용할 수 있습니다.
CharacterMovement의 Is Falling 함수를 사용해 캐릭터가 공중에 떠 있는지 확인할 수 있습니다.
점프를 했거나 플랫폼에서 떨어졌을 때 등, 캐릭터가 지면에 붙어있지 않으면 True가 반환됩니다.
이를 bool 변수에 저장하면, Anim Graph 내에서 캐릭터가 점프나 낙하 관련 애니메이션으로 전환하도록 제어할 수 있습니다.

최종

Anim Graph에서 “Locomotion” State Machine 설계하기

1️⃣ State Machine (상태 기계)란?

State Machine (상태 기계)는 언리얼 엔진의 애니메이션 시스템에서, 캐릭터의 상태(Idle, Walk, Run, Jump 등)에 따라 어떤 애니메이션을 재생하고, 어떻게 전환할지를 결정하기 위한 논리적 구조입니다.
가장 쉽게 이해하자면, “Idle 상태이면 Idle 애니메이션을 재생하고, 캐릭터가 움직이기 시작하면 Walking 애니메이션으로 전환한다.” 같은 로직을 직관적으로 구성하게 해줍니다.

State Machine의 핵심 개념
1. State(상태)
  - 캐릭터가 현재 어떤 동작을 하고 있는지 나타냅니다.
  - 예) Idle, Walking, Running, Jumping 등이 각각 하나의 상태가 될 수 있습니다.
2. Transition(전환)
  - 한 상태에서 다른 상태로 언제 전환되는지 조건(Condition)을 정의합니다.
  - 예) Idle → Walking 전환 조건: “속도 > 0” (즉, 캐릭터가 이동을 시작)
3. Animation Graph와의 연결
  - State Machine 내부의 상태 (State)는 실제로 재생할 애니메이션을 배치하는 장소입니다.
  - State 간 전환 조건을 만족하면 다른 애니메이션이 재생되도록 합니다.

2️⃣ “Locomotion” State Machine 생성

이제 캐릭터의 기본 이동 (Idle, Walk, Run) 관련 애니메이션들을 전환하기 위해 Locomotion이라는 State Machine을 만들어 보겠습니다.
Anim Graph 창에서 우클릭 → “Add New State Machine”을 선택하고 이름을 Locomotion으로 설정합니다.
이 State Machine 노드를 Final Output Pose 쪽에 연결하면, 결국 Locomotion State Machine에서 나온 결과가 캐릭터 최종 포즈가 됩니다.

3️⃣ Idle State 생성

State Machine을 더블 클릭해 들어가면 Entry 노드가 보입니다. 이 Entry 노드에서 드래그 드롭하여 Add State를 선택, 이름을 Idle이라고 정합니다.
Entry → Idle : 이 선은 “State Machine이 시작되면 Idle 상태로 진입한다”는 의미입니다.
Idle State를 더블 클릭해서 내부로 들어간 뒤, Output Animation Pose에 MM_Idle(또는 프로젝트 내 기본 Idle 애니메이션) 시퀀스를 연결합니다.
MM_Idle 시퀀스가 반복 재생(Loop)되도록 Details 창에서 Loop Animation 옵션을 체크해 주세요.

4️⃣ Walk/Run State와 Blend Space 연결

State Machine 창으로 돌아와 Idle State를 드래그하여 Add State를 선택, 이름을 Walk/Run으로 정합니다.
마찬가지로, Walk/Run State에서 Output Animation Pose에 Blend Space(BS_MM_WalkRun 등)를 연결합니다.
이 Blend Space는 캐릭터 속도(Ground Speed)를 입력으로 받아 걷기, 달리기 애니메이션을 부드럽게 혼합하여 재생합니다.

5️⃣ Idle ↔ Walk/Run 전환 조건 설정

State Machine 창에서, Idle에서 Walk/Run으로 가는 화살표(Transition)를 더블 클릭하면 Transition Rule 설정 창이 열립니다.
bShouldMove == true일 때 전환되도록 설정하면, 캐릭터가 이동 입력을 받고 있음을 의미하게 됩니다.
- 이전 단계에서 만든 bShouldMove 변수가 있다면 그대로 사용하고, 없다면 Ground Speed > 3.0 등으로 조건을 걸어도 됩니다.
반대로 Walk/Run에서 Idle로 가는 Transition Rule은 bShouldMove == false로 설정합니다.
- 즉, 더 이상 움직이지 않을 때, Idle 상태로 돌아오게 됩니다.

UE 공식문서: State Machine

State Machines in Unreal Engine | Unreal Engine 5.7 Documentation | Epic Developer Community

Create logic-based branching animation by using State Machines.

dev.epicgames.com

Anim Graph에서 “Main States” State Machine 설계하기

1️⃣ “Main States” State Machine 생성과 Control Rig 설정

이제는 점프, 낙하, 착지와 같은 추가 상태들을 포함하기 위한 상위 State Machine을 설계해보겠습니다. 이 State Machine을 Main States라는 이름으로 만들어보겠습니다.
Anim Graph에서 우클릭 → “Add New State Machine” → Main States 라고 이름을 지어줍니다.
새로 만든 Main States 노드를 Output Pose 직전에 연결해야 합니다. 그런데 이번에는 Control Rig 노드를 한 번 더 거쳐야 합니다. 즉, 메인 애니메이션 (상태머신) → Control Rig → 최종 포즈 순으로 데이터를 흐르게 만듭니다.
1. Main States를 Control Rig 노드의 입력으로 연결
2. Control Rig 노드를 Output Pose로 연결

Control Rig 설정
- 애니메이션 로직 (상태머신)에서 나온 포즈를 한 번 더 가공하거나, Foot IK (지형이 울퉁불퉁해도 발을 지면에 맞추는 기능) 같은 것을 적용하기 위해 Control Rig 노드를 사용합니다.

Control Rig를 클릭하고 Details 창에서 Control Rig Calss를 CR_Mannequin_BasicFootIK로 지정해줍니다. (프로젝트에 존재하는 IK용 Control Rig 에셋이랍니다.)
“Set Initial Trnsforms From Mesh” 옵션에 체크를해줍니다. 이 옵션은 “현재 스켈레탈 메쉬 (Anim Graph에서 넘어온 포즈)의 뼈 변환을 그대로 초기값으로 사용하겠다”는 의미입니다.
- 체크하면, 매 프레임 “State Machine에서 계산된 포즈”를 기반으로 Control Rig이 추가적인 IK나 변형을 진행하게 됩니다.
Input과 Output 카테고리 둘 다 ShouldDoIKTrace - Use Pin에 체크를 해둡니다.
- 보통 CR_Mannequin_BasicFootIK에서는 ShouldDoIKTrace (또는 이와 유사한 이름의 Boolean 값)가 있어서, 실제로 발 위치를 추적 (Trace)할 것인지를 결정합니다.
- “Use Pin”에 체크하게 되면, 이 값이 Anim Graph나 Blueprint에서 핀으로 연결 가능하게 됩니다.
  - 즉, “캐릭터가 공중에 있을 땐 발 IK 안 쓰고, 지면 위에서만 발 IK 사용” 등 조건에 따라 사용 가능하게 되는겁니다.

2️⃣ “Locomotion” State Machine을 캐시 포즈로 저장

기존에 만든 Locomotion State Machine (Idle, Walk/Run 동작)을 **캐시 포즈 (Cached Pose)**로 만들어두면, 다른 곳에서도 재활용하기 쉽습니다.
Anim Graph 내부에서 Locomotion 노드를 드래그 → “New Save cached pose” → 이름을 Locomotion 등으로 저장합니다.
이렇게 하면 Main States에서 Locomotion 상태를 하나의 포즈로 쉽게 가져와 사용할 수 있습니다.

3️⃣ “Main States” State Machine 설계

Locomotion (걷기/뛰기) State
- Entry에서 드래그해 Add State → 이름을 Locomotion으로 설정합니다.
- Locomotion State를 더블 클릭하고 들어가서, 앞서 캐시 포즈로 저장한 Locomotion 포즈를 연결해주면 됩니다.
Land (착륙) State
- 새로운 State Land를 만들어, 착지 시 재생할 애니메이션(MM_Land)을 연결합니다.
- MM_Land 애니메이션은 Details 창에서 Loop Animation 조건에 체크해줍니다.
  - Loop 해주는 이유:
    - 켜뒀을때 다음 동작 행동시 더 부드러운 전환
    - 버그시 정지된것처럼 보이는것 막는 역할
  - 그래서 보통 애니메이션들 다 Loop 해주는게 좋습니다
- 여기서는 Locomotion 상태에서 넘어온 포즈를 적절히 착지 모션을 섞어줍니다. (Apply Additive)
- 전환 조건 (Transition 설정)
  - Land에서 Locomotion으로 가는 전환 조건을 2개를 설정해야합니다. (두번 드래그하면 두 개의 조건이 생성이 됩니다.)
  - Land → Locomotion 첫 번째 조건은 bShouldMove == true
  - Land → Locomotion 두 번째 조건은 Details 창에서 *애니메이션 시퀀스 재생 완료하면 자동으로 State가 변할 수 있는 조건인 “Automatic Rule Based on Sequence Player in State”에 체크를 합니다.
    - 이게 안되어있으면 Land 가 Loop으로 되어있어서 Land 애니메이션이 계속 나오게 됩니다.
Fall Loop (추락) State
- Fall Loop 상태는 MM_Fall_Loop 애니메이션을 적용하고, Loop Animation을 체크해둡니다.
Jump (점프) State
- Jump 상태는 MM_Jump 애니메이션을 적용합니다. Jump는 Loop Animation에 체크를 하지 않습니다.
- 전환 조건
  - Jump → Fall Loop 조건은 Jump 시퀀스가 끝나면 자동으로 Fall Loop로 전환되게끔 Details 창에서 Automatic Rule Based on Sequence Player in State에 체크합니다.

5.State Alias 생성 - To Land (공중에 있는 = 지면으로 향하는) 그룹

우클릭 → Add State Alias를 통해 특정 스테이트들을 그룹 지어 별칭을 줄 수 있습니다.
State Alias는 대규모 State Machine에서 여러 상태를 한 번에 관리하기 유용합니다.
Jump, Fall Loop 두 상태를 To Land State 그룹으로 묶어줍니다.
전환 조건
- To Land → Land (현재 강의 편집 실수로 이 부분이 누락되었습니다.)
  - bIsFalling == false가 되면 Land로 전환하도록 설정합니다.
  - 이 부분은 공중에서 착지로 상태 전환을 해야하는 상황들을 가리킵니다.

6.State Alias 생성 - To Falling (지면에 있는 = 공중으로 향하는) 그룹

Locomotion, Land 두 상태를 To Falling State 그룹으로 묶어줍니다.
전환 조건
- To Falling → Jump : Z축 속도가 일정 값(예: 100) 이상이고, bIsFalling == true라면 점프 상태로 인식합니다.
- To Falling → Fall Loop: 바닥에 있다가 공중으로 전환되는 상황을 말합니다. (예를 들어, 걷다가 갑자기 바닥이 훅 꺼져서 낙하를 한다거나, 높은 곳에서 미끄러져서 떨어지기 시작하면 Fall Loop 즉, 추락하는 애니메이션이 재생)

캐릭터 애니메이션 적용 | [언리얼 엔진 C++ (Unreal Engine C++)]