> 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-es/wearables-y-emotes/emotes/rig-features.md).

# Características del rig

Características sobre el rig de Avatar y el archivo descargable.

Esta documentación explica la configuración de Rig 1.0, sus controles y sus funciones.

{% hint style="info" %}
**💡 Consejo**: Instala el [plugin Decentraland Tools para Blender](https://extensions.blender.org/add-ons/decentraland-tools/). Incluye varias Functions útiles para editar y exportar modelos 3D, Wearables y Emotes.
{% endhint %}

### Transformaciones de la Armature

Estas son las transformaciones de la Armature en modo Objeto con la configuración de los controles. **No las edites de ninguna manera**. El Rig solo debe manipularse en modo Pose. Para evitar modificaciones accidentales, las transformaciones se han bloqueado en modo Objeto.

*Transformaciones de Rig 1.0.*

{% hint style="warning" %}
⚠️ **Advertencia**: **Nunca edites el Rig en modo Objeto.**
{% endhint %}

## Orientación de los Bones

Esta es la orientación de los Bones de Rig 1.0.

*Ejes de orientación de los Bones.*

*Comportamiento al reflejar poses.*

### Reflejar una pose

Los Bones izquierdos y derechos del Rig no están dispuestos de la misma manera, por lo que un único método de reflejo no funciona para todo el cuerpo. Empieza con **Pose > Copiar pose**, luego usa **Pegar con X invertida** y termina el Upper body a mano.

**Las piernas y los pies quedan listos después de pegar.** **Pegar con X invertida** da el resultado correcto en `CTRL_FK_Avatar_UpLeg`, `CTRL_FK_Avatar_Leg`, `CTRL_FK_Avatar_Foot`, `CTRL_FK_Avatar_ToeBase`, `CTRL_IK_Foot`, `CTRL_IK_Avatar_ToeBase` y `CTRL_Avatar_Knee`. El resultado es exacto para las piernas IK y queda a unos 3 cm de la posición deseada del pie para las piernas FK, porque los Bones izquierdo y derecho tienen rotaciones ligeramente diferentes en reposo. Ajusta el pie FK a ojo si necesitas que sea exacto.

**Los hombros, brazos, manos y dedos necesitan un paso más.** **Pegar con X invertida** por sí solo coloca la otra mano a entre 40 y 70 cm de la posición deseada. Después de pegar, revisa cada uno de estos controles e **invierte el signo de los valores de X y Z, manteniendo el de Y**:

* `CTRL_Avatar_Shoulder`
* `CTRL_FK_Avatar_Arm`, `CTRL_FK_Avatar_ForeArm`, `CTRL_FK_Avatar_Hand`
* `CTRL_IK_Avatar_Hand`, `CTRL_IK_Avatar_Elbow`
* Los 30 controles `CTRL_Avatar_Hand*` de los dedos

Aplica el cambio a la rotación, tanto si trabajas con Quaternions como con ángulos de Euler. Los signos son los mismos en ambos casos. En los controles IK de la mano y el codo, aplícalo también a la posición.

Por ejemplo, si un brazo pegado tiene los valores X -0.5 y Z 0.1, estos pasan a ser X 0.5 y Z -0.1.

Esto reproduce exactamente toda la cadena del brazo.

**Por qué la parte superior del cuerpo es diferente:** los marcos óseos de la pierna derecha son un reflejo exacto de los de la izquierda, que es lo que **Paste X-Flipped** da por sentado. Los marcos del brazo derecho reflejan los del izquierdo con el eje local **Z** invertido en lugar del X, así que el pegado invertido queda rotado en la dirección incorrecta. Negar X y Z lo corrige exactamente.

#### Establecer los valores directamente

Si estableces los valores del lado derecho a partir de los valores originales del izquierdo en vez de pegarlos, usa estos cambios de signo:

| Controles                 | Rotación `(w, x, y, z)` | Ubicación    |
| ------------------------- | ----------------------- | ------------ |
| Parte superior del cuerpo | `(w, -x, -y, z)`        | `(x, y, -z)` |
| Piernas                   | `(w, x, -y, -z)`        | `(-x, y, z)` |

Esta es la ruta aproximada: una diferencia de alrededor de 1 mm en los brazos, pero de 5 a 10 cm en las piernas FK. **Paste X-Flipped** también corrige las pequeñas diferencias de giro entre los huesos en reposo izquierdo y derecho, cosa que un cambio de signo directo no hace. Es preferible el método de pegar y corregir descrito anteriormente.

{% hint style="warning" %}
**📔 Nota**: La pose inicial no es perfectamente simétrica desde el principio, así que reflejar la pose de un lado al otro sobrescribe esa pequeña asimetría. Comprueba visualmente el resultado antes de crear fotogramas clave.
{% endhint %}

### Rotar los brazos

El control del brazo superior, `CTRL_FK_Avatar_Arm`, tiene el eje X local inclinado. Al rotarlo sobre ese eje, el brazo cruza el pecho, que es la razón más común por la que los brazos terminan cruzados cuando en realidad querías levantarlos.

* Para **orientar** el brazo, rótalo alrededor de los ejes del mundo: el eje X del mundo lo levanta hacia delante y el eje Z del mundo lo mueve hacia dentro y hacia fuera.
* Para **girar** el brazo sobre su eje, de modo que la palma quede hacia arriba o hacia abajo y el codo apunte hacia dentro o hacia fuera, rótalo alrededor del eje Y local del hueso.

### El eje sobre el que se flexiona cada articulación

Los codos y las rodillas se flexionan sobre su eje X local. Las muñecas y los dedos no: se curvan sobre su eje Z local. Rotar un dedo alrededor de su eje X local lo mueve hacia los lados, que es la razón más común por la que los dedos se doblan en la dirección incorrecta en un emote terminado.

| Control                                                     | Flexionar sobre                                 | Otros ejes                                                                    |
| ----------------------------------------------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------- |
| Codo `CTRL_FK_Avatar_ForeArm`, rodilla `CTRL_FK_Avatar_Leg` | X local                                         | Y y Z están bloqueados                                                        |
| Muñeca `CTRL_FK_Avatar_Hand`                                | La Z local flexiona la mano hacia la palma      | La X local la inclina hacia los lados                                         |
| Dedos `CTRL_Avatar_Hand{Index,Middle,Ring,Pinky}{1,2,3}`    | El Z local curva el dedo hacia la palma         | El X local lo mueve lateralmente en el plano de la palma. El Y está bloqueado |
| Base del pulgar `CTRL_Avatar_HandThumb1`                    | El X local mueve el pulgar a través de la palma | El Y está bloqueado                                                           |
| Pulgar `CTRL_Avatar_HandThumb2`, `CTRL_Avatar_HandThumb3`   | El Z local curva el pulgar                      | El Y está bloqueado                                                           |

Los dedos se curvan en la misma dirección en ambas manos. La flexión del codo, la inclinación de la muñeca y el movimiento del pulgar a través de la palma van en direcciones opuestas en el lado izquierdo y el derecho, así que hay que invertir el signo del valor que funciona en un lado para usarlo en el otro.

### Bone Collections

Para evitar accidentes y facilitar la identificación de los controles, este rig está organizado en colecciones de huesos a las que se puede acceder desde la *Data Properties* de Blender. La visibilidad de estas colecciones se puede activar y desactivar haciendo clic en el *Eye Icon.* De forma predeterminada, todas están visibles, excepto las que se llaman DON'T TOUCH.

Pestaña Armature Data Properties.

Así se distribuyeron los huesos en las colecciones:

* Global/Switch: controles globales, como los del root y la columna, además de los hombros. Los controles con atributos personalizados también están en esta colección.
* FK Upper: todos los controles de configuración FK de la parte superior del cuerpo.
* FK Lower: todos los controles de configuración FK de la parte inferior del cuerpo.
* IK Upper: todos los controles de configuración IK de la parte superior del cuerpo.
* IK Lower: todos los controles de configuración IK de la parte inferior del cuerpo.
* Fingers: controles de los dedos de ambas manos.
* Deformation Bones: aquí se almacenan los huesos de deformación.

{% hint style="warning" %}
**⚠️ ¡Atención!**

Las colecciones DON'T TOUCH contienen las configuraciones de IK y otras restricciones del rig, y deben permanecer ocultas. Editar estos huesos podría impedir que el rig funcione correctamente.
{% endhint %}

## Controles y agrupación

Los controles son huesos que no deforman y que impulsan el esqueleto base. Tienen distintos colores según su categoría:

* Amarillo: controles globales y controles con atributos personalizados
* Verde: cadera (más fácil de identificar en la jerarquía de la columna)
* Azul: controles con comportamiento FK
* Rojo: controles IK
* Rosa: controles del lado izquierdo
* Naranja: controles del lado derecho

*Todos los controles y sus colores.*

## Atributos personalizados y configuración

### Mezcla FK/IK

Aunque normalmente los brazos se configuran como FK y las piernas como IK, hay situaciones en las que se necesita una configuración distinta. Si la mano debe mantener una posición concreta, como al hacer flexiones o escalar, IK es la mejor opción. En el caso de las piernas, FK funciona mejor cuando están en el aire, al nadar o al rodar. Para ofrecer más flexibilidad y libertad en la animación, este rig incluye una mezcla FK/IK en el control UpperBody: 0 corresponde a FK total y 1 a IK total. Cualquier valor intermedio mezcla ambos.

![Mezcla FK/IK para ambos brazos y piernas.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/ik_fk_rig_1.0.png)

*Mezcla FK/IK para ambos brazos y piernas.*

![Cómo funciona el cambio de FK a IK.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/IK_FK_rig_1.0.gif)

*Cómo funciona el cambio de FK a IK.*

Una regla sencilla sirve para la mayoría de los casos: si una extremidad mantiene contacto con algo, déjala en IK; si pierde el contacto y se mueve libremente, cámbiala a FK. Para una pose sentada:

* **Ambos pies en el suelo** : deja las piernas en IK. Mueve los pies con `CTRL_IK_Foot`, luego baja `CTRL_Avatar_UpperBody` para bajar el cuerpo. Los pies permanecerán apoyados. Orienta las rodillas con `CTRL_Avatar_Knee`.
* **Una pierna cruzada sobre la otra**: cambia solo la pierna levantada a FK.
* **Pies colgando**: cambia ambas piernas a FK.

Usa `CTRL_Avatar_UpperBody` para mover todo el cuerpo hacia arriba y hacia abajo. Es el centro de gravedad. `CTRL_Avatar_Hips` mueve solo la pelvis y las piernas, lo que estira el torso, así que no es el control adecuado para sentarse.

{% hint style="warning" %}
**📔 Nota**: evita cambiar una extremidad entre FK e IK en mitad de un clip. A menos que ambas cadenas estén perfectamente alineadas en ese fotograma, la extremidad dará un salto. Si necesitas hacer el cambio, establece fotogramas clave en la propiedad FK > IK para que el cambio ocurra donde quieras.
{% endhint %}

#### Tocar la cara o un objetivo con IK

Para hacer que una mano toque algo, como la cara, un accesorio o la otra mano, cambia ese brazo a IK. Las articulaciones FK rotatorias no permiten colocar la punta de un dedo sobre un objetivo de forma fiable. Ten en cuenta que el control IK de la mano está en la muñeca; por tanto, si colocas el control sobre el objetivo, será la muñeca la que llegue allí, no la punta del dedo. Mueve el control hasta que la punta del dedo llegue al lugar que quieres.

La propiedad FK > IK se mezcla gradualmente entre sus fotogramas clave. En los fotogramas clave donde haces el cambio, coloca el brazo FK en una pose cercana a la pose IK. De lo contrario, si el brazo FK queda colgando a un lado, pasará por el pecho mientras se realiza la mezcla.

Usa estas medidas de la cabeza del avatar predeterminado, tomadas mientras el avatar está de pie en su pose de reposo, para colocar una mano sobre la cara:

| Punto de referencia         | Altura sobre el suelo                  | Posición relativa al `Avatar_Head` hueso                                  |
| --------------------------- | -------------------------------------- | ------------------------------------------------------------------------- |
| `Avatar_Head` hueso         | 1,72 m                                 | Este es el centro de la cara, no la base del cráneo                       |
| Punta de la nariz           | 1,66 m (1,64 m en el cuerpo masculino) | 0,19 m hacia delante y 0,06 m hacia abajo (0,08 m en el cuerpo masculino) |
| Barbilla                    | 1,60 m                                 | 0,12 m hacia abajo                                                        |
| Parte superior de la cabeza | 1,90 m                                 | 0,18 m hacia arriba                                                       |

La cabeza mide aproximadamente 0,30 m de ancho. Una mano dirigida a 0,12 m por encima del hueso de la cabeza llega a la frente. Si la cabeza está rotada, aplica estos desplazamientos en el marco rotado de la cabeza.

### Mezcla de rotación aislada FK

Otro atributo personalizado del control UpperBody es la rotación aislada, que permite elegir si el hueso hereda o no la rotación de su padre (mientras está en FK). Con el valor 0, el hueso no heredará la rotación; con el valor 1, seguirá por completo el comportamiento del padre. Cualquier valor intermedio mezclará ambos comportamientos. Es una herramienta interesante porque hace que el hueso FK mantenga su posición y se comporte un poco como IK.

![Atributo de rotación aislada para los brazos.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/IsoRot_rig_1.0.png)

*Atributo de rotación aislada para los brazos.*

![Cómo funciona el atributo IsoRot para los brazos.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/IsoRot_Arms_rig_1.0.gif)

*Cómo funciona el atributo IsoRot para los brazos.*

El control Head también tiene este atributo. Es muy útil, por ejemplo, para los ciclos de caminata, ya que la cabeza mantiene su rotación aunque el torso gire, lo que garantiza que siempre mire hacia delante. Sin esta opción, el animador tendría que rotar manualmente la cabeza cada vez que gira el torso para mantenerla recta y mirando hacia delante.

![Atributo de rotación aislada para la cabeza.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/IsoRot_Head_rig_1.0.png)

*Atributo de rotación aislada para la cabeza.*

![Cómo funciona el atributo IsoRot para la cabeza.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/IsoRot_Head_rig_1.0.gif)

*Cómo funciona el atributo IsoRot para la cabeza.*

{% hint style="warning" %}
⚠️ **Advertencia**: en versiones anteriores de Blender, aunque se hayan seleccionado todos los controles y se les hayan asignado fotogramas clave, estos atributos personalizados no recibirán fotogramas clave automáticamente. Asegúrate de insertar manualmente un fotograma clave en cada atributo para no perder la pose o el movimiento que creaste. En Blender 4.4, al pulsar I, se establece un fotograma clave en todos los atributos y propiedades personalizadas.
{% endhint %}

![En versiones anteriores de Blender, asegúrate de establecer fotogramas clave en todos los controles y atributos personalizados.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/custom_attributes.gif)

*En versiones anteriores de Blender, asegúrate de establecer fotogramas clave en todos los controles y atributos personalizados.*

*En Blender 4.4, pulsa I para establecer automáticamente un fotograma clave en Location, Rotation, Scale y Custom Properties..*

Otra solución para establecer fotogramas clave en las propiedades personalizadas es seleccionar ***Keying*** en la pestaña Timeline y en ***Conjunto de claves activo*** selecciona Location, Rotation, Scale y Custom Properties, como se muestra en el GIF de abajo. De este modo, cada vez que pulses I, se creará un keyframe sin que aparezca el menú emergente. Como algunos animadores prefieren usar el menú, esta opción está desactivada de forma predeterminada. Pero puedes elegir el método que más te convenga.

![Insertar keyframes con la opción Keying.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/keyframe_custom_properties.gif)

*Insertar keyframes con la opción Keying.*

### Configuración inversa del pie con IK

Animar un pie con FK es bastante sencillo: basta con agarrar cualquiera de los controles y rotarlo. Como hay un control para el pie y otro para los dedos, el animador tiene control total sobre los movimientos. Sin embargo, con IK no es tan simple. El pie tiene que mantenerse apoyado en el suelo y, al mismo tiempo, poder rotar sobre la punta y el talón, así como hacia los lados.

Este rig se configuró para dar al animador libertad de movimiento del pie sin perder las ventajas del sistema IK. Consta de cuatro controles:

* Rotación del pie: este control rota el pie hacia delante y hacia atrás, y de lado a lado. Para evitar que se doble demasiado sobre el talón o la punta y que el rig del pie se deforme, se estableció un límite. Al alcanzarlo, el pie deja de rotar.

![Rotación del pie: al rotarlo en X, se mueve hacia delante y hacia atrás; al rotarlo en Z, se mueve de lado a lado.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/foot_roll.gif)

*Rotación del pie: al rotarlo en X, se mueve hacia delante y hacia atrás; al rotarlo en Z, se mueve de lado a lado.*

* Rotación de la punta de los dedos: rota el pie desde la punta de los dedos. Solo rota hacia delante.

![La rotación de la punta de los dedos solo se produce en el sentido positivo de X.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/toe_tip.gif)

*La rotación de la punta de los dedos solo se produce en el sentido positivo de X.*

* Control de los dedos: rota los dedos desde la punta del pie.

![Los dedos se pueden rotar en cualquier dirección.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/toes.gif)

*Los dedos se pueden rotar en cualquier dirección.*

* Control del pie: es un control global que mueve todo el pie. Como es el padre de los demás controles del pie, conserva todas las transformaciones y también se puede agarrar y rotar.

![Funcionamiento del control del pie.](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/foot.gif)

*Funcionamiento del control del pie.*

### Transformaciones bloqueadas

Algunos controles pueden tener un símbolo de candado junto a los parámetros de transformación, lo que significa que esos valores no se pueden cambiar. Esto se aplica a los controles que deben comportarse de una manera específica y evita transformaciones no deseadas. Por ejemplo, los codos y las rodillas solo deben rotar en un eje, que en este caso es X, por lo que los demás ejes están bloqueados. Otros controles con atributos bloqueados son los codos y las rodillas con IK, los dedos, la rotación del pie y la rotación de la punta de los dedos.

Se recomienda mantenerlos bloqueados, pero si quieres más libertad de movimiento, solo tienes que hacer clic en el icono del candado para desbloquearlos.

Los bloqueos solo se aplican a las herramientas interactivas de Blender. Un script de Python que modifica directamente la rotación de un hueso los ignora, así que, si posas el rig con un script, asegúrate de mantener cada rotación en los ejes libres de la articulación.

![Transformaciones bloqueadas en un control.](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-es/wearables-y-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.
