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

# Recursos do Rig

Recursos sobre o rig do avatar e o arquivo para download.

Esta documentação explica a configuração, os controles e os recursos do Rig 1.0.

{% 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 %}

### Transformações da armature

Estas são as transformações da armature no Object Mode com a configuração dos controles. **Não edite isso de forma alguma**. O rig deve ser manipulado somente no Pose Mode. Para evitar alterações indesejadas, as transformações foram bloqueadas no Object Mode.

*Transformações do Rig 1.0.*

{% hint style="warning" %}
⚠️ **Aviso**: **Nunca edite o rig no Object Mode.**
{% endhint %}

## Orientação dos ossos

Esta é a orientação dos bones do Rig 1.0.

*Eixos da orientação dos bones.*

*Comportamento ao espelhar poses.*

### Espelhando uma pose

Os bones esquerdo e direito do rig não estão dispostos da mesma forma, então um único truque de espelhamento não funciona para o corpo inteiro. Comece com **Pose > Copy Pose**, depois **Paste X-Flipped**, e finalize a parte superior do corpo manualmente.

**As pernas e os pés são ajustados depois de colar.** **Paste X-Flipped** produz o resultado correto em `CTRL_FK_Avatar_UpLeg`, `CTRL_FK_Avatar_Leg`, `CTRL_FK_Avatar_Foot`, `CTRL_FK_Avatar_ToeBase`, `CTRL_IK_Foot`, `CTRL_IK_Avatar_ToeBase` e `CTRL_Avatar_Knee`. O resultado é exato para as pernas IK e fica a cerca de 3 cm do ponto desejado no pé para as pernas FK, porque os bones em repouso esquerdo e direito têm rolls ligeiramente diferentes. Se precisar de precisão, ajuste o pé FK visualmente.

**Ombros, braços, mãos e dedos precisam de mais uma etapa.** **Paste X-Flipped** sozinho posiciona a outra mão entre 40 e 70 cm longe de onde deveria ficar. Depois de colar, percorra cada um destes controles e **inverta os valores de X e Z, mantendo Y**:

* `CTRL_Avatar_Shoulder`
* `CTRL_FK_Avatar_Arm`, `CTRL_FK_Avatar_ForeArm`, `CTRL_FK_Avatar_Hand`
* `CTRL_IK_Avatar_Hand`, `CTRL_IK_Avatar_Elbow`
* Todos os 30 `CTRL_Avatar_Hand*` controles dos dedos

Aplique isso à rotação, quer você trabalhe com quaternions ou ângulos de Euler. Os sinais são os mesmos nos dois casos. Nos controles IK da mão e do cotovelo, aplique isso também à localização.

Por exemplo, um braço colado com os valores X -0.5 e Z 0.1 passa a ter X 0.5 e Z -0.1.

Isso deixa toda a cadeia do braço exatamente correta.

**Por que a parte superior do corpo é diferente:** os referenciais dos bones da perna direita são um espelho exato dos da esquerda, como **Paste X-Flipped** supõe. Os referenciais do braço direito espelham os do esquerdo com o local **Z** eixo foi invertido em vez do X, pelo que a colagem espelhada fica rodada na direção errada. Negar X e Z corrige exatamente isso.

#### Definir os valores diretamente

Se definir os valores do lado direito com base nos valores originais do lado esquerdo, em vez de os colar, use estas inversões de sinal:

| Controlos               | Rotação `(w, x, y, z)` | Localização  |
| ----------------------- | ---------------------- | ------------ |
| Parte superior do corpo | `(w, -x, -y, z)`       | `(x, y, -z)` |
| Pernas                  | `(w, x, -y, -z)`       | `(-x, y, z)` |

Este é o método aproximado: fica a cerca de 1 mm de distância para os braços, mas 5 a 10 cm para as pernas FK. **Colar com inversão no eixo X** também corrige as pequenas diferenças de rotação entre os ossos em repouso dos lados esquerdo e direito, o que uma simples inversão de sinal não faz. Prefira o método de colar e corrigir descrito acima.

{% hint style="warning" %}
**📔 Nota**: A pose inicial não é perfeitamente simétrica, pelo que espelhar a pose de um lado para o outro elimina essa pequena assimetria. Verifique o resultado visualmente antes de criar os keyframes.
{% endhint %}

### Rodar os braços

O controlo do braço, `CTRL_FK_Avatar_Arm`, tem um eixo X local inclinado. Rodar em torno dele faz o braço atravessar o peito, que é a razão mais comum para os braços ficarem cruzados quando a intenção era levantá-los.

