Unity Animation Clip Property 설정

• 📌 문제 상황

• 📌 해결 방법 #1 (Animation Clip Property 설정)

• 📌 해결 방법 #2 (하나의 Animation으로 캐릭터 회전)

• 📌 해결 방법 #3 (반대 방향의 Animation 재생을 통한 우회)

 

📌 문제 상황

Unity6 엔진을 사용해보고자 간단한 3D 게임을 만들어보려고 했다. 2D 에셋은 Aseprite로 직접 도트를 찍어 간단하게 만들 수 있었지만, 3D Asset을 직접 만드는 것은 불가능했다. 그래서 Asset Store에서 "FREE Low Poly Human - RPG Character" Asset과 "Low-Poly Simple Nature Pack" Asset을 다운 받았다.

 

[ 에셋 정보 ]

[ FREE Low Poly Human - RPG Character ]

https://assetstore.unity.com/packages/3d/characters/humanoids/fantasy/free-low-poly-human-rpg-character-219979

[ Low-Poly Simple Nature Pack ]

https://assetstore.unity.com/packages/3d/environments/landscapes/low-poly-simple-nature-pack-162153

 

 

그러나 문제가 발생했다. "FREE Low Poly Human - RPG Character" Asset은 Human Prefab 외에도 다양한 Animation까지 제공을 해줬는데, 앞뒤로 달리는 Animation은 정상적으로 적용이 되었으나, 좌우로 달리는 Animation은 반대로 적용된다는 것이다. 즉, D 키를 눌렀을 때 RunRight Animation Clip이 실행되도록 했는데 왼쪽으로 뛰는 모션이, A 키를 눌렀을 때 RunLeft Animation Clip이 실행되도록 했는데 오른쪽으로 뛰는 모션이 적용된다는 것이다.

 

해당 Asset 리뷰를 봐도 나랑 같은 문제를 겪는 사람은 없었고, 구글에 'Unity Animation 방향 문제'로 검색해봐도 딱히 도움이 될 만한 정보는 없었다. 심지어 GPT가 던져준 해결 방안도 전부 시도해봤지만, 결국 고치지 못했다. 도대체 Animation Clip 자체에 문제가 있는 건지, 월드 좌표계랑 로컬 좌표계 충돌 때문인지, 아니면 그냥 내 코드가 문제인 건지 전혀 감이 잡히지 않았다. 그래서 그냥 이것저것 눌러보다가 결국 고친 방법을 공유하려 한다. (즉, 100% 명확한 해결책은 아님 😅) 혹시 이 오류의 정확한 원인을 아시는 분이 계시다면 꼭 댓글로 알려주세요. 정말 감사하겠습니다! (글로 보면 금방 해결한 것처럼 보이겠지만, 이 오류 고치는 데만 2일 걸림 ㅎ)

 

[ 기존 PlayerController Script ]

using UnityEngine;

public class PlayerController : MonoBehaviour
{
    Rigidbody _rigid;
    Animator _anim;

    public float _speed = 3f;

    void Awake()
    {
        _rigid = GetComponent<Rigidbody>();
        _anim = GetComponent<Animator>();
    }

    void FixedUpdate()
    {
        if (Input.GetKey(KeyCode.W)) // 앞으로 이동
            MoveCharacter(Vector3.forward, "RunForward");
        else if (Input.GetKey(KeyCode.S)) // 뒤로 이동
            MoveCharacter(Vector3.back, "RunBackward");
        else if (Input.GetKey(KeyCode.D)) // 오른쪽으로 이동
            MoveCharacter(Vector3.right, "RunRight");
        else if (Input.GetKey(KeyCode.A)) // 왼쪽으로 이동
            MoveCharacter(Vector3.left, "RunLeft");
        else
            _anim.Play("Idle");
    }

    void MoveCharacter(Vector3 dir, string animName) {
        _anim.Play(animName);
        _rigid.MovePosition(_rigid.position + dir * _speed * Time.deltaTime);
    }
}

 

[ 실행 환경 ]

✅ Unity 버전 : Unity 6 (6000.0.38f1)

✅ 플랫폼 빌드 : Windows

✅ 운영체제 : Windows 10 Education (버전 : 22H2)

✅ CPU : AMD Ryzen 5 5600 6-Core Processor 3.50 GHz

✅ GPU : NVIDIA GeForce RTX 3050

✅ RAM : 16.0GB

 

📌 해결 방법 #1 (Animation Clip Property 설정)

본격적으로 해결 방법을 설명하기 전에, Animation 탭의 Animation Clip Property 기능에 대해 살펴보고자 한다.

 

Animation Clip Property (반복 재생 및 포즈 제어)

