> 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/rig-features.md).

# 리그 기능

아바타 리그와 다운로드 가능한 파일에 대한 기능.

이 문서에서는 Rig 1.0의 설정, 컨트롤 및 기능을 설명합니다.

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

### 아마추어 변환

컨트롤이 설정된 상태에서 오브젝트 모드에 표시되는 아마추어의 변환입니다. **어떤 식으로든 편집하지 마세요**. 리그는 포즈 모드에서만 조작해야 합니다. 원치 않는 편집을 방지하기 위해 오브젝트 모드에서는 변환이 잠겨 있습니다.

*Rig 1.0 변환.*

{% hint style="warning" %}
⚠️ **경고**: **오브젝트 모드에서 리그를 편집하지 마세요.**
{% endhint %}

## 뼈대 방향

다음은 Rig 1.0의 본 방향입니다.

*본 방향 축.*

*포즈를 미러링할 때의 동작.*

### 포즈 미러링

리그의 좌우 본은 배치 방식이 서로 다르므로, 몸 전체에 통하는 미러링 방법은 하나뿐일 수 없습니다. 먼저 **Pose > Copy Pose**를 선택한 다음 **Paste X-Flipped**를 선택하고, 상체는 직접 마무리하세요.

**붙여넣은 뒤에 다리와 발을 마무리합니다.** **Paste X-Flipped** 는 다음 컨트롤에서 정확한 결과를 제공합니다. `CTRL_FK_Avatar_UpLeg`, `CTRL_FK_Avatar_Leg`, `CTRL_FK_Avatar_Foot`, `CTRL_FK_Avatar_ToeBase`, `CTRL_IK_Foot`, `CTRL_IK_Avatar_ToeBase` 및 `CTRL_Avatar_Knee`에서 작동합니다. IK 다리에서는 정확히 일치하지만, 좌우 본의 기본 롤이 약간 달라 FK 다리의 발 위치는 약 3cm 정도 차이가 납니다. 정확한 위치가 필요하면 눈대중으로 FK 발을 조금 조정하세요.

**어깨, 팔, 손, 손가락은 한 단계를 더 거쳐야 합니다.** **Paste X-Flipped** 만 사용하면 반대쪽 손이 원하는 위치에서 40\~70cm 떨어집니다. 붙여넣은 다음, 다음 컨트롤을 하나씩 살펴보고 **Y 값은 그대로 두고 X와 Z 값을 반대로 바꾸세요**:

* `CTRL_Avatar_Shoulder`
* `CTRL_FK_Avatar_Arm`, `CTRL_FK_Avatar_ForeArm`, `CTRL_FK_Avatar_Hand`
* `CTRL_IK_Avatar_Hand`, `CTRL_IK_Avatar_Elbow`
* 총 30개의 `CTRL_Avatar_Hand*` 손가락 컨트롤

쿼터니언이나 오일러 각 중 어느 방식으로 작업하든 회전에 적용하세요. 어느 방식이든 부호는 같습니다. IK 손 및 팔꿈치 컨트롤에는 위치에도 적용하세요.

예를 들어 붙여넣은 팔의 X가 -0.5, Z가 0.1이라면 X는 0.5, Z는 -0.1로 바뀝니다.

이렇게 하면 팔 체인 전체가 정확히 맞습니다.

**상체에서 방식이 다른 이유:** 오른쪽 다리의 본 프레임은 왼쪽 프레임을 그대로 미러링한 형태이며, 이것이 바로 **Paste X-Flipped** 가 전제로 하는 방식입니다. 오른쪽 팔의 프레임은 왼쪽 프레임을 미러링하되 로컬 **Z** X 대신 축이 뒤집혀 있어 뒤집어 붙여넣은 결과가 잘못된 방향으로 회전합니다. X와 Z의 부호를 반전하면 정확히 바로잡을 수 있습니다.

#### 대신 값을 직접 설정하기

붙여넣기 대신 왼쪽의 원래 값을 기준으로 오른쪽 값을 설정하려면 다음과 같이 부호를 반전하세요.

| 컨트롤 | 회전 `(w, x, y, z)` | 위치           |
| --- | ----------------- | ------------ |
| 상체  | `(w, -x, -y, z)`  | `(x, y, -z)` |
| 다리  | `(w, x, -y, -z)`  | `(-x, y, z)` |

