> 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/particles-in-emotes.md).

# Partículas em Emotes

Como exportar partículas nos seus Emotes usando Armature

Emotes 2.0 podem ter sons e props, mas sabia que também é possível usar partículas? Podem ser muito divertidas e dar um toque visual extra! Além disso, podem acelerar o processo de animação.

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

Como a animação de objetos e os sistemas de partículas não são compatíveis com Emotes 2.0, precisamos converter essas partículas em uma armature (que é compatível) para adicioná-las aos Emotes. Para isso, vamos usar um add-on do Blender desenvolvido pela equipe de conteúdo da Foundation, que pode ser baixado no link abaixo.

Use o [Particles to Bones Addon for Blender](https://github.com/decentraland/docs/blob/main/creator/images/emotes/particle_system_to_bone_animation.py) para começar!

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

O processo de adicionar partículas ao seu Emote envolve duas etapas. Siga as orientações junto com estes vídeos:

* **Converter partículas em uma armature**

[![Video Preview](https://i.vimeocdn.com/video/1803452887-82f74713a8f16df8c3618654f539cfddf78cb1f9dfac951d99d340004ac26ad6-d_590x332)](https://vz-8a0704eb-552.b-cdn.net/bb51a195-4a80-48d3-badd-0bfe6cc9e3b3/playlist.m3u8)

* **Mesclar a armature das partículas à armature do prop**

[![Video Preview](https://i.vimeocdn.com/video/1803464351-0e8bf5158cb87707397a547948f99278b1af45d7669622887a43c3bd9340c064-d_590x332)](https://vz-8a0704eb-552.b-cdn.net/9f512c34-ae83-42fe-a858-165ccea6d0c5/playlist.m3u8)

{% hint style="info" %}
**Atenção!**

⚠️ A criação de um sistema de partículas não será abordada nesta documentação. O objetivo é ajudar você a implementá-lo no seu Emote.
{% endhint %}

## Converter partículas em uma armature

Como mencionado anteriormente, Emotes 2.0 não são compatíveis com animação de objetos nem com qualquer tipo de sistema de partículas. Por isso, precisamos converter as partículas em uma armature.

Para começar, você precisará de um sistema de partículas funcional e do add-on. O sistema de partículas mostrado abaixo é bem simples e serve apenas como exemplo para demonstrar como o add-on funciona. Para obter um resultado melhor, verifique se o sistema de partículas corresponde às animações do seu Emote.

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

*Sistema de partículas simples.*

Em seguida, baixe e instale o add-on. Para isso, acesse Edit > Preferences > Add-ons e clique em Install para localizar o arquivo no seu computador.

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

*Clique em Edit > Preferences.*

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

*Selecione Add-ons à direita e clique em Install.*

Depois, clique na caixa de seleção para ativá-lo. Uma aba chamada Converter aparecerá à direita do Viewport.

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

*Clique na caixa de seleção para ativar o add-on.*

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

*Você encontrará a aba Converter à direita do Viewport.*

Em seguida, selecione o objeto, acesse a aba Converter, renomeie Output Collection como preferir, defina Start e End Frames e clique em Particle System to Armature Converter, como mostrado abaixo.

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

Você verá que foi criada uma Collection no Outliner, contendo a armature das partículas. Também foi criado um clip de animação, com todos os movimentos de cada objeto registrados.

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

*Armature gerada pelo add-on.*

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

*Clip de animação gerado pelo add-on.*

E pronto: as partículas foram convertidas em uma armature! Lembre-se de salvar o arquivo com outro nome (mantenha o original como backup), pois precisaremos dele na próxima etapa.

{% hint style="info" %}
**Atenção!**

⚠️ As partículas devem ser o último elemento adicionado ao seu Emote. Quando o Emote estiver pronto, você saberá a duração exata da animação, o que facilitará a sincronização das partículas com a ação realizada.
{% endhint %}

## Mesclar a armature das partículas à armature do prop

Emotes 2.0 podem ter apenas duas armatures e dois clips de animação por arquivo. Se importarmos as partículas sem fazer mais nada, ficaremos com três armatures e três clips de animação. Para resolver isso, precisamos mesclar a armature das partículas à armature do prop. O motivo para mesclá-la ao prop, e não à armature do avatar, é simples: o rig do avatar não pode ser editado de nenhuma forma, seja adicionando ou removendo bones. Assim, a armature do prop é a única opção.

## Mesclar a armature das partículas à armature do prop

Emotes 2.0 podem ter apenas duas armatures e dois clips de animação por arquivo. Se importarmos as partículas sem fazer mais nada, ficaremos com três armatures e três clips de animação. Para resolver isso, precisamos mesclar a armature das partículas à armature do prop. O motivo para mesclá-la ao prop, e não à armature do avatar, é simples: o rig do avatar não pode ser editado de nenhuma forma, seja adicionando ou removendo bones. Assim, a armature do prop é a única opção.

Primeiro, precisamos importar ou anexar a Collection gerada pelo add-on. Você pode exportá-la como um arquivo glb e importá-la para o arquivo do seu Emote. Ou pode simplesmente anexar a Collection, o que é bem mais fácil e rápido. Para isso, acesse ***File*** > ***Append***, localize o arquivo das partículas no seu computador, selecione a pasta ***Collection*** e escolha a Collection desejada.

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

*Para anexar uma Collection, acesse File > Append.*

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

*Depois de localizar o arquivo das partículas, selecione a pasta Collection.*

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

*Escolha a Collection gerada pelo add-on (que você pode ter renomeado). Neste exemplo, ela foi renomeada para Particles\_Out.*

Em seguida, vamos mesclar as armatures. No Object Mode, selecione primeiro a armature das partículas, depois mantenha Shift pressionado para selecionar a armature do prop e pressione Ctrl+J para juntá-las/mesclá-las, como mostrado abaixo.

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

Depois disso, as partículas podem parecer desconfiguradas, mas não se preocupe: isso faz parte do processo. Para corrigir, selecione um objeto de partícula por vez no Outliner, acesse Object Properties (ícone de quadrado laranja) e, em Relations, verifique se o parent é Armature\_Prop. Faça isso para todos os objetos de partículas. Isso significa que todos os objetos são filhos de Armature\_Prop.

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

*Verifique se Armature\_Pop é o parent de cada objeto de partícula.*

Depois de fazer isso para todos os objetos de partículas, selecione o primeiro objeto de partícula no Outliner, acesse Modifiers (ícone de chave inglesa azul) e veja que o campo Object está vazio. Como estamos na aba Modifiers, é aqui que você escolhe qual armature controlará o objeto. Basta clicar em Object, selecionar Armature\_Prop e repetir o procedimento para todos os objetos de partículas. Conforme fizer isso, você verá os objetos de partículas voltarem ao tamanho original, corrigindo a desconfiguração causada pela mesclagem das armatures.

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

*Selecione a armature adequada para controlar os objetos.*

Agora que a armature foi mesclada e configurada corretamente, falta apenas uma etapa para tudo funcionar. Se tentar reproduzir a animação, você verá que as partículas não se movem. Isso acontece porque agora elas fazem parte de Armature\_Prop, e a animação reproduzida por ela é a do prop. Lembra que as partículas tinham seu próprio clip de animação? Agora precisamos copiar os keyframes do clip de animação das partículas e colá-los no clip de animação do prop.

Para fazer isso, acesse ***Pose Mode*** e, no Outliner, expanda ***Armature\_Prop*** e depois ***Pose***. Selecione todos os bones que pertencem às partículas.

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

*Selecionando todos os bones das partículas.*

Com os ossos selecionados, no Editor de ações, selecione o clipe de animação original de partículas que contém todos os keyframes. Selecione todos os keyframes premindo A, clique com o botão direito do rato e copie-os. Em seguida, selecione a animação do objeto, defina um keyframe no primeiro frame e cole os keyframes do clipe de animação de partículas.

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

*Copiar frames da animação de partículas para a animação do objeto.*

E já está! Guarde o ficheiro, certifique-se de que elimina o clipe de animação de partículas original e exporte como faria normalmente.

Se precisar de mais informações sobre como o fazer, consulte a secção ***Exportar*** na documentação [Adicionar objetos e sons às suas Emotes](https://docs.decentraland.org/creator/emotes/props-and-sounds/) .


---

# 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/particles-in-emotes.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.