1️⃣ Loop Time

 ~> 애니메이션 클립을 끝까지 재생하고, 끝에 도달하면 다시 재생을 시작

 ~> Loop Pose : 모션을 자연스럽게 반복

 ~> Cycle Offset : 애니매이션이 다른 시간에 시작하는 경우에 설정

2️⃣ Root Transform Rotation

 ~> Bake into Pose : 루트 회전을 뼈대의 움직임에 베이크

 ~> Based Upon : 기본 루트 회전

  • Original : 소스 파일의 원래 회전을 유지

  • Root Node Rotation : 루트 노드의 회전을 사용 (Generic Animation Type에만 사용 가능)

  • Body Orientation : 상체를 앞으로 향하게 함 (Humanoid Animation Type에만 사용 가능)

 ~> Offset : 루트 회전에 대한 오프셋(각도)

3️⃣ Root Transform Position (Y)

 ~> Bake into Pose : 수직 루트 모션을 뼈대의 움직임에 베이크 (루트 모션으로 저장하려면 비활성화)

 ~> Based Upon (at Start) : 기본 수직 루트 포지션

  • Original : 소스 파일의 수직 포지션을 유지

  • Root Node Position : 수직 루트 포지션을 사용 (Generic Animation Type에만 사용 가능)

  • Center of Mass : 질량 중심을 루트 트랜스폼 포지션과 맞춤 (Humanoid Animation Type에만 사용 가능)

  • Feet : 발을 루트 트랜스폼 포지션과 맞춤 (Humanoid Animation Type에만 사용 가능)

 ~> Offset : 수직 루트 포지션에 대한 오프셋

4️⃣ Root Transform Position (XZ)

 ~> Bake into Pose : 수평 루트 모션을 뼈대의 움직임에 베이크 (루트 모션으로 저장하려면 비활성화)

 ~> Based Upon : 기본 수평 루트 포지션

  • Original : 소스 파일의 수평 포지션을 유지

  • Root Node Position : 수평 루트 트랜스폼 포지션을 사용 (Generic Animation Type에만 사용 가능)

  • Center of Mass : 루트 트랜스폼 포지션과 맞춤 (Humanoid Animation Type에만 사용 가능)

 ~> Offset : 수평 루트 포지션에 오프셋

5️⃣ Mirror

 ~> 이 Clip의 좌우를 반전 (Animation Type이 Humanoid로 설정된 경우에만 표시)

6️⃣ Additive Reference Pose

 ~> 활성화하려면 Additive Animation Layer에 기본으로 사용할 Reference Pose의 Frame을 설정

 ~> Pose Frame : Reference Pose로 사용할 Frame 수를 입력 (타임라인의 파란색 마커를 드래그하여 이 값을 업데이트하는 것도 가능)

 

음.. 위 내용은 Unity 공식 문서의 설명을 그대로 가져온 건데 솔직히 말하자면 무슨 소리인지 하나도 이해가 안된다. 그래서 쉽게 설명을 하자면, "Bake into Pose" =  "지금 이 포즈 그대로 굽겠다" = "게임 오브젝트가 애니매이션에 영향을 받지 않도록 하겠다"로 설명할 수 있다. 즉, Rotation, Position (Y), Position (XZ)은 "어디를" 굳힐지 결정하는 것으로, 애니매이션에 의해 게임 오브젝트가 회전할지, 위아래로 움직일지(Y), 앞뒤좌우(XZ)로 이동할지를 따로 설정하는 것이다. 그리고 "Based Upon" = "~기반으로" = "어디를 기준으로"이며, "Offset" = "수동으로 값 조정"으로 설명할 수 있다.

 

 

우선 오류가 발생한 .anim 파일이 포함된 FBX 파일을 선택한 후, Inspector 창에서 Animation 탭으로 이동한다.

그 다음, Clips 섹션에서 설정하고자 하는 .anim 파일을 선택한 뒤, Root Transform Rotation 항목의 Offset 값을 적절하게 수정한다.

 

 

본인이 오류가 발생한 Animation Clip은 'RunLeft'와 'RunRight'이므로, 두 .anim 파일의 Offset을 모두 수정해줬다.

Unity에서는 기본적으로 왼손 좌표계(X축의 양수 방향은 오른쪽, Y축의 양수 방향은 위쪽, Z축의 양수 방향은 앞쪽)를 사용하므로, RunLeft Animation Clip의 Offset은 90으로, RunRight Animation Clip의 Offset은 -90으로 설정해줬다.

 

❓ 의문점 #1