이 방법은 대략적인 경로입니다. 팔은 약 1mm 이내로 맞지만, FK 다리는 5\~10cm 정도 오차가 납니다. **X축 반전 붙여넣기** 를 사용하면 왼쪽과 오른쪽 기본 포즈 뼈대 사이의 미세한 롤 차이도 보정할 수 있지만, 부호만 반전하면 보정되지 않습니다. 위에서 설명한 붙여넣은 다음 수정하는 방법을 권장합니다.

{% hint style="warning" %}
**📔 참고**: 시작 포즈는 애초에 완벽하게 대칭이 아니므로 한쪽의 포즈를 반대쪽에 미러링하면 그 미세한 비대칭이 덮어써집니다. 키프레임을 설정하기 전에 결과를 눈으로 확인하세요.
{% endhint %}

### 팔 회전하기

상완 컨트롤인 `CTRL_FK_Avatar_Arm`은 로컬 X축이 기울어져 있습니다. 이 축을 중심으로 회전하면 팔이 가슴을 가로질러 움직입니다. 팔을 들어 올리려 했는데 팔이 교차되는 가장 흔한 원인입니다.

* 팔을 **향하게** 하려면 로컬 축 대신 월드 축을 기준으로 회전하세요. 월드 X축은 팔을 앞으로 들어 올리고, 월드 Z축은 팔을 안팎으로 움직입니다.
* 팔을 **비틀려면** 손바닥이 위나 아래를 향하고 팔꿈치가 안이나 밖을 향하도록 뼈대 자체의 로컬 Y축을 중심으로 회전하세요.

### 각 관절이 꺾이는 축

팔꿈치와 무릎은 로컬 X축을 기준으로 꺾입니다. 손목과 손가락은 그렇지 않습니다. 이들은 로컬 Z축을 기준으로 굽혀집니다. 손가락을 로컬 X축을 중심으로 회전하면 옆으로 움직입니다. 완성된 이모트에서 손가락이 잘못된 방향으로 접히는 가장 흔한 원인입니다.

| 컨트롤                                                    | 꺾이는 축                                    | 다른 축                                                    |
| ------------------------------------------------------ | ---------------------------------------- | ------------------------------------------------------- |
| 팔꿈치 `CTRL_FK_Avatar_ForeArm`, 무릎 `CTRL_FK_Avatar_Leg`  | 로컬 X축                                    | Y축과 Z축은 잠겨 있음                                           |
| 손목 `CTRL_FK_Avatar_Hand`                               | 로컬 Z축을 기준으로 회전하면 손이 손바닥 쪽으로 굽혀집니다.       | 로컬 X축을 기준으로 회전하면 손이 옆으로 기울어집니다.                         |
| 손가락 `CTRL_Avatar_Hand{Index,Middle,Ring,Pinky}{1,2,3}` | 로컬 Z축을 기준으로 회전하면 손가락이 손바닥 쪽으로 굽혀집니다.     | 로컬 X축을 기준으로 회전하면 손바닥 면을 따라 손가락이 옆으로 움직입니다. Y축은 잠겨 있습니다. |
| 엄지손가락 밑부분 `CTRL_Avatar_HandThumb1`                     | 로컬 X축을 기준으로 회전하면 엄지손가락이 손바닥을 가로질러 움직입니다. | Y가 잠겨 있습니다                                              |
| 엄지 `CTRL_Avatar_HandThumb2`, `CTRL_Avatar_HandThumb3`  | 로컬 Z축은 엄지를 굽힙니다                          | Y가 잠겨 있습니다                                              |

양손의 굽힘 방향은 같습니다. 팔꿈치 굽힘, 손목 기울임, 손바닥을 가로지르는 엄지의 회전 방향은 왼쪽과 오른쪽이 서로 반대이므로, 한쪽에서 맞는 값을 다른 쪽에 적용할 때는 부호를 반대로 해야 합니다.

### 본 컬렉션

실수로 인한 문제를 방지하고 컨트롤을 더 쉽게 식별할 수 있도록 이 리그는 본 컬렉션으로 구성되어 있으며, Blender의 *데이터 속성* 탭에서 이용할 수 있습니다. 컬렉션의 표시 여부는 *눈 아이콘* 을 클릭해 켜고 끌 수 있습니다. 기본적으로 모든 컬렉션이 표시되며, DON'T TOUCH 컬렉션만 숨겨져 있습니다.