* Para **apontar** o braço, rode-o em torno dos eixos globais: o X global levanta-o para a frente e o Z global move-o para dentro e para fora.
* Para **rodar sobre si próprio** o braço, fazendo a palma virar para cima ou para baixo e o cotovelo apontar para dentro ou para fora, rode-o em torno do Y local do osso.

### Eixo de flexão de cada articulação

Os cotovelos e os joelhos dobram-se em torno do X local. Os pulsos e os dedos não: enrolam-se em torno do Z local. Rodar um dedo em torno do X local move-o para o lado, que é a razão mais comum para os dedos se dobrarem na direção errada numa emote finalizada.

| Controlo                                                       | Dobrar em torno de                          | Outros eixos                                                      |
| -------------------------------------------------------------- | ------------------------------------------- | ----------------------------------------------------------------- |
| Cotovelo `CTRL_FK_Avatar_ForeArm`, joelho `CTRL_FK_Avatar_Leg` | X local                                     | Y e Z estão bloqueados                                            |
| Pulso `CTRL_FK_Avatar_Hand`                                    | O Z local flexiona a mão em direção à palma | O X local inclina-a para o lado                                   |
| Dedos `CTRL_Avatar_Hand{Index,Middle,Ring,Pinky}{1,2,3}`       | O Z local enrola o dedo em direção à palma  | O X local move-o para o lado, no plano da palma. Y está bloqueado |
| Base do polegar `CTRL_Avatar_HandThumb1`                       | O X local move o polegar ao longo da palma  | Y está bloqueado                                                  |
| Polegar `CTRL_Avatar_HandThumb2`, `CTRL_Avatar_HandThumb3`     | O eixo Z local curva o polegar              | Y está bloqueado                                                  |

Os dedos curvam-se na mesma direção em ambas as mãos. A flexão do cotovelo, a inclinação do pulso e o movimento do polegar através da palma seguem em direções opostas nos lados esquerdo e direito, pelo que o sinal de um valor que funcione num lado tem de ser invertido no outro.

### Coleções de ossos

Para evitar acidentes e facilitar a identificação dos controlos, este rig está organizado em coleções de ossos, acessíveis no separador *Propriedades dos dados* do Blender. Pode ativar ou desativar a visibilidade destas coleções clicando no *ícone do olho.* Por predefinição, estão todas visíveis, exceto as coleções DON'T TOUCH.

Separador Armature Data Properties.

Foi assim que os ossos foram separados em coleções:

* Global/Switch: controlos globais, como os da raiz e da coluna, bem como os ombros. Os controlos com atributos personalizados também estão nesta coleção.
* FK Upper: todos os controlos da configuração FK da parte superior do corpo.
* FK Lower: todos os controlos da configuração FK da parte inferior do corpo.
* IK Upper: todos os controlos da configuração IK da parte superior do corpo.
* IK Lower: todos os controlos da configuração IK da parte inferior do corpo.
* Fingers: controlos dos dedos de ambas as mãos.
* Deformation Bones: é aqui que são guardados os ossos de deformação.

{% hint style="warning" %}
**⚠️ Atenção!**

As coleções DON'T TOUCH contêm as configurações de IK e outras restrições do rig e devem permanecer ocultas. Editar estes ossos pode comprometer o funcionamento do rig.
{% endhint %}

## Controlos e agrupamento

Os controlos são ossos que não deformam e que orientam o esqueleto base. Têm cores diferentes, consoante a sua categoria:

* Amarelo: controlos globais e controlos com atributos personalizados
* Verde: anca (mais fácil de identificar na hierarquia da coluna)
* Azul: controlos com comportamento FK
* Vermelho: controlos IK
* Cor-de-rosa: controlos do lado esquerdo
* Laranja: controlos do lado direito

*Todos os controlos e respetivas cores.*

## Atributos personalizados e configuração

### Mistura FK/IK

Embora os braços sejam normalmente configurados como FK e as pernas como IK, há situações que exigem uma configuração diferente. Se a mão tiver de manter uma determinada posição, como durante flexões ou ao trepar, a IK é a melhor opção. Quanto às pernas, a FK é mais adequada quando estão no ar, a nadar ou a rebolar. Para maior flexibilidade e liberdade na animação, este rig inclui uma mistura FK/IK no controlo UpperBody: 0 corresponde a FK total e 1 a IK total. Qualquer valor intermédio combina os dois.

![Mistura FK/IK para ambos os braços e pernas.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/ik_fk_rig_1.0.png)