현재 발생한 오류는 왼쪽 방향을 향해 달리는 Animation인 RunLeft Animation Clip이 오른쪽 방향을 향해 달리는 것과, 오른쪽 방향을 향해 달리는 Animation인 RunRight Animation Clip이 왼쪽 방향을 향해 달리는 것이다.

그렇다면 'Unity의 왼손 좌표계에서 X축의 양수 방향이 오른쪽이므로, RunLeft Animation Clip의 Offset 값을 음수로 설정하여 왼쪽으로 회전시키고, RunRight Animation Clip의 Offset 값을 양수로 설정하여 오른쪽으로 회전시켜야 우리가 원하는 방향으로 달리지 않을까?' 와 같은 의문이 들 수 있다.

이에 대한 GPT의 답변은 FBX나 다른 3D 모델 파일을 가져올 때, 모델 자체의 로컬 좌표계가 Unity의 좌표계와 다를 수 있기 때문이라고 한다. 즉, Animation이 만들어진 툴의 축 기준과 Unity의 축 기준이 서로 다르기 때문에 회전 방향이 반대로 적용될 수 있다는 것이다. (Blender, Maya, 3ds Max 등의 외부 툴은 오른손 좌표계를 사용)

 

❓ 의문점 #2

위 답변을 듣고 다시 '그렇다면 왜 Runforward Animation Clip과 Runbackward Animation Clip은 정상적으로 작동한거지?' 와 같은 의문이 들었다.

이에 대한 GPT의 답변은 Unity에서 앞 방향은 기본적으로 Z축 양수 방향이고, 대부분의 모델도 이 기준에 맞춰 제작되지만, 좌우 방향(X축 기준)은 FBX 모델을 만든 툴마다 축 기준이 다를 수 있기 때문이라고 한다.

 

❓ 의문점 #3

위 답변을 듣고 GPT에게 오류가 발생하는 .anim 파일의 meta 파일을 분석해달라고 했더니, meta 파일에는 축 기준 정보가 포함되어 있지 않았다. 그래서 이번에는 FBX 파일 자체를 분석해달라고 했는데, RunLeft.fbx 파일과 RunRight.fbx 파일 모두 UpAxis : 1(Y), FrontAxis : 2(Z), CoordAxis : 0(X), CoordAxisSign : 1(양의 방향)로, 전부 Unity 축 기준과 동일했다. 그렇다면 축 기준 자체에는 문제가 없다는 건데.. 대체 뭐가 문제인 걸까? Unity Import 처리 방식이 문제인 건가? 아니면 그냥 진짜 단순히 제작자의 실수인 걸까? 너무 답답하다...

 

뭐, GPT의 답변이 항상 정답인 건 아니니까 100% 확신할 수는 없다. 그렇지만 이 오류의 정확한 원인은 나도 모르고, GPT도 모르는 건 확실한 것 같다 ㅋㅋ 이 오류에 대한 확실한 해결책은 아직 못 찾았지만, 계속 답도 없는 오류에 시간을 낭비하는 것보다는 이 사실을 블로그에 포스팅해서 많은 사람들이 이 글을 보고 함께 머리를 맞대서 정답을 찾아냈으면 한다. 저랑 같은 오류를 겪으신 분이 계시다면, 그리고 이 오류를 해결하신 분이 있다면 꼭 알려주시면 좋겠다.

 

 

아무튼, 위 설정을 통해 오류가 정상적으로 수정된 것을 확인할 수 있다.

 

+ 추가 지식

FBX(Filmbox) 파일

 ~> 주로 3D 모델과 Animation Data를 저장하는 파일 형식

 ~> Unity에서 3D 캐릭터 모델, Animation, Mesh, Texture 등을 Import 할 때 자주 사용된다.

 ~> FBX 파일에는 3D 모델(Mesh와 Polygon 정보), 뼈대 구조(Rigging, Skeleton), Animation Data(움직임 정보), Material 및 Texture 정보 등을 담을 수 있다.

 

📌 해결 방법 #2 (하나의 Animation으로 캐릭터 회전)