아마추어 데이터 속성 탭

본은 다음과 같이 컬렉션별로 분류되어 있습니다.

* Global/Switch: 루트와 척추, 어깨 등 전역 컨트롤이 포함됩니다. 사용자 지정 속성이 있는 컨트롤도 이 컬렉션에 포함됩니다.
* FK Upper: 상체 FK 설정 컨트롤 전체.
* FK Lower: 하체 FK 설정 컨트롤 전체.
* IK Upper: 상체 IK 설정 컨트롤 전체.
* IK Lower: 하체 IK 설정 컨트롤 전체.
* Fingers: 양손 손가락 컨트롤.
* Deformation Bones: 변형 본이 저장되는 컬렉션입니다.

{% hint style="warning" %}
**⚠️ 주의!**

DON'T TOUCH 컬렉션에는 IK 및 기타 리그 제약 조건 설정이 들어 있으므로 숨겨진 상태로 유지해야 합니다. 이 본을 편집하면 리그 기능이 손상될 수 있습니다.
{% endhint %}

## 컨트롤 및 그룹화

컨트롤은 기본 스켈레톤을 구동하는 비변형 본입니다. 카테고리에 따라 색상이 다릅니다.

* 노란색: 전역 컨트롤 및 사용자 지정 속성이 있는 컨트롤
* 초록색: 엉덩이(척추 계층 구조에서 더 쉽게 식별 가능)
* 파란색: FK 동작을 하는 컨트롤
* 빨간색: IK 컨트롤
* 분홍색: 왼쪽 컨트롤
* 주황색: 오른쪽 컨트롤

*모든 컨트롤과 각 컨트롤의 색상입니다.*

## 사용자 지정 속성 및 설정

### FK/IK 블렌드

일반적으로 팔은 FK, 다리는 IK로 설정하지만, 다른 설정이 필요한 상황도 있습니다. 팔굽혀펴기를 하거나 기어오를 때처럼 손의 특정 위치를 유지해야 한다면 IK를 사용하는 것이 가장 좋습니다. 다리는 공중에 있거나 수영하거나 구르는 동안 FK가 가장 적합합니다. 애니메이션을 더 유연하고 자유롭게 만들 수 있도록 이 리그의 UpperBody 컨트롤에는 FK/IK 블렌드가 있습니다. 값이 0이면 완전히 FK, 1이면 완전히 IK이며, 그 사이의 값은 두 방식이 혼합됩니다.

![양팔과 양다리의 FK/IK 블렌드.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/ik_fk_rig_1.0.png)

*양팔과 양다리의 FK/IK 블렌드.*

![FK > IK 전환 작동 방식.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/IK_FK_rig_1.0.gif)

*FK > IK 전환 작동 방식.*

대부분의 경우 다음과 같은 간단한 규칙을 적용할 수 있습니다. 팔다리가 무언가에 닿아 있으면 IK를 유지하고, 접촉을 잃고 자유롭게 움직이면 FK로 전환합니다. 앉은 자세의 경우:

* **양발이 바닥에 닿아 있는 경우**: 다리를 IK로 유지합니다. 발은 `CTRL_IK_Foot`로 움직인 다음 `CTRL_Avatar_UpperBody` 를 낮춰 몸을 내립니다. 발은 바닥에 고정된 채 유지됩니다. 무릎 방향은 `CTRL_Avatar_Knee`.
* **한쪽 다리를 다른 쪽 다리 위로 꼰 경우**: 들어 올린 다리만 FK로 전환합니다.
* **발이 허공에 매달린 경우**: 양쪽 다리를 모두 FK로 전환합니다.

사용 `CTRL_Avatar_UpperBody` 몸 전체를 위아래로 움직입니다. 무게중심 역할을 합니다. `CTRL_Avatar_Hips` 골반과 다리만 움직여 몸통을 늘어나게 하므로, 앉는 동작에는 적합하지 않은 컨트롤입니다.

{% hint style="warning" %}
**📔 참고**: 클립 중간에 팔다리를 FK와 IK 사이에서 전환하지 마세요. 해당 프레임에서 두 체인이 정확히 일치하지 않으면 팔다리가 튀어 보입니다. 전환해야 한다면 FK > IK 속성 자체에 키프레임을 설정해 원하는 시점에 전환되도록 하세요.
{% endhint %}

#### IK로 얼굴이나 타깃에 닿게 하기

