> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-ko/3d/animations.md).

# 애니메이션

Decentraland로 가져온 3D 모델에 포함할 수 있는 애니메이션을 만드는 방법을 알아봅니다.

애니메이션은 사물에 생명을 불어넣는 예술입니다. 3D 모델에 애니메이션을 추가하는 것만큼 장면을 생동감 있게 만드는 좋은 방법은 없습니다.

{% hint style="info" %}
**💡 팁**:  [Decentraland Tools Blender 플러그인](https://extensions.blender.org/add-ons/decentraland-tools/)을 설치하세요. 이 플러그인에는 3D 모델, 웨어러블, Emote를 편집하고 내보내는 데 유용한 여러 기능이 포함되어 있습니다.
{% endhint %}

애니메이션을 만드는 방법은 몇 가지가 있습니다. 다음과 같은 방법을 사용할 수 있습니다. **오브젝트 애니메이션**을 사용하거나,  **리그(골격 애니메이션)**&#xB97C; 사용하거나,  **셰이프 키(모프 타깃 애니메이션)**.

**오브젝트 애니메이션** 은 통통 튀는 공, 회전하는 지구본, 공중에 떠 있는 의자처럼 단순한 모델에 가장 적합하며, 아마추어가 필요하지 않습니다. 오브젝트 애니메이션은  **정점 애니메이션**. 오브젝트 애니메이션에서는 모델 전체가 애니메이션으로 움직이는 반면, 버텍스 애니메이션에서는 오브젝트의 각 버텍스를 개별적으로 애니메이션으로 움직일 수 있습니다.

**셰이프 키(모프 타깃 또는 블렌드 셰이프라고도 함)** 는 버텍스 애니메이션의 한 형태로, **Decentraland 엔진에서 지원됩니다**. 셰이프 키는 얼굴 표정, 립싱크 또는 본만으로 구현하기 어려운 변형에 특히 유용합니다. glTF/GLB 파일에 포함된 셰이프 키 애니메이션은 스켈레탈 애니메이션이나 오브젝트 애니메이션과 마찬가지로 월드 내에서 재생됩니다.

사람, 생물 또는 기계처럼 더 복잡한 모델이라면 **리그**가 필요합니다. 리그는 메시를 움직이고 변형하는 디지털 스켈레톤에 불과합니다. 메시를 스켈레톤에 연결하는 과정을 스키닝이라고 합니다. 이때 각 버텍스 그룹에 어떤 본이 영향을 미칠지, 그 영향력이 얼마나 강할지 지정하여 모델이 가능한 한 자연스럽게 변형되도록 합니다.

하지만 어느 방식을 사용하든 3D 모델의 모든 애니메이션은 해당 모델의 *glTF* 별도의 파일에 있는 애니메이션은 참조할 수 없으므로 파일에 넣으세요.

## 애니메이션 만들기

Blender를 사용해 애니메이션을 만드는 방법은 다음과 같습니다.

### 오브젝트 애니메이션

* 다음이 열려 있는지 확인하세요. ***도프 시트*** > ***액션 에디터*** 탭을 열고 ***새로 만들기*** 를 클릭해 애니메이션 클립을 추가하세요.
* 원하는 대로 이름을 바꾸고 다음 항목을 켜세요. ***가짜 사용자*** (방패 아이콘)을 켜야 애니메이션이 저장됩니다.
* 개체를 선택하고 ***I***. 그런 다음 개체를 이동하거나 회전 또는 크기 조정하고, 타임라인의 다른 프레임에서 ***I*** 를 다시 눌러 현재 변환값으로 키프레임을 추가합니다.
* 애니메이션의 마지막 프레임은 첫 번째 프레임과 같아야 하므로, 첫 번째 프레임을 복사해 마지막 프레임에 붙여넣으면 됩니다.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-934254966e7b08a44c07ff246b5c4c97ce2ef2d6%2F01_object_animation_02.webp?alt=media)

*애니메이션 클립을 만들고 키프레임을 추가합니다.*

### 리그 애니메이션

리그 애니메이션에는 아마추어가 필요합니다. 직접 만들려면 다음을 참조하세요. [리그 만들기](https://www.notion.so/686e6f59a1604585b059f990a36b2d55) 일관된 아마추어를 설정하는 방법을 안내합니다.

리깅을 마치고 스키닝으로 자연스러운 변형을 얻었다면 애니메이션을 시작할 준비가 된 것입니다! 과정은 오브젝트 애니메이션과 매우 비슷하지만, ***오브젝트 모드***&#xC5D0;서 작업하는 대신 ***포즈 모드***.

* 다음으로 이동하세요. ***포즈 모드*** 그리고 다음 항목이 선택되어 있는지 확인하세요. ***도프 시트*** > ***액션 에디터*** 탭을 열고 다음을 클릭합니다. ***새로 만들기*** 애니메이션 클립을 추가합니다.
* 원하는 대로 이름을 바꾸고 다음 항목을 켜세요. ***가짜 사용자*** (방패 아이콘)을 켜야 애니메이션이 저장됩니다.
* 마우스를 다음 항목 위에 둔 상태에서 ***뷰포트***, 다음 키를 누릅니다. ***A*** 모두 선택한 다음 ***I*** 전체 아마추어에 키프레임을 설정합니다.
* 타임라인에서 다른 프레임으로 이동한 다음 원하는 포즈를 얻을 수 있도록 본을 원하는 대로 조작합니다. 리그 설정에 따라 본의 위치, 회전, 크기를 변경할 수 있습니다.
* 원하는 결과가 나오면 전체 아마추어에 키프레임을 하나 더 설정합니다. 애니메이션이 완성될 때까지 이 과정을 반복합니다. 애니메이션을 반복 재생하려면 첫 프레임과 마지막 프레임을 동일하게 설정해야 합니다.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-e96016ff15cc39fd5fd52bd199143a8d949e3d30%2F02_rig_animation_02.webp?alt=media)

