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

# Rig do Avatar

Noções básicas sobre o rig do avatar.

Um rig é um esqueleto virtual que permite que um modelo se mova. É composto por uma hierarquia de bones individuais, tal como um esqueleto real, e funciona com uma relação entre parent e child. Este documento aborda alguns conceitos básicos de rigging, como a posição e a orientação dos bones, bones deformadores e não deformadores, a diferença entre IK e FK e as respetivas finalidades. A estrutura do rig de um avatar, os atributos personalizados e a configuração para animação podem ser consultados em [características do rig](https://docs.decentraland.org/creator/content-creator-pt/wearables-e-emotes/emotes/rig-features.md).

{% hint style="info" %}
**💡 Dica**: Instale o [plugin Decentraland Tools Blender](https://extensions.blender.org/add-ons/decentraland-tools/). Inclui várias funções úteis para ajudar a editar e exportar modelos 3D, Wearables e Emotes.
{% endhint %}

## **Noções básicas**

#### Posição dos bones ou pontos de pivot

Embora um rig não seja uma réplica exata do esqueleto humano, é uma boa prática respeitar a posição dos bones reais ao colocar os bones digitais. Isto ajuda a garantir uma deformação fluida e convincente. A posição dos bones é importante porque define o ponto de pivot (o ponto a partir do qual o movimento começa). Um bone mal posicionado provoca uma deformação incorreta do Mesh. As imagens abaixo mostram a diferença na posição dos bones.

![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)

#### Orientação dos ossos

A orientação dos bones define a direção em que vão rodar, como X positivo, Z negativo, etc. Podem ser configurados de várias formas, desde que a configuração seja consistente em todo o rig. Por exemplo, se o eixo X for escolhido para o movimento de inclinação para a frente da coluna, faz sentido usar a mesma configuração nas pernas. A orientação também é importante porque afeta o comportamento do espelhamento. Isto significa que, normalmente, a orientação do lado direito é a versão espelhada da orientação do lado esquerdo, e vice-versa.

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

*Ative os eixos para mostrar a orientação dos bones.*

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

*Os eixos indicam as direções em que o bone vai rodar.*

#### Bones deformadores e não deformadores

Os bones deformadores são os que deformam o Mesh e determinam como o modelo se move. Constituem o esqueleto base e **não devem ser editados**. Alterá-los de qualquer forma pode danificar o rig e impedir que a animação funcione quando for exportada. Por esse motivo, este rig base foi colocado na sua própria camada (a última, na parte inferior). Estes bones constituem a armature exportada com o Mesh.

Os bones não deformadores não deformam o Mesh, mas continuam a ser necessários para criar um rig robusto e são usados na configuração de [IKs, FKs](#whats-fk-and-ik-in-a-rig) e outras propriedades personalizadas. Exemplos de bones não deformadores incluem os controlos, os bones de IK e FK e os bones de configuração dos pés. Estes não devem ser exportados; são usados apenas para animação.

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

*Bones deformadores.*

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

*Bones não deformadores.*

{% hint style="warning" %}
⚠️ **Atenção!** **Não edite o esqueleto base!**
{% endhint %}

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

*O esqueleto base.*

#### Controlos

Como boa prática, não se deve animar um rig manipulando os bones deformadores, pois isso pode danificá-lo. Em vez disso, **as animações devem ser feitas através da manipulação dos controlos.**

Os controlos são, basicamente, bones não deformadores, o que significa que não afetam o Mesh e podem ser manipulados e animados em segurança. A sua função é controlar o esqueleto base através de constraints e drivers, sem lhe tocar diretamente. Costumam ter formas e cores diferentes que indicam visualmente as suas funções e finalidades, facilitando ao animador a distinção entre bones. Alguns também podem ter mais do que transformações de localização, rotação e escala, pois é possível adicionar-lhes propriedades personalizadas, como um comutador IK/FK.

Também é importante notar que não é possível usar a configuração dos controlos num software diferente daquele em que foi criada. Cada software tem a sua própria lógica, e não é possível exportar constraints.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-433b58253e5229cb7e7cc2f5b8b9fbb168c05a2b%2FRigControls.webp?alt=media) \_Controlos e as suas diferentes formas e cores.\_

{% hint style="warning" %}
⚠️ **Aviso**: O rig tem de ser animado no mesmo software em que foi criado. Não é possível usar, por exemplo, uma configuração do Blender no Maya, nem vice-versa.
{% endhint %}

#### O que são FK e IK num rig?

Um rig pode usar duas configurações diferentes que influenciam a forma como se move: FK e IK.

#### FK - Cinemática direta

Na cinemática direta, ou FK, o parent na hierarquia move todos os bones child abaixo dele. Vejamos o braço como exemplo: quando o ombro roda, o resto do braço também roda; quando o braço roda, o antebraço acompanha o movimento. Ao animar em FK, cada bone tem de ser rodado individualmente. Esta configuração oferece muito controlo sobre o movimento e é excelente para movimentos em arco, essenciais para uma animação fluida.

*Direção do movimento na hierarquia.*

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

*Em FK, cada bone tem de ser rodado individualmente.*

#### IK - Cinemática inversa

Na cinemática inversa, ou IK, o child na hierarquia pode influenciar o movimento dos seus parents. Neste caso, usando novamente o braço como exemplo, ao mover a mão, o resto do braço acompanha o movimento. Isto também significa que, independentemente do movimento do ombro, a mão mantém a sua posição. Nesta configuração, um pole vector/pole target controla a direção em que os bones se dobram. As pernas costumam usar IK, o que é essencial para manter os pés ao nível do chão durante a animação.

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

*Direção do movimento na hierarquia.*

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

*Em IK, a mão move o braço todo e também mantém a sua posição. O pole target determina a direção em que o cotovelo se dobra.*


---

# 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-pt/wearables-e-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.