*Mistura FK/IK para ambos os braços e pernas.*

![Como funciona a mudança de FK para IK.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/IK_FK_rig_1.0.gif)

*Como funciona a mudança de FK para IK.*

Uma regra simples aplica-se à maioria dos casos: se um membro mantiver contacto com alguma coisa, mantenha-o em IK; se perder o contacto e se mover livremente, mude-o para FK. Para uma pose sentada:

* **Ambos os pés no chão**: mantenha as pernas em IK. Mova os pés com `CTRL_IK_Foot`, depois baixe `CTRL_Avatar_UpperBody` para baixar o corpo. Os pés permanecem assentes no chão. Oriente os joelhos com `CTRL_Avatar_Knee`.
* **Uma perna cruzada sobre a outra**: mude apenas a perna levantada para FK.
* **Pés suspensos**: mude ambas as pernas para FK.

Utilize `CTRL_Avatar_UpperBody` para mover todo o corpo para cima e para baixo. É o centro de gravidade. `CTRL_Avatar_Hips` move apenas a pélvis e as pernas, o que estica o tronco; por isso, não é o controlo adequado para se sentar.

{% hint style="warning" %}
**📔 Nota**: Evite alternar um membro entre FK e IK a meio de um clip. A menos que as duas cadeias estejam perfeitamente alinhadas nesse fotograma, o membro dá um salto. Se precisar de alternar, crie um keyframe na própria propriedade FK > IK para que a alteração aconteça no momento pretendido.
{% endhint %}

#### Tocar no rosto ou num alvo com IK

Para fazer uma mão tocar em algo, como o rosto, um objeto ou a outra mão, mude esse braço para IK. As articulações FK rotativas não permitem posicionar a ponta de um dedo num alvo com fiabilidade. Tenha em conta que o controlo da mão em IK fica no pulso; por isso, se colocar o controlo no alvo, é o pulso que lá fica, não a ponta do dedo. Mova o controlo até a ponta do dedo ficar onde pretende.

A propriedade FK > IK faz uma transição gradual entre os respetivos keyframes. Nos keyframes em que a altera, coloque o braço FK numa pose próxima da pose IK. Caso contrário, um braço FK deixado pendurado ao lado do corpo atravessa o peito durante a transição.

Use estas medidas da cabeça do avatar predefinido, obtidas com o avatar de pé na pose de repouso, para posicionar uma mão no rosto:

| Ponto de referência | Altura acima do chão               | Posição relativa ao `Avatar_Head` osso                               |
| ------------------- | ---------------------------------- | -------------------------------------------------------------------- |
| `Avatar_Head` osso  | 1,72 m                             | Este é o centro do rosto, não a base do crânio                       |
| Ponta do nariz      | 1,66 m (1,64 m no corpo masculino) | 0,19 m para a frente e 0,06 m para baixo (0,08 m no corpo masculino) |
| Queixo              | 1,60 m                             | 0,12 m para baixo                                                    |
| Topo da cabeça      | 1,90 m                             | 0,18 m para cima                                                     |

A cabeça tem cerca de 0,30 m de largura. Uma mão apontada 0,12 m acima do osso da cabeça fica na testa. Se a cabeça estiver rodada, aplique estes desvios no referencial rodado da cabeça.

### Isolar a transição de rotação FK

Outro atributo personalizado do controlo UpperBody é o isolamento da rotação, que permite escolher se o osso herda ou não a rotação do osso-pai (em FK). Com o valor 0, o osso não herda a rotação; com o valor 1, segue completamente o comportamento do osso-pai. Qualquer valor intermédio cria uma transição entre os dois. Esta ferramenta é interessante porque permite que o osso FK mantenha a sua posição, comportando-se um pouco como IK.

![Atributo de isolamento da rotação dos braços.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/IsoRot_rig_1.0.png)

*Atributo de isolamento da rotação dos braços.*

![Como funciona o atributo IsoRot dos braços.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/IsoRot_Arms_rig_1.0.gif)

*Como funciona o atributo IsoRot dos braços.*

O controlo Head também tem este atributo. É muito útil, por exemplo, nos ciclos de caminhada, pois a cabeça mantém a sua rotação mesmo quando o tronco se torce, garantindo que olha sempre em frente. Sem esta opção, o animador teria de rodar manualmente a cabeça sempre que o tronco se torcesse, para que esta ficasse direita e voltada para a frente.

![Atributo de isolamento da rotação da cabeça.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/IsoRot_Head_rig_1.0.png)

*Atributo de isolamento da rotação da cabeça.*