애니메이션 제작이 처음이라면 초보자를 위한 유용한 팁이 담긴 다음 튜토리얼을 확인해 보세요.

[![Video Preview](https://img.youtube.com/vi/-iWslh4uQIk/maxresdefault.jpg)](https://youtu.be/-iWslh4uQIk)

## 스킨 애니메이션과 변환 애니메이션 비교

**변환 애니메이션은 애니메이션을 표시하는 데 필요한 컴퓨팅 리소스의 오버헤드가 적기 때문에 일반적으로 스킨 메시 애니메이션보다 성능 면에서 유리합니다.**

스킨 메시 애니메이션은 메시의 정점에 가중치가 적용된 본 스켈레톤이 있는 메시를 사용합니다. 스켈레톤을 애니메이션화하면 메시도 함께 애니메이션화됩니다. 이 과정은 계산량이 상당히 많을 수 있으며, 특히 애니메이션화할 정점이 많은 경우 더욱 그렇습니다.

반면 변환 애니메이션은 오브젝트의 변환 속성(예: 위치, 회전, 크기)을 직접 애니메이션화합니다. 메시의 정점 수보다 애니메이션화할 변환 속성이 일반적으로 적으므로 스킨 메시 애니메이션보다 적은 컴퓨팅 리소스로 처리할 수 있습니다.

또한 변환 애니메이션은 키프레임 데이터처럼 더 간결한 형식으로 미리 계산해 저장할 수 있는 경우가 많습니다. 따라서 실시간으로 복잡한 계산을 수행하지 않고도 데이터를 빠르게 불러와 재생할 수 있습니다.

전반적으로 스킨 메시 애니메이션은 더 세밀하고 사실적인 애니메이션을 만들 수 있지만, 비디오 게임과 같은 성능이 중요한 애플리케이션에서는 변환 애니메이션을 선호하는 경우가 많습니다.

## 여러 애니메이션 클립 만들기 및 내보내기

모델에 원하는 만큼 애니메이션 클립을 넣을 수 있습니다. 애니메이션을 만들고, 탐색하고, 삭제하는 방법은 [이 섹션](https://www.notion.so/5e962e5d54a24bcb9b906748007eb4cc).

아래 동영상에서는 Blender에서 여러 애니메이션을 하나의 GLB 파일로 내보내는 방법을 알아봅니다.

[![Video Preview](https://img.youtube.com/vi/YxAB4bujO_w/maxresdefault.jpg)](https://www.youtube.com/watch?v=YxAB4bujO_w\&ab_channel=Decentraland)

## 여러 애니메이션을 하나로 내보내기

스켈레탈 애니메이션에서는 여러 오브젝트를 리깅하고 애니메이션을 하나의 애니메이션 클립으로 합칠 수 있지만, 오브젝트 애니메이션에서는 그렇게 할 수 없습니다. 애니메이션은 각각 별도로 내보내지며 한 번에 하나의 오브젝트만 재생됩니다. 이를 해결하려면 여러 애니메이션을 하나로 합쳐 모든 오브젝트가 동시에 움직이는 애니메이션 클립을 만들면 됩니다.

이렇게 하려면 각 오브젝트의 애니메이션을 다음 항목으로 푸시다운합니다. ***비선형 애니메이션 트랙*** 아래에 표시된 것처럼 말입니다.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-8afccec47cbfde7b5e599c969034e496b3bffbf2%2F03_object_animation_push_down_02.webp?alt=media)

*각 오브젝트의 애니메이션을 NLA 트랙으로 푸시다운합니다.*

모든 애니메이션이 NLA 에디터에 표시되면 모든 오브젝트를 선택하고 다음으로 이동합니다. **파일 > 내보내기 > glTF 2.0**. Include를 펼친 다음 Selected Objects를 선택합니다. Animation을 펼치고 다시 Animation을 펼친 후 **Group by NLA Track**의 선택을 해제합니다. Merged Animation Name에서 애니메이션 클립의 이름을 바꾼 다음 **Export glTF 2.0**.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-898a745f90fe801c9ce92f7cbc43955b8033b793%2F04_export_single_animation_clip.webp?alt=media)

*여러 애니메이션을 하나로 내보내기 위한 설정입니다.*

이 방법은 각 오브젝트에 애니메이션이 하나씩만 있을 때만 작동합니다. 오브젝트에 여러 애니메이션 클립이 있다면 각각 따로 내보내는 것이 좋습니다.

{% hint style="info" %}
**💡 팁**: 애니메이션을 직접 만드는 대신 범용 애니메이션을 다운로드해 모델에 적용할 수도 있습니다. 예를 들어 사람과 비슷한 특성을 가진 3D 캐릭터라면 다음 사이트에서 무료 또는 유료 애니메이션을 다운로드할 수 있습니다. [Mixamo](https://www.mixamo.com/#/).
{% endhint %}

## 샘플링

애니메이션의 수가 많거나 애니메이션과 모델을 함께 사용하면 애니메이션 파일이 너무 커질 수 있습니다.

샘플링은 애니메이션을 최적화하는 좋은 방법입니다. 샘플링 간격에 따라 애니메이션에서 키프레임을 얼마나 자주 베이크할지가 정해집니다. 예를 들어 샘플링 간격을 2로 설정하면 2프레임마다 키프레임이 생성됩니다. 샘플링 간격이 3이면 3프레임마다 키프레임을 베이크하는 식입니다. 샘플링 간격이 클수록 파일 크기는 작아집니다.

하지만 단점은 중요한 키프레임이 일부 손실되면서 애니메이션이 점점 덜 부드러워진다는 것입니다(키프레임이 애니메이션 전체에 고르지 않게 분포됩니다). 또한 **샘플링은 애니메이션의 프레임 수를 샘플링 레이트로 나누는 것이 아닙니다**.

일반적으로 **샘플링 간격은 2 또는 3** 이면 충분합니다. 이 값을 사용하면 품질을 저하시키지 않고 애니메이션을 최적화할 수 있습니다.

다음 항목은 내보내기 설정의 ***샘플링 레이트*** 아래에 있습니다. ***애니메이션***.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-52fa4c4a59da03d39b275a3ed87b05c5d417d3dc%2F05_sampling_rate.webp?alt=media)

{% hint style="info" %}
**💡 팁**: 애니메이션 프레임 수가 샘플링 레이트로 나누어떨어지면 좋습니다! 마지막 프레임도 베이크되어 애니메이션의 끝에서 시작으로 이어지는 전환이 보존됩니다.
{% endhint %}

## 애니메이션 구현

이 문서에서는 3D 모델에 애니메이션을 추가하는 방법을 설명합니다. 씬에서 애니메이션을 활성화하고 처리하는 방법은 [**애니메이션 처리**](https://docs.decentraland.org/creator/development-guide/3d-model-animations/) 를 참조하세요.

## 애니메이션 모범 사례

* 아마추어는 가능한 한 단순하게 유지하고, 애니메이션을 적용할 모델 부위에만 본을 만드세요. 본은 성능에 영향을 줄 수 있으므로 실제로 필요한 것만 추가해야 합니다.
* 씬에서 애니메이션을 반복 재생할 예정이라면, 전환이 자연스럽도록 마지막 포즈가 시작 포즈와 동일한지 확인하세요.
* 캐릭터가 아무것도 하지 않더라도 애니메이션 없이 두지 마세요. 캐릭터가 가만히 있을 때 사용할 "대기" 애니메이션을 만드세요. 대기 애니메이션에는 호흡이나 가끔 주위를 둘러보는 동작처럼 미묘한 움직임을 넣을 수 있습니다.
* 손, 손가락, 머리, 목과 같은 본을 포즈 없이 두지 마세요. 좋은 애니메이션에서는 세부 표현이 매우 중요하며, 뻣뻣한 움직임은 애니메이션의 사실감을 떨어뜨립니다.
* 정말 필요한 경우가 아니라면 키프레임을 너무 많이 사용하지 마세요. 키프레임이 많을수록 보간이 부자연스러워지고 애니메이션이 무거워질 가능성이 커집니다.
* 변형 본을 포함해 모든 본을 선택한 다음 애니메이션의 첫 프레임과 마지막 프레임에 키프레임을 설정하세요. 이렇게 하면 정보가 없는 본이 생기는 것을 방지하여 애니메이션끼리 의도치 않게 영향을 주는 일을 막을 수 있습니다.
* 내보낼 때 파일에 아마추어가 하나만 있는지 확인하세요. 애니메이션을 가져오면 아마추어도 함께 가져옵니다. 모든 애니메이션은 동일한 기본 아마추어를 사용해야 하므로 필요하지 않은 것은 모두 삭제하세요.
* 본과 애니메이션의 이름은 항상 변경하세요. 모든 항목을 체계적으로 정리하세요!
* 모델을 *glTF* 로 내보낼 때 모든 오브젝트와 애니메이션을 내보내는지 확인하세요. 일부 내보내기 도구는 기본적으로 ***현재 선택된 항목만*** 내보냅니다.
* 모델을 내보낸 후 [Babylon Sandbox](https://sandbox.babylonjs.com/) 에서 확인하여 모든 애니메이션이 제대로 작동하고 예상한 이름으로 표시되는지 살펴보세요.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.decentraland.org/creator/content-creator-ko/3d/animations.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
