# Emotes

Emotes são os [entities](https://github.com/decentraland/docs/blob/main/contributor/entities/README.md) que contêm animações para os avatares dos jogadores.

Eles incluem arquivos em formato GLB para diferentes body shapes.

### Pointers <a href="#pointers" id="pointers"></a>

Emotes têm exatamente um associado [pointer](https://github.com/decentraland/docs/blob/main/contributor/pointers/README.md), que indica a coleção a que pertencem e seu índice dentro dela. São URNs desta forma:

```
urn:decentraland:matic:collections-v2:<collection address>:<item index>
```

Para ilustrar, o `pointers` array para um emote se parece com isto:

```json
{
  "pointers": [
    "urn:decentraland:matic:collections-v2:0x2d9560df9dd8ba8b2dc3746bc1d217698d258fb5:0"
  ],
  // ... other entity properties
}
```

### Campos de Metadata

Emotes compartilham a maioria de seus campos básicos com [wearables](https://github.com/decentraland/docs/blob/main/contributor/entity-types/wearables/README.md). O `emoteDataADR74` propriedade é onde a informação específica do emote está localizada.

| Campo               | Valor                                                                                                                                                 |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                | O [pointer](https://github.com/decentraland/docs/blob/main/contributor/pointers/README.md) que resolve (ou costumava resolver) para este emote.       |
| `name`              | O título de exibição para este emote em um [collection](https://github.com/decentraland/docs/blob/main/contributor/collections/README.md).            |
| `description`       | Uma descrição estendida para este emote.                                                                                                              |
| `imagem`            | O [nome de arquivo interno](https://github.com/decentraland/docs/blob/main/contributor/entities/README.md#files) com uma imagem para este emote.      |
| `miniatura`         | O [nome de arquivo interno](https://github.com/decentraland/docs/blob/main/contributor/entities/README.md#files) para uma versão 256x256 da `imagem`. |
| `raridade`          | Um de `comum`, `incomum`, `raro`, `épico`, `lendário`, `exótico`, `mítico` ou `único`.                                                                |
| `i18n`              | Um array de traduções para o campo `name` .                                                                                                           |
| `collectionAddress` | O endereço Ethereum da coleção que contém este emote.                                                                                                 |
| `metrics`           | Algumas medições úteis sobre as animações (veja abaixo).                                                                                              |
| `emoteDataADR74`    | Os metadados estendidos para este emote, conforme definido em [ADR-74](https://adr.decentraland.org/adr/ADR-74) (veja abaixo).                        |

É assim que um JSON típico se parece:

```json
{
  "id": "urn:decentraland:matic:collections-v2:0x2d9560df9dd8ba8b2dc3746bc1d217698d258fb5:0",
  "name": "Funny Dance",
  "description": "Move around like a champ",
  "image": "image.png",
  "thumbnail": "thumbnail.png",
  "rarity": "rare",
  "i18n": [
    { "code": "es", "text": "Danza Graciosa" }
  ],
  "collectionAddress": "0x2d9560df9dd8ba8b2dc3746bc1d217698d258fb5",
  "metrics": {
    // Objeto de medições (veja abaixo).
  },
  "emoteDataADR74": {
    // Metadados estendidos definidos em ADR-74 (veja abaixo).
  }
}
```

### Metrics

Na `metadata.metrics` objeto, você encontrará algumas medições simples para a animação empacotada com este emote. Um exemplo:

```json
{
  "triangles": 0,
  "materials": 0,
  "textures": 0,
  "meshes": 0,
  "bodies": 0,
  "entities": 1
}
```

### Emote Data ADR-74

Este objeto contém os campos que os World Explorers (ou outras aplicações gráficas) precisam para animar modelos com este emote.

| Campo             | Valor                                                                                          |
| ----------------- | ---------------------------------------------------------------------------------------------- |
| `category`        | Um de `dance`, `stunt`, `greetings`, `fun`, `poses`, `reactions`, `horror` ou `miscellaneous`. |
| `representations` | Um array de arquivos de animação associados a diferentes body shapes.                          |
| `tags`            | Um array de tags string descritivas deste emote.                                               |
| `loop`            | `true` se a animação deve se repetir quando terminar.                                          |

Algum JSON para clareza:

```json
{
  "category": "dance",
  "representations": [
    // Informação sobre a animação para diferentes body shapes (veja abaixo).
  ],
  "tags": [ "carnaval", "dance" ],
  "loop": true
}
```

#### Representations

Cada item em `metadata.emoteDataADR74.representations` campo define os arquivos de animação apropriados para cada body shape.

| Campo        | Valor                                                                                                                                          |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `bodyShapes` | Um array de body shape aplicáveis [pointers](https://github.com/decentraland/docs/blob/main/contributor/pointers/README.md).                   |
| `mainFile`   | O [nome de arquivo interno](https://github.com/decentraland/docs/blob/main/contributor/entities/README.md#files) para o arquivo GLB principal. |
| `contents`   | Todos os arquivos, incluindo `mainFile` e quaisquer adicionais que ele possa referenciar.                                                      |

Por exemplo, um `representation` item:

```json
{
  "bodyShapes": [ "urn:decentraland:off-chain:base-avatars:BaseMale" ],
  "mainFile": "male/funnydance.glb",
  "contents": [
    "male/funnydance.glb"
  ]
}
```

Você normalmente encontrará duas entradas de representation, uma para `BaseMale` e uma para `BaseFemale`.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.decentraland.org/contributor/contributor-pt/content/entity-types/emotes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
