> 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/props-and-sounds.md).

# Props e Sons

Diretrizes para adicionar props e sons aos emotes.

Para levar os seus Emotes de Decentraland ao próximo nível, pode adicionar-lhes props (geometria 3D) e/ou sons, tornando-os muito mais divertidos e envolventes! Neste guia, encontrará tudo o que precisa de saber para os exportar corretamente!

{% 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 e limitações**

Para começar a adicionar props aos seus Emotes, é importante usar o [ficheiro de modelo de Decentraland](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/BaseMale_Rig_1.0.blend) que inclui o rig do Avatar e também a referência Ground, para manter o seu trabalho dentro dos limites de espaço permitidos.

**Atualmente, as animações dos props só funcionam com animações de Armature/Bones, o que significa que as animações de \_transform**\_\*\* não são permitidas.\*\*

O Emote e os respetivos props têm de ser exportados em conjunto num único ficheiro *.glb* (Avatar\_Armature + Props\_Armature com as respetivas animações).

* No máximo, 3 MB no total.
* No máximo, 3 mil tris para os props no total.
* No máximo, 2 materiais e 2 texturas para os props.
* No máximo, 62 bones para o armature do prop.
* O Emote tem de ter uma animação para o Avatar e uma animação para o prop. *Atualmente, não são permitidas várias animações.*
* As duas animações (Avatar e prop) têm de ter o mesmo número de keyframes.
* As animações não podem exceder 300 frames ou 10 segundos.
* Os limites de espaço são 4 metros quadrados. Os props e as partículas devem permanecer dentro do cubo de referência fornecido no ficheiro do Avatar. Para o movimento do Avatar, consulte a secção [Referência Ground e área de animação](https://docs.decentraland.org/creator/content-creator-pt/wearables-e-emotes/emotes/creating-emotes.md#ground-reference-and-animation-area).

## **Convenções de nomenclatura:**

As convenções de nomenclatura têm de ser seguidas rigorosamente para que os Emotes funcionem! Caso contrário, não serão reproduzidos corretamente nem no Builder nem no mundo.

#### Convenções de nomenclatura dos Armatures:

**Para o Avatar:**

`Armature`

**Para os props:**

`Armature_Prop`

#### Convenções de nomenclatura das animações:

**Para o Avatar:**

`AnimationName_Avatar`

* Exemplo: `TennisServe_Avatar`, `GunShoot_Avatar`

**Para os props:**

`AnimationName_Prop`

* Exemplo: `TennisServe_Prop`, `GunShoot_Prop`

## **Como começar**

Antes de começar a sua animação, terá de criar um rig para o prop. Se não estiver familiarizado com o processo, consulte [Criar um rig](https://docs.decentraland.org/creator/content-creator-pt/modelacao-3d-e-animacoes/create-a-rig.md) para obter mais informações sobre como fazê-lo.

Certifique-se de que o objeto prop e o armature têm as origens localizadas na posição 0,0 no Blender. Além disso, aplique as transformações ao objeto prop e ao armature, garantindo que ficam com a escala 1,1,1. Isto é fundamental para evitar possíveis problemas com o comportamento do prop quando for utilizado no mundo ou durante as animações.

#### Fazer o prop seguir o rig do Avatar

Alguns props podem ter de ser ligados a determinadas partes do corpo, como uma raquete de ténis à mão. Para isso, basta adicionar uma constraint. Para fazê-lo, no ***Modo de pose***, selecione o bone do prop (o da raquete de ténis, por exemplo), prima ***CTRL + Shift + C*** no teclado e selecione ***Child of*** ou basta clicar em ***Propriedades da restrição de osso*** e, no menu suspenso, selecione o separador ***Child of***.

*Adicione uma restrição premindo `Ctrl + Shift + C` no teclado.*

Em seguida, em ***Alvo***, selecione a armature do avatar e, em ***Osso*** selecione o osso que pretende que o objeto siga. Para manter a posição original do objeto, clique em ***Definir inverso*** depois de adicionar a restrição. Se a influência for 1, o objeto seguirá totalmente o osso selecionado; se for 0, a restrição será desativada. Pode definir keyframes na influência para a ativar e desativar ao longo da animação. Para o fazer, basta premir I com o cursor sobre ***Influência***.

***Chlid of** no menu de restrições. Defina keyframes para a influência para a ativar e desativar.*

{% hint style="info" %}
**💡Dica de animação!** Se utilizar o controlo deslizante para desativar a Influência, o objeto não manterá a posição anterior, o que dificulta a fluidez da animação. Para evitar ter de corrigir a posição manualmente, em vez de utilizar o controlo deslizante, clique no X ao lado de Influência, defina um keyframe para esta opção e outro para todos os atributos de transformação. Assim, o objeto manterá a mesma posição que tinha quando a Influência estava ativada!
{% endhint %}

{% hint style="info" %}
**💡Dica de animação**

Não deixe o objeto visível desde o início! Para evitar revelar o que está prestes a acontecer e criar uma transição abrupta, comece a animação com a escala do objeto reduzida para 0.001 e só a aumente para 1 quando pretender que apareça. Lembre-se de voltar a reduzir a escala para 0 no final da ação. Isto tornará as transições muito mais fluidas e fixes!
{% endhint %}

### Slots de animação

O Blender 4.4 introduziu uma nova funcionalidade: os slots de animação. Segundo a documentação do Blender, «o objetivo dos slots é permitir que uma Action armazene dados de animação distintos para vários blocos de dados». Em suma, os slots permitem armazenar a animação de vários elementos na mesma Action. Como é que isto afeta as emotes 2.0?

Nova funcionalidade do Blender 4.4: slots de animação.

Embora seja possível ter o avatar e o objeto a partilhar o mesmo clip de ação, devido à convenção de nomenclatura e ao número de clips de animação envolvidos nas Emotes 2.0, isso não funcionará. Por isso, o processo será o seguinte:

1. Crie um clip de animação para o avatar ou mude o nome do clip fornecido (***Starting\_Pose***). Já tem um slot de animação, mas pode utilizá-lo (***Avatar\_Animation***) ou criar um novo.
2. Mude o nome do clip de animação para ***AnimationName\_Avatar***
3. Crie um clip de animação para o objeto e mude o nome para ***AnimationName\_Prop***
4. Clique no botão ***Novo*** para criar um slot de animação para ele (será atribuído um nome automaticamente: ***Armature\_Prop***)
5. Anime como faria nas versões anteriores do Blender.

Criar um clip de ação e um slot para a animação do objeto.

## **Faixas NLA**

Para que todas as animações sejam exportadas, os clips devem ser adicionados às faixas NLA. Certifique-se de que existe apenas um clip de animação para o avatar e outro para o objeto, **e de que têm exatamente o mesmo número de fotogramas.**

No modo ***Objeto***, selecione a armature do avatar e aceda ao modo ***Pose***, selecione o clip de animação correspondente no menu Browse Action, clique em ***Action*** e, em seguida, na opção ***Empurrar para baixo*** .

Em seguida, volte para ***Object Mode***, selecione a armature do prop, aceda a ***Pose mode***, selecione o respetivo clip de animação no menu Browse Action, clique em ***Action*** e, em seguida, na opção ***Push Down*** .

Ações transferidas para as faixas NLA.

{% hint style="warning" %}
⚠️ Tenha cuidado ao transferir ações para as faixas NLA. Certifique-se de que seleciona a armature pretendida com a animação correspondente. Não altere simplesmente a animação e a transfira antes de selecionar a outra armature; caso contrário, irá atribuir duas ações a uma armature e nenhuma à outra.
{% endhint %}

As faixas NLA devem ter este aspeto: uma animação para cada armature.

{% hint style="info" %}
**🔥 Dica de otimização**

**Antes deste passo, faça uma cópia de segurança do seu projeto.**

Se os seus props forem objetos diferentes, pode juntá-los numa única malha. Para isso, basta selecionar os objetos e premir o atalho ctrl + J.

Isto ajuda a reduzir as chamadas de desenho no jogo, melhorando o desempenho do emote.

Tenha em atenção que isto não funciona com partículas.

*Selecione os objetos e prima `Ctrl+J` para os juntar.*
{% endhint %}

## **Exportar**

Os Emotes 2.0 são exportados da mesma forma que os emotes comuns. Certifique-se de que apenas a armature do avatar, a armature do prop e as malhas dos props estão visíveis e oculte tudo o resto.

Deixe visíveis apenas a armature do avatar, a armature do prop e a malha do prop para exportar.

Para exportar, aceda a File > Export > glTF2.0 (.glb, .gltf)

Nas definições de exportação, expanda Include e, em Limit to, ative Visible Objects. Em seguida, expanda o separador Data, expanda Armature e ative Export Deformation Bones Only.

|   |   |
| - | - |

Clique em Export e está feito!

## **Adicionar áudio aos emotes**

### Formato e limitações dos clips de áudio

* Os formatos corretos para exportar sons para os seus emotes são `.mp3` e `.ogg`.
* O clip de áudio deve ter a mesma duração que o emote.
* Embora não haja limite para o tamanho do áudio, o emote com props e sons não pode exceder 3 MB.

{% hint style="info" %}
**📔 Nota**: Se o emote tiver som (mp3 ou ogg), tem de ser compactado num ficheiro ZIP juntamente com o .glb. Depois, basta arrastar e largar o ficheiro .zip no Builder. Pode encontrar mais detalhes aqui: [Carregar um emote com som](https://docs.decentraland.org/creator/content-creator-pt/wearables-e-emotes/gerir-colecoes/uploading-emotes.md#uploading-emotes-using-a-zip-file)
{% endhint %}

{% hint style="info" %}
**💡 Atenção!** Tenha em consideração que os clips de áudio utilizados no emote têm de ser propriedade intelectual (IP) original, com os direitos de reprodução, e devem cumprir os critérios da [Política de conteúdo](https://decentraland.org/content/).
{% endhint %}

### Editar sons

Pode adicionar sons aos seus emotes de diferentes formas:

1. **Editar os sons diretamente no Blender**

Uma forma de adicionar sons aos seus emotes é utilizar o editor de sequências de vídeo disponibilizado pelo Blender.

Para começar a adicionar sons, aceda a *Editor Type> Video Sequencer.*

Arraste e largue os sons na interface dos canais.

Prima o atalho `N` para ver mais opções de edição dos sons, como visualizar a forma de onda, converter os sons para mono ou alterar o volume.

{% hint style="info" %}
Se quiser fazer um fade in e um fade out, basta adicionar keyframes de 0 a 1 e vice-versa à propriedade de volume.
{% endhint %}

Quando terminar de editar os sons, pode exportá-los acedendo a *Render> Render Audio*. Nas opções de exportação, tem de selecionar `.mp3` ou `.ogg` como formato na secção *Container* e, em seguida, *Mixdown*. **Só será exportado o áudio dentro do intervalo de frames.**

2. **Renderizar a animação e adicionar som com um software de edição de som**

Embora editar sons diretamente no Blender possa ser conveniente, não é muito flexível, porque o software não se dedica principalmente à edição de som. As ferramentas disponíveis são muito básicas. Se quiser dar um toque mais profissional aos seus sons, recomendamos que use um software de edição de som dedicado à sua escolha.

Existem várias opções de software que pode usar, como o [Audacity](https://www.audacityteam.org/) (gratuito e de código aberto), Adobe Audition, Ableton Live ou ProTools. O uso de um software de edição de som dedicado oferece uma gama mais ampla de ferramentas, funcionalidades e efeitos sonoros, permitindo-lhe melhorar os seus sons e dar-lhes um toque mais profissional.

Para renderizar o seu emote, basta adicionar uma câmara à cena no Blender e posicioná-la de forma a ver todos os elementos com a maior clareza possível, para depois ter uma boa referência para adicionar sons.

Ao renderizar um emote, é importante incluir apenas o intervalo de frames do emote, sem frames adicionais. Escolha uma proporção adequada às suas necessidades e selecione a pasta de destino onde pretende guardar o vídeo ou a sequência de imagens.

{% hint style="info" %}
**Dica!**

*Antes de renderizar, certifique-se de que faz uma renderização com uma taxa de amostragem baixa para poupar tempo!*
{% endhint %}

Quando concluir esta etapa, use o vídeo como referência para criar os sons correspondentes com o software de edição de som da sua preferência. **Certifique-se de que a sequência de vídeo corresponde à taxa de fotogramas da animação: 30 fotogramas por segundo (fps).**


---

# 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/props-and-sounds.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.