손이 얼굴이나 소품, 또는 다른 손에 닿게 하려면 해당 팔을 IK로 전환하세요. FK 관절을 회전하는 방식으로는 손끝을 타깃에 안정적으로 맞추기 어렵습니다. IK 손 컨트롤은 손목에 있으므로, 컨트롤을 타깃에 놓으면 손끝이 아니라 손목이 타깃에 위치한다는 점에 유의하세요. 손끝이 원하는 위치에 오도록 컨트롤을 움직이세요.

FK > IK 속성은 키프레임 사이에서 서서히 블렌딩됩니다. 전환하는 키프레임에서는 FK 팔을 IK 포즈에 가깝게 맞추세요. 그렇지 않으면 옆에 축 늘어진 FK 팔이 블렌딩되는 동안 가슴을 가로질러 휘둘립니다.

기본 아바타를 유휴 포즈로 세워 측정한 다음 치수를 참고해 손을 얼굴에 위치시키세요.

| 기준점             | 바닥으로부터의 높이             | 다음 기준의 상대 위치: `Avatar_Head` 본              |
| --------------- | ---------------------- | ------------------------------------------ |
| `Avatar_Head` 본 | 1.72 m                 | 두개골 밑부분이 아닌 얼굴 중앙입니다                       |
| 코끝              | 1.66 m (남성 체형은 1.64 m) | 앞으로 0.19 m, 아래로 0.06 m (남성 체형은 아래로 0.08 m) |
| 턱               | 1.60 m                 | 아래로 0.12 m                                 |
| 정수리             | 1.90 m                 | 위로 0.18 m                                  |

머리 너비는 약 0.30 m입니다. 머리 본보다 0.12 m 위를 향해 손을 놓으면 이마에 닿습니다. 머리가 회전한 경우에는 회전된 머리 좌표계를 기준으로 이 오프셋을 적용하세요.

### 회전 상속 FK 블렌드 분리

UpperBody 컨트롤에는 회전 분리라는 사용자 지정 속성도 있습니다. 이 속성을 사용하면 FK 상태에서 본이 부모의 회전을 상속할지 여부를 선택할 수 있습니다. 값이 0이면 본이 회전을 상속하지 않고, 1이면 부모의 동작을 완전히 따릅니다. 그 사이의 값은 두 동작을 블렌딩합니다. 이 기능을 사용하면 FK 본의 위치가 유지되어 IK와 비슷하게 동작하므로 유용합니다.

![팔의 회전 분리 속성.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/IsoRot_rig_1.0.png)

*팔의 회전 분리 속성.*

![팔의 IsoRot 속성 작동 방식.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/IsoRot_Arms_rig_1.0.gif)

*팔의 IsoRot 속성 작동 방식.*

Head 컨트롤에도 이 속성이 있습니다. 예를 들어 걷기 사이클에서 매우 유용합니다. 몸통이 비틀려도 머리의 회전이 유지되어 항상 앞을 바라보게 할 수 있기 때문입니다. 이 옵션이 없으면 몸통이 비틀릴 때마다 애니메이터가 머리를 수동으로 회전해 똑바로 앞을 바라보게 해야 합니다.

![머리의 회전 분리 속성.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/IsoRot_Head_rig_1.0.png)

*머리의 회전 분리 속성.*

![머리의 IsoRot 속성 작동 방식.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/IsoRot_Head_rig_1.0.gif)

*머리의 IsoRot 속성 작동 방식.*

{% hint style="warning" %}
⚠️ **경고**: 이전 버전의 Blender에서는 모든 컨트롤을 선택하고 키프레임을 설정해도 이러한 사용자 지정 속성에 키프레임이 자동으로 설정되지 않습니다. 만든 포즈나 동작을 잃지 않도록 각 속성에 키프레임을 수동으로 삽입하세요. Blender 4.4에서는 I를 누르면 모든 속성과 사용자 지정 속성에 키프레임이 설정됩니다.
{% endhint %}

![이전 버전의 Blender에서는 모든 컨트롤과 사용자 지정 속성에 키프레임을 설정해야 합니다!](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/custom_attributes.gif)

*이전 버전의 Blender에서는 모든 컨트롤과 사용자 지정 속성에 키프레임을 설정해야 합니다!*

