> 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/modelado-y-animaciones-3d/animations.md).

# Animaciones

Aprende cómo crear animaciones que se puedan incrustar en modelos 3D importados a Decentraland.

La animación es el arte de dar vida a las cosas. Y no hay mejor manera de hacer que tu escena tenga más vida que añadir animaciones a tus modelos 3D.

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

Hay varias formas de hacerlo: mediante **la animación de objetos**, mediante un **rig (animación esquelética)**, o usando **shape keys (animación de morph targets)**.

**La animación de objetos** es ideal para modelos sencillos, como una pelota que rebota, un globo que gira o una silla que flota, y no necesita un armature. Es importante mencionar que la animación de objetos es diferente de la **animación de vértices**. En la animación de objetos, el modelo se anima como un todo, mientras que en la animación de vértices cada vértice del objeto se puede animar por separado.

**Las shape keys (también conocidas como morph targets o blend shapes)** son una forma de animación de vértices que está **admitida por el motor de Decentraland**. Son especialmente útiles para las expresiones faciales, la sincronización labial o cualquier deformación difícil de conseguir solo con huesos. Las animaciones de shape keys integradas en un archivo glTF/GLB se reproducirán en el mundo igual que las animaciones esqueléticas o de objetos.

Si tienes un modelo más complejo, como una persona, una criatura o una máquina, necesitarás un **rig**. Un rig no es más que un esqueleto digital que mueve y deforma el mesh. El proceso de vincular el mesh al esqueleto se llama Skinning; en él defines qué hueso afecta a cada grupo de vértices y con qué intensidad, para que el modelo se deforme de la mejor manera posible.

Sin embargo, sea cual sea el método, todas las animaciones de un modelo 3D deben estar integradas en su archivo *glTF* porque no se pueden referenciar animaciones en archivos separados.

## Crear una animación

Así se crean animaciones con Blender.

### Animación de objetos

* Asegúrate de tener abierta la pestaña ***Dope Sheet*** > ***Action Editor*** y haz clic en ***New*** para añadir un clip de animación.
* Cámbiale el nombre como prefieras y asegúrate de activar ***Fake User*** (el icono del escudo) para que se guarde la animación.
* Establece un keyframe en el primer fotograma seleccionando el objeto y pulsando ***I***. Después, mueve, rota o escala el objeto y, en otro fotograma de la línea de tiempo, vuelve a pulsar ***I*** para establecer otro keyframe con las transformaciones actuales.
* El fotograma final de la animación debe ser igual que el primero, así que solo tienes que copiar el primer fotograma y pegarlo al final.

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

*Crear un clip de animación y añadir keyframes.*

### Animación de rigs