![Como funciona o atributo IsoRot da cabeça.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/IsoRot_Head_rig_1.0.gif)

*Como funciona o atributo IsoRot da cabeça.*

{% hint style="warning" %}
⚠️ **Aviso**: Nas versões mais antigas do Blender, mesmo que todos os controlos tenham sido selecionados e tenham sido criados keyframes, estes atributos personalizados não recebem keyframes automaticamente. Certifique-se de inserir manualmente um keyframe em cada atributo para não perder a pose ou o movimento que criou. No Blender 4.4, ao premir I, é criado um keyframe para todos os atributos e propriedades personalizadas.
{% endhint %}

![Nas versões anteriores do Blender, certifique-se de criar keyframes para todos os controlos e atributos personalizados!](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/custom_attributes.gif)

*Nas versões anteriores do Blender, certifique-se de criar keyframes para todos os controlos e atributos personalizados!*

*No Blender 4.4, prima I para criar automaticamente um keyframe para Location, Rotation, Scale e Custom Properties.*

Outra solução para criar keyframes de propriedades personalizadas é selecionar ***Keying*** na secção da Timeline e, em ***Active Keying Set*** selecionar Location, Rotation, Scale e Custom Properties, como mostrado no GIF abaixo. Assim, sempre que premir I, será criado um keyframe sem que apareça o menu pop-up. Como alguns animadores preferem o menu, esta opção está desativada por predefinição. Mas pode escolher o método que preferir.

![Criação de keyframes com a opção Keying.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/keyframe_custom_properties.gif)

*Criação de keyframes com a opção Keying.*

### Configuração de IK reverso do pé

Animar um pé FK é bastante simples: basta selecionar qualquer um dos controlos e rodá-lo. Como existe um controlo para o pé e outro para os dedos, o animador tem controlo total sobre os movimentos. Com IK, porém, não é tão simples. O pé tem de ficar assente no chão, mas também tem de poder rodar sobre a planta e o calcanhar, bem como para os lados.

Este rig foi configurado para dar ao animador liberdade de movimento do pé sem perder as vantagens do sistema IK. É composto por quatro controlos:

* Rolagem do pé: este controlo roda o pé para a frente e para trás e de um lado para o outro. Para evitar que o calcanhar ou a bola do pé se dobrem demasiado, foi definido um limite para que o rig do pé não se danifique. Quando atingir esse limite, o pé deixa de rodar.

![Rolagem do pé: rode no eixo X para o mover para a frente e para trás; rode no eixo Z para o mover de um lado para o outro.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/foot_roll.gif)

*Rolagem do pé: rode no eixo X para o mover para a frente e para trás; rode no eixo Z para o mover de um lado para o outro.*

* Rolagem da ponta dos dedos do pé: roda o pé a partir da ponta dos dedos. Só roda para a frente.

![A rolagem da ponta dos dedos do pé só roda no sentido positivo do eixo X.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/toe_tip.gif)

*A rolagem da ponta dos dedos do pé só roda no sentido positivo do eixo X.*

* Controlo dos dedos do pé: roda os dedos a partir da bola do pé.

![Os dedos do pé podem ser rodados em qualquer direção.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/toes.gif)

*Os dedos do pé podem ser rodados em qualquer direção.*

* Controlo do pé: este é um controlo global que move o pé como um todo. Como é o elemento principal de todos os outros controlos do pé, mantém todas as transformações e também pode ser agarrado e rodado.

![Como funciona o controlo do pé.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/foot.gif)

*Como funciona o controlo do pé.*

### Transformações bloqueadas

Alguns controlos podem ter um símbolo de cadeado junto aos parâmetros de transformação, o que significa que esses valores não podem ser alterados. Isto foi aplicado a controlos que devem comportar-se apenas de uma determinada forma e para evitar transformações indesejadas. Por exemplo, os cotovelos e os joelhos devem rodar apenas num eixo — neste caso, o X —, por isso os outros eixos foram bloqueados. Outros exemplos de controlos com atributos bloqueados são os cotovelos e joelhos IK, os dedos, a rolagem do pé e a ponta dos dedos.

Recomenda-se manter estes controlos bloqueados, mas, se quiser mais liberdade de movimento, basta clicar no ícone de cadeado para os desbloquear.

Os bloqueios só se aplicam às ferramentas interativas do Blender. Um script Python que define diretamente a rotação de um osso ignora-os; por isso, se posar o rig com um script, mantenha cada rotação nos eixos livres da articulação.

![Transformações bloqueadas num controlo.](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-pt/wearables-e-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.