*Blender 4.4에서는 I를 눌러 위치, 회전, 크기 및 사용자 지정 속성에 키프레임을 자동으로 설정하세요.*

사용자 지정 속성에 키프레임을 설정하는 또 다른 방법은 ***키프레임*** 타임라인 탭에서 선택한 다음 ***활성 키잉 세트*** 에서 아래 GIF에 표시된 것처럼 위치, 회전, 크기 및 사용자 지정 속성을 선택하는 것입니다. 이렇게 하면 I를 누를 때마다 팝업 메뉴 없이 키프레임이 생성됩니다. 일부 애니메이터는 메뉴를 선호하므로 기본적으로 이 옵션은 활성화되어 있지 않습니다. 원하는 방법을 선택해 사용하세요.

![키잉 옵션을 사용한 키프레임 설정.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/keyframe_custom_properties.gif)

*키잉 옵션을 사용한 키프레임 설정.*

### 역방향 IK 발 설정

FK 발 애니메이션은 매우 간단합니다. 컨트롤 중 하나를 잡고 회전하기만 하면 됩니다. 발 컨트롤과 발가락 컨트롤이 각각 있어 애니메이터가 움직임을 완전히 제어할 수 있습니다. 하지만 IK는 그리 간단하지 않습니다. 발은 바닥에 붙어 있어야 하는 동시에 발볼과 뒤꿈치를 중심으로 회전하거나 좌우로 기울어질 수 있어야 합니다.

이 리그는 IK 시스템의 장점을 유지하면서 애니메이터가 발을 자유롭게 움직일 수 있도록 설정되었습니다. 다음 네 가지 컨트롤로 구성됩니다:

* 발 롤(Foot roll): 이 컨트롤은 발을 앞뒤와 좌우로 회전합니다. 뒤꿈치나 발볼이 지나치게 꺾이지 않도록 발 리그가 손상되지 않는 범위로 제한을 설정했습니다. 이 한계에 도달하면 발의 회전이 멈춥니다.

![발 롤(Foot roll): X축으로 회전하면 발이 앞뒤로 움직이고, Z축으로 회전하면 좌우로 움직입니다.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/foot_roll.gif)

*발 롤(Foot roll): X축으로 회전하면 발이 앞뒤로 움직이고, Z축으로 회전하면 좌우로 움직입니다.*

* 발끝 롤(Toe tip roll): 발가락 끝을 기준으로 발을 회전합니다. 앞쪽으로만 회전합니다.

![발끝 롤은 양의 X 방향으로만 회전합니다.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/toe_tip.gif)

*발끝 롤은 양의 X 방향으로만 회전합니다.*

* 발가락 컨트롤(Toes control): 발볼을 기준으로 발가락을 회전합니다.

![발가락은 어느 방향으로든 회전할 수 있습니다.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/toes.gif)

*발가락은 어느 방향으로든 회전할 수 있습니다.*

* 발 컨트롤(Foot control): 발 전체를 움직이는 전역 컨트롤입니다. 다른 모든 발 컨트롤의 부모이므로, 모든 변환을 유지하면서 발을 잡고 회전할 수도 있습니다.

![발 컨트롤의 작동 방식](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/foot.gif)

*발 컨트롤의 작동 방식*

### 잠긴 변환

일부 컨트롤의 변환 매개변수 옆에는 잠금 기호가 표시될 수 있습니다. 이는 해당 값을 변경할 수 없다는 뜻입니다. 특정 방식으로만 작동해야 하는 컨트롤에 잠금을 적용해 원치 않는 변형을 방지했습니다. 예를 들어 팔꿈치와 무릎은 X축 한 방향으로만 회전해야 하므로 다른 축은 잠겨 있습니다. IK 팔꿈치와 무릎, 손가락, 발 롤, 발끝 롤도 속성이 잠긴 컨트롤의 예입니다.

잠금 상태를 유지하는 것이 좋습니다. 다만 더 자유롭게 움직이고 싶다면 잠금 아이콘을 클릭해 잠금을 해제하세요.

잠금은 Blender의 대화형 도구에만 적용됩니다. 뼈의 회전을 직접 기록하는 Python 스크립트는 잠금을 무시하므로, 스크립트로 리그의 포즈를 설정할 때는 각 관절의 자유 축에서 회전이 이루어지도록 직접 관리하세요.

![컨트롤의 잠긴 변환](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/locked_transform.png)


---

# 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/rig-features.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.
