> 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/wearables-and-emotes/emotes/avatar-rig.md).

# 아바타 리그

아바타 리그의 기본 사항.

리그는 모델을 움직일 수 있게 해 주는 가상 스켈레톤입니다. 실제 사람의 스켈레톤처럼 개별 본이 계층 구조를 이루며, 부모/자식 관계로 작동합니다. 이 문서에서는 본의 위치, 본의 방향, 변형 본과 비변형 본, IK와 FK의 차이와 용도 등 기본적인 리깅 개념을 다룹니다. 아바타 리그의 구조, 사용자 지정 속성, 애니메이션 설정은 다음에서 확인할 수 있습니다. [리그 기능](/creator/content-creator-ko/wearables-and-emotes/emotes/rig-features.md).

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

## **기본 사항**

#### 본 위치 또는 피벗 지점

리그가 사람의 스켈레톤을 정확히 복제하는 것은 아니지만, 디지털 본을 배치할 때 실제 뼈의 위치를 따르는 것이 좋습니다. 그래야 자연스럽고 부드러운 변형을 보장할 수 있습니다. 본의 위치는 피벗 지점(움직임이 시작되는 위치)을 설정하므로 중요합니다. 본을 잘못 배치하면 메시가 부자연스럽게 변형됩니다. 아래 이미지는 본 위치에 따른 차이를 보여 줍니다.

![head\_pivot\_rig\_1.0.gif](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/head_pivot_rig_1.0.gif)

![head\_pivot\_rig\_2.0.gif](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/head_pivot_rig_2.0.gif)

#### 뼈대 방향

본의 방향은 양의 X축, 음의 Z축 등 본이 어느 방향으로 회전할지 결정합니다. 리그 전체에서 일관성을 유지하기만 한다면 다양한 방식으로 설정할 수 있습니다. 예를 들어 척추를 앞으로 굽힐 때 X축을 사용한다면 다리에도 같은 설정을 적용하는 것이 좋습니다. 방향은 미러링 동작에도 영향을 미치므로 중요합니다. 일반적으로 오른쪽 방향은 왼쪽 방향을 미러링한 것이며, 그 반대도 마찬가지입니다.

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

*축을 켜서 본의 방향을 표시합니다.*

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

*축은 본이 회전하는 방향을 나타냅니다.*

#### 변형 본과 비변형 본

변형 본은 메시를 변형하며 모델의 움직임을 결정합니다. 이 본들이 기본 스켈레톤이며, **절대 편집해서는 안 됩니다**. 어떤 식으로든 변경하면 리그가 손상될 수 있으며, 내보낸 애니메이션이 작동하지 않습니다. 따라서 이 기본 리그는 별도의 레이어(맨 아래의 마지막 레이어)로 옮겨 두었습니다. 이 본들이 메시와 함께 내보내지는 아마추어입니다.

비변형 본은 메시를 변형하지 않지만, 견고한 리그를 구성하는 데 여전히 필요하며 다음 설정에 사용됩니다: [IK, FK](#whats-fk-and-ik-in-a-rig) 및 기타 사용자 지정 속성. 비변형 본의 예로는 컨트롤, IK 및 FK 본, 발 설정 본이 있습니다. 이 본들은 내보내면 안 되며, 애니메이션 용도로만 사용됩니다.

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

*변형 본.*

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

*비변형 본.*

{% hint style="warning" %}
⚠️ **주의!** **기본 스켈레톤은 절대 편집하지 마세요!**
{% endhint %}

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

*기본 스켈레톤.*

#### 컨트롤

리그가 손상될 수 있으므로, 변형 본을 조작해 애니메이션을 만드는 것은 바람직하지 않습니다. 대신 **컨트롤을 조작해 애니메이션을 만들어야 합니다.**

컨트롤은 기본적으로 비변형 본이므로 메시에는 영향을 주지 않습니다. 따라서 안전하게 조작하고 애니메이션을 적용할 수 있습니다. 컨트롤의 기능은 제약 조건과 드라이버를 통해 기본 스켈레톤을 직접 건드리지 않고 제어하는 것입니다. 컨트롤은 기능과 용도를 시각적으로 나타내기 위해 보통 모양과 색상이 서로 다르며, 덕분에 애니메이터가 본을 쉽게 구분할 수 있습니다. 일부 컨트롤에는 위치, 회전, 크기 조정 변환 외에도 IK/FK 전환과 같은 사용자 지정 속성을 추가할 수 있습니다.

또한 컨트롤 설정은 처음 설정한 소프트웨어가 아닌 다른 소프트웨어에서는 사용할 수 없다는 점도 알아 두어야 합니다. 소프트웨어마다 작동 방식이 다르며 제약 조건을 내보낼 수 없습니다.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-433b58253e5229cb7e7cc2f5b8b9fbb168c05a2b%2FRigControls.webp?alt=media) \_컨트롤과 각기 다른 모양 및 색상.\_

{% hint style="warning" %}
⚠️ **경고**: 리그는 만든 소프트웨어에서 애니메이션을 적용해야 합니다. 예를 들어 Blender에서 만든 설정은 Maya에서 사용할 수 없으며, 그 반대도 마찬가지입니다.
{% endhint %}

#### 리그에서 FK와 IK란 무엇인가요?

리그는 움직임에 영향을 주는 두 가지 설정, FK와 IK를 사용할 수 있습니다.

#### FK - 순방향 운동학

순방향 운동학(Forward Kinematics), 즉 FK에서는 계층 구조의 부모 본이 그 아래에 있는 모든 자식 본을 움직입니다. 팔을 예로 들어 보겠습니다. 어깨가 회전하면 팔의 나머지 부분도 함께 회전하고, 팔이 회전하면 아래팔도 그 움직임을 따라갑니다. FK로 애니메이션을 만들 때는 각 본을 개별적으로 회전해야 합니다. 이 설정을 사용하면 움직임을 세밀하게 제어할 수 있으며, 부드러운 애니메이션에 필수적인 호를 그리는 움직임을 만드는 데 적합합니다.

*계층 구조에서 움직임이 진행되는 방향.*

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

*FK에서는 각 본을 개별적으로 회전해야 합니다.*

#### IK - 역운동학

역운동학(Inverse Kinematics), 즉 IK에서는 계층 구조의 자식 본이 부모 본의 움직임에 영향을 줄 수 있습니다. 다시 팔을 예로 들면, 손을 움직일 때 팔의 나머지 부분이 그 움직임을 따라갑니다. 또한 어깨가 어떻게 움직이든 손의 위치가 유지됩니다. 이 설정에서는 폴 벡터/폴 타깃으로 본이 어느 방향으로 굽을지 제어합니다. 다리는 보통 IK를 사용하며, 애니메이션을 적용하는 동안 발이 지면에 붙어 있도록 하는 데 필수적입니다.

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

*계층 구조에서 움직임이 진행되는 방향.*

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

*IK에서는 손을 움직이면 팔 전체가 따라 움직이며 손의 위치도 유지됩니다. 폴 타깃은 팔꿈치가 굽는 방향을 제어합니다.*


---

# 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/wearables-and-emotes/emotes/avatar-rig.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.