[ 변경된 PlayerController Script #1 ]

using UnityEngine;

public class PlayerController : MonoBehaviour
{
    // ...
    
    void FixedUpdate()
    {
        Vector3 moveDir = GetInputDirection();

        if (moveDir != Vector3.zero)
            MoveCharacter(moveDir.normalized);
        else
            _anim.Play("Idle");
    }

    Vector3 GetInputDirection()
    {
        Vector3 direction = Vector3.zero;

        if (Input.GetKey(KeyCode.W)) // 앞으로 이동
            direction += Vector3.forward;
        if (Input.GetKey(KeyCode.S)) // 뒤로 이동
            direction += Vector3.back;
        if (Input.GetKey(KeyCode.D)) // 오른쪽으로 이동
            direction += Vector3.right;
        if (Input.GetKey(KeyCode.A)) // 왼쪽으로 이동
            direction += Vector3.left;

        return direction;
    }

    void MoveCharacter(Vector3 dir)
    {
        // 캐릭터 회전
        Quaternion targetRotation = Quaternion.LookRotation(dir);
        transform.rotation = Quaternion.Slerp(transform.rotation, targetRotation, Time.deltaTime * 10f);

        // 캐릭터 이동
        Vector3 newPosition = _rigid.position + dir * _speed * Time.deltaTime;
        _rigid.MovePosition(newPosition);

        _anim.Play("RunForward");
    }
}

 

이 방법은 그냥 앞을 향해 달리는 'RunForward' Animation Clip만 사용하는 방식이다. 즉, 문제가 되는 'RunRight'와 'RunLeft' Animation Clip 자체를 아예 쓰지 않는 거다. 사용자의 입력에 따라 캐릭터가 바라볼 방향을 계산하고, 그 방향으로 캐릭터를 회전시킨 다음, 그냥 'RunForward' Animation Clip만 재생시키는 방식이다. 이렇게 하면 Animation 방향 문제 자체가 발생할 일이 없으니까, 오히려 깔끔하게 해결된다.

 

 

위 설정을 통해 오류가 정상적으로 수정된 것을 확인할 수 있다. 그러나 이 방법은 첫 번째랑 세 번째 해결 방법과는 이동 방식 자체가 다르다. 다른 방법들은 캐릭터가 항상 앞을 보면서 이동하지만, 이 방법은 입력 방향에 따라 플레이어 자체가 직접 회전하면서 이동한다. 그래서 캐릭터가 실제로 바라보는 방향과 이동 방향이 항상 일치한다는 특징을 가진다.

 

📌 해결 방법 #3 (반대 방향의 Animation 재생을 통한 우회)

[ 변경된 PlayerController Script #2 ]

using UnityEngine;

public class PlayerController : MonoBehaviour
{
    // ...

    void FixedUpdate()
    {
        // ...
        else if (Input.GetKey(KeyCode.D)) // 오른쪽으로 이동
            MoveCharacter(Vector3.right, "RunLeft");
        else if (Input.GetKey(KeyCode.A)) // 왼쪽으로 이동
            MoveCharacter(Vector3.left, "RunRight");
        // ...
    }

    // ...
}

 

이 방법은 반대 Animation Clip을 재생시키는 방식이다. 예를 들어, 플레이어가 오른쪽으로 이동하려고 하면 원래라면 RunRight Animation Clip을 재생해야 하는데, 여기서는 반대로 RunLeft Animation Clip을 재생시킨다. 마찬가지로, 왼쪽으로 이동할 때도 RunRight Animation Clip을 재생시킨다. 이렇게 하면 Animation 방향이 꼬여도 그냥 반대로 틀어서 맞춰버리는 거다. 애초에 Animation이 반대로 실행되면서 발생하는 문제이므로, 아예 반대 Animation을 틀어주는 식으로 해결하는 셈이다.

 

 

위 설정을 통해 D 키를 눌렀을 때 RunLeft Animation Clip이, A 키를 눌렀을 때 RunRight Animation Clip이 실행되는 것을 볼 수 있다. 위 설정을 통해서도 오류가 정상적으로 수정된 것을 확인할 수 있다.

 

 

+ 출처

https://docs.unity3d.com/kr/2021.1/Manual/class-AnimationClip.html

https://wlsdn629.tistory.com/entry/%EC%9C%A0%EB%8B%88%ED%8B%B0-Animation-Clip-%EC%A1%B0%EC%A0%95%ED%95%98%EB%8A%94-%EB%B0%A9%EB%B2%95%EC%97%90-%EB%8C%80%ED%95%B4-%EB%B0%B0%EC%9B%8C%EB%B3%B4%EC%9E%90

https://daekyoulibrary.tistory.com/entry/Unity-3D-%EC%95%A0%EB%8B%88%EB%A9%94%EC%9D%B4%EC%85%98-%EB%A3%A8%ED%8A%B8-%EB%AA%A8%EC%85%98Root-Motion%EC%9D%B4-%ED%8A%B8%EB%9E%9C%EC%8A%A4%ED%8F%BCTransform-%EA%B0%92%EC%9D%84-%EB%B3%80%EA%B2%BD-%EC%8B%9C%ED%82%A4%EB%A9%B0-%EB%B0%9C%EC%83%9D%ED%95%9C-%EB%B2%84%EA%B7%B8