Para una animación de rig, necesitarás un armature. Si quieres hacerlo tú mismo, consulta [Crear un rig](https://www.notion.so/686e6f59a1604585b059f990a36b2d55) para obtener instrucciones sobre cómo configurar un armature coherente.

Cuando hayas terminado el rigging y el Skinning produzca buenas deformaciones, ¡ya puedes empezar a animar! El proceso es muy parecido al de la animación de objetos, pero en vez de hacerlo en ***Object Mode***, lo harás en ***Pose Mode***.

* Ve a ***Pose Mode*** y asegúrate de tener el ***Hoja Dope*** > ***Editor de acciones*** con la pestaña abierta y haz clic en ***Nuevo*** para añadir un clip de animación.
* Cámbiale el nombre como prefieras y asegúrate de activar ***Fake User*** (el icono del escudo) para que se guarde la animación.
* Con el ratón sobre el ***Viewport***, pulsa ***A*** para seleccionar todo y luego ***I*** para establecer un fotograma clave para todo el esqueleto.
* Ve a un fotograma diferente en la línea de tiempo y manipula el hueso como quieras para obtener la pose que buscas. Puedes cambiar la ubicación, la rotación y la escala de un hueso, según cómo hayas configurado el rig.
* Cuando tengas un buen resultado, establece otro fotograma clave para todo el esqueleto. Sigue haciéndolo hasta terminar la animación. Recuerda que el primer y el último fotograma deben ser iguales si la animación va a repetirse en bucle.

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

Si eres nuevo en el proceso de animación, consulta este tutorial con algunos buenos consejos para principiantes:

[![Video Preview](https://img.youtube.com/vi/-iWslh4uQIk/maxresdefault.jpg)](https://youtu.be/-iWslh4uQIk)

## Animaciones con Skinning frente a animaciones Transform

**Las animaciones Transform suelen ofrecer un mejor rendimiento que las animaciones de mallas con skinning, ya que requieren menos recursos computacionales para mostrarlas.**

La animación de mallas con skinning consiste en usar una malla con un esqueleto de huesos ponderados respecto a los vértices de la malla. Se anima el esqueleto, que a su vez anima la malla. Este proceso puede exigir muchos recursos computacionales, especialmente cuando hay una gran cantidad de vértices que animar.

Por otro lado, las animaciones Transform consisten en animar directamente las propiedades Transform de un objeto, como su posición, rotación y escala. Esto requiere menos recursos computacionales que la animación de mallas con skinning, ya que normalmente hay menos propiedades Transform que animar que vértices en una malla.

Además, las animaciones Transform a menudo se pueden precalcular y almacenar en un formato más compacto, como los datos de fotogramas clave, a los que se puede acceder y que se pueden reproducir rápidamente sin necesidad de realizar cálculos intensivos en tiempo real.

En general, aunque las animaciones de mallas con skinning pueden producir animaciones más detalladas y realistas, las animaciones Transform suelen ser preferibles en aplicaciones donde el rendimiento es esencial, como los videojuegos.

## Crear y exportar varios clips de animación

Puedes tener tantos clips de animación como quieras para tu modelo. Puedes consultar cómo crear, explorar y eliminar animaciones en [esta sección](https://www.notion.so/5e962e5d54a24bcb9b906748007eb4cc).

En el siguiente video aprenderás a exportar varias animaciones desde Blender en un solo archivo GLB.

[![Video Preview](https://img.youtube.com/vi/YxAB4bujO_w/maxresdefault.jpg)](https://www.youtube.com/watch?v=YxAB4bujO_w\&ab_channel=Decentraland)

## Exportar varias animaciones como una sola

A diferencia de la animación esquelética, en la que puedes crear rigs para varios objetos y combinar sus animaciones en un solo clip, en la animación de objetos no puedes hacerlo. Las animaciones se exportarán por separado y solo se reproducirá un objeto a la vez. Una solución es combinar varias animaciones en una sola, de modo que tengas un clip de animación en el que todos los objetos se muevan al mismo tiempo.

Para hacerlo, envía a la ***pista de animación no lineal*** la animación de cada objeto, como se muestra a continuación.

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

*Envía la animación de cada objeto a la pista NLA.*

Una vez que todas las animaciones aparezcan en el NLA Editor, selecciona todos los objetos y ve a **File > Export > glTF2.0**. Despliega Include y marca Selected Objects. Despliega Animation, vuelve a desplegar Animation y desmarca **Group by NLA Track**. Puedes cambiar el nombre del clip de animación en Merged Animation Name y luego pulsar **Export glTF 2.0**.

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

*Configuración para exportar varias animaciones como una sola.*

Ten en cuenta que esto solo funcionará si cada objeto tiene una sola animación. Si los objetos tienen varios clips de animación, es mejor exportarlos por separado.

{% hint style="info" %}
**💡 Consejo**: En lugar de crear tus propias animaciones, también puedes descargar animaciones genéricas y aplicarlas a tu modelo. Por ejemplo, si tienes personajes 3D con características humanas, puedes descargar animaciones gratuitas o de pago desde [Mixamo](https://www.mixamo.com/#/).
{% endhint %}

## Muestreo

A veces, el archivo de animación puede acabar siendo demasiado pesado debido a la cantidad de animaciones o a la combinación de animación y modelo.

El muestreo es una buena forma de optimizar la animación. La frecuencia de muestreo determina cada cuánto se hornea un keyframe en la animación. Por ejemplo, si la frecuencia de muestreo se establece en 2, se creará un keyframe cada dos fotogramas. Una frecuencia de muestreo de 3 horneará un keyframe cada tres fotogramas, y así sucesivamente. Cuanto mayor sea la frecuencia de muestreo, más ligero será el archivo.

Sin embargo, el inconveniente es que la animación empezará a perder fluidez, ya que se pierden algunos fotogramas clave importantes (se distribuyen de manera desigual a lo largo de la animación). También es importante tener en cuenta que **el muestreo NO consiste en dividir el número de fotogramas de la animación por la frecuencia de muestreo**.

Por lo general, una **frecuencia de muestreo de 2 o 3** será suficiente. Esos valores pueden optimizar la animación sin comprometer la calidad.

Puedes encontrar la opción ***Sampling Rate*** en la configuración de exportación, dentro de ***Animation***.

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

{% hint style="info" %}
**💡 Consejo**: Si el número de fotogramas de la animación se puede dividir entre la frecuencia de muestreo, ¡mejor! Esto significa que se horneará el fotograma final, preservando la transición del final al inicio de la animación.
{% endhint %}

## Implementar animaciones

Este documento explica cómo añadir animaciones a un modelo 3D. Consulta [**gestionar animaciones**](https://docs.decentraland.org/creator/development-guide/3d-model-animations/) para obtener instrucciones sobre cómo activar y gestionar animaciones en una escena.

## Buenas prácticas para las animaciones

* Mantén la armature lo más simple posible: crea solo los bones de las partes del modelo que quieras animar. Los bones pueden afectar al rendimiento, así que asegúrate de añadir únicamente los que sean necesarios.
* Si la animación va a repetirse en bucle en tu escena, asegúrate de que la pose final sea idéntica a la inicial para lograr una mejor transición.
* Nunca dejes a un personaje sin animación, aunque en realidad no esté haciendo nada. Crea una animación «idle» para cuando el personaje esté quieto. La animación idle puede incluir movimientos sutiles, como respirar y quizá mirar a su alrededor de vez en cuando.
* No dejes bones sin posar, como los de las manos, los dedos, la cabeza o el cuello. Los detalles son muy importantes para lograr una buena animación, y los movimientos rígidos solo harán que resulte menos creíble.
* Evita usar demasiados keyframes, salvo que sea absolutamente necesario. Cuantos más keyframes añadas, mayores serán las posibilidades de obtener una interpolación deficiente y una animación más pesada.
* Selecciona todos tus bones (incluidos los que se deforman) y establece un keyframe en el primer y el último fotograma de la animación. Así evitarás que haya bones sin información, lo que podría hacer que una animación afectara involuntariamente a otra.
* Asegúrate de que el archivo solo tenga una armature al exportarlo. Al importar animaciones, también se importará una armature. Todas las animaciones deben realizarse con la misma armature base, así que elimina todo lo que no necesites.
* Cambia siempre el nombre de tus bones y animaciones. ¡Mantén todo organizado!
* Al exportar el modelo *glTF* confirma que estés exportando todos los objetos y las animaciones. Algunos exportadores solo exportan lo que está ***seleccionado en ese momento*** de forma predeterminada.
* Después de exportar el modelo, revísalo en [Babylon Sandbox](https://sandbox.babylonjs.com/) y comprueba que todas las animaciones funcionen y tengan los nombres esperados.


---

# 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/modelado-y-animaciones-3d/animations.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.
