> 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/modelacao-3d-e-animacoes/materials.md).

# Materiais

Saiba quais propriedades de material e texturas são suportadas em modelos 3D importados para o Decentraland.

Os materiais são incorporados num ficheiro *.gltf* ou *.glb* .

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

Este documento refere-se a materiais importados num modelo 3D. Para materiais definidos através de código e aplicados a formas primitivas, consulte [**materiais**](https://docs.decentraland.org/creator/development-guide/materials/) .

{% hint style="warning" %}
**📔 Nota**: atualmente, não é possível alterar dinamicamente os materiais de um modelo 3D através do código da sua Scene, a menos que se trate de uma forma primitiva.
{% endhint %}

## Suporte para shaders

Nem todos os shaders podem ser utilizados em modelos importados para a Decentraland. Certifique-se de que utiliza um dos seguintes:

* **Materiais standard:** são suportados todos os shaders, por exemplo, diffuse, specular, transparency, etc.
* **Materiais PBR (Physically Based Rendering)**: este shader é mais flexível, pois inclui propriedades como diffuse, roughness, metalness e emission, que permitem configurar a forma como um material interage com a luz.

A imagem abaixo mostra dois modelos idênticos, criados com as mesmas cores e texturas. O modelo à esquerda utiliza materiais *PBR* , alguns dos quais incluem *metalness*, *transparency* e *emissiveness*. O modelo à direita utiliza materiais *standard* , alguns dos quais incluem *transparency*  e *emissiveness*.

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

### Propriedades PBR atualmente compatíveis com o Decentraland Engine

> * Cor base
> * Metallic
> * Roughness
> * Specular
> * Emissive
> * Intensidade da emissão
> * Alpha
> * Normal

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

Para visualizar o comportamento destas propriedades no mundo, pode visitar este [mundo de testes](decentraland://?realm=TestEnvironment.dcl.eth) para encontrar diferentes objetos e materiais e ver como interagem com as luzes e o ambiente do mundo.

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

### Cor base/diffuse

Define a cor base da superfície do objeto. Por si só, não é afetada pela iluminação, por isso é combinada com outros nós, como roughness, metallic, specular, etc.

### Metallic

Um shader metallic refere-se a uma técnica de renderização utilizada para simular a aparência de superfícies metálicas. Tem em conta as propriedades físicas dos metais e a forma como interagem com a luz para reproduzir o brilho e a refletividade característicos do metal.

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

### Roughness

Os materiais roughness estão relacionados com a simulação realista da interação da luz com a superfície do material. Normalmente, as texturas roughness são utilizadas para dar aos modelos uma variedade de níveis de «suavidade» ou «rugosidade» nas suas superfícies. É normalmente utilizada uma textura em tons de cinzento para fornecer este tipo de informação.

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

Esta propriedade permite alternar entre um modelo de material não metálico e um modelo metálico. Um valor de 1.0 produz um reflexo especular total, matizado com a cor base, sem reflexão difusa nem transmissão. Com 0.0, o material é composto por uma camada base difusa ou transmissiva, com uma camada de reflexão especular por cima.

### Specular

Num shader Physically-Based Rendering (PBR), as propriedades specular descrevem a interação da luz com uma superfície em termos de refletividade e brilho. A reflexão especular é o reflexo da luz numa superfície, semelhante ao de um espelho. Em PBR, esta propriedade controla a quantidade de luz que uma superfície reflete de forma semelhante a um espelho. Materiais como os metais têm normalmente uma reflexão especular elevada, criando realces nítidos e brilhantes, enquanto materiais não metálicos, como os plásticos, têm uma reflexão especular mais baixa, que produz realces mais amplos e suaves.

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

### Alpha

Pode definir um material como *transparente*. É possível ver através dos materiais transparentes em diferentes graus, dependendo do seu *alpha*. Para isso, ative a propriedade de transparência do material e defina o seu *alpha* com o valor pretendido. Um alpha de 1 torna o material completamente opaco; um alpha de 0 torna-o invisível.

A imagem abaixo mostra dois modelos idênticos criados com materiais padrão. O modelo à esquerda usa apenas materiais opacos; o da direita usa materiais transparentes e opacos em algumas das suas partes.

{% hint style="warning" %}
💡 Lembre-se de que usar materiais transparentes tem sempre um custo de desempenho superior ao dos materiais difusos. Tente sempre reduzir ao máximo o número de materiais transparentes.
{% endhint %}

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

Existem dois modos principais de transparência: *Alpha Clip* e *Alpha Blend*. As principais diferenças são:

* **Alpha Clip:** O Alpha Clip renderiza valores absolutos de 0 ou 1, com base num limiar de recorte aplicado a um valor de escala de cinzentos. A cor anterior é substituída pela cor da superfície, mas apenas se o valor alfa estiver acima do valor de Clip Threshold.

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

* **Alpha Blend:** O Alpha Blend interpola valores entre 0 e 1. Pode usar a mistura alfa para sobrepor a cor da superfície à cor anterior.

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

{% hint style="warning" %}
**🔥Dica de otimização🔥** A menos que precise especificamente de um nível intermédio de transparência, **é sempre mais eficiente para a renderização usar \_Alpha Clip***\*\* em vez de \*\****Alpha Blend**\_**.**
{% endhint %}

{% hint style="warning" %}
**⚠️ Problemas de ordenação**

Ao usar modos de mistura transparentes no jogo, é fundamental ter em conta a ordem em que ocorre a mistura de cores, uma vez que a ordem pode afetar significativamente a cor final. Atualmente, o Engine só suporta a ordenação por objeto, o que significa que ordena automaticamente todas as superfícies transparentes com base na origem do objeto. No entanto, a ordenação por fragmento (pixel) e por triângulo não são atualmente suportadas.

Para evitar problemas relacionados com a ordenação, é melhor não usar objetos com Alpha Clip e Alpha Blend na mesma Mesh. Isto pode ajudar a evitar artefactos de mistura inesperados e garantir que o jogo tenha o melhor aspeto possível.
{% endhint %}

### Emissive

Também pode tornar um material *emissivo*. Os materiais emissivos emitem a sua própria luz. Tenha em atenção que, ao serem renderizados, não iluminam realmente os objetos próximos na Scene; apenas parecem ter um brilho difuso à sua volta.

A imagem abaixo mostra dois modelos idênticos criados com materiais padrão. O modelo à direita tem materiais emissivos brilhantes em algumas das suas superfícies.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-46d721ea0ef42370ad4e157d22aeb0ca80143263%2F34-emissive-materials.webp?alt=media) ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-ef396956cdf5da2acc3b3cb0df87d0c1e5042912%2F35-emissive-nodes.webp?alt=media)

*Para tornar um material emissivo no Blender, basta adicionar um shader `emission` ao material.*

### Intensidade emissiva

Intensidade da luz emitida. Um valor de 1.0 garante que o objeto na imagem tenha exatamente a mesma cor que a cor de emissão, ou seja, que não tenha sombras.

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

*Pode verificar no* [*mundo de teste*](decentraland://?realm=TestEnvironment.dcl.eth) *como a intensidade da emissão se comporta no mundo.*

### Normal

O node "normal" num shader PBR é um componente fundamental usado para controlar as normais da superfície de um material. As normais são vetores que definem a direção perpendicular à superfície num ponto específico e desempenham um papel crucial na determinação da forma como a luz interage com a superfície.

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

## Pintura de vértices

A pintura de vértices de modelos 3D não é atualmente suportada pelo Engine da Decentraland.

## Limitações dos materiais

Tenha em conta que os limites de materiais por Parcel são:

> log2(n+1) x 20 quantidade de materiais na Scene. Inclui os materiais importados como parte dos modelos.

É importante ter em conta que cada material representa uma chamada de desenho por objeto. Por isso, é fundamental manter o número de materiais no mínimo possível e tentar reutilizá-los tanto quanto possível, recorrendo a técnicas como Texture Atlases. Isto também ajuda a dar à Scene um estilo coeso entre os seus Assets.

## Nomenclatura dos materiais

Para manter um pipeline artístico organizado e eficiente, recomendamos que atribua nomes adequados aos seus materiais. Uma forma de o fazer é usar esta convenção:

```
<Object>_<Classification>_<Sub-Classification(optional)>_<_MAT>
```

Por exemplo, suponha que criámos duas árvores diferentes: uma emissiva e brilhante para a primavera e outra fria e metálica para o inverno. Poderíamos dar aos materiais os nomes: *"TreeSpring\_Emissive\_MAT"* e outro *"TreeWinter\_Metallic\_MAT"*

Em conclusão,

* 🟢 **Prefira** usar nomes que comecem pelo objeto e pela classificação: *"Wood\_Oak\_MAT"*, *"SciFiFence\_Metallic\_MAT"*, etc.
* 🔴 **Evite** usar nomes como *"Material009"*, *"material1"*, que tornam muito difícil acompanhar e analisar a cena e os modelos.

## Substituir materiais glTF

Pode substituir os materiais de um modelo *glTF* usando o componente [GltfNodeModifiers](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/fundamentos-de-conteudo-3d/materials.md#modify-gltf-materials) no código da cena. Consulte [Modificar materiais glTF](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/fundamentos-de-conteudo-3d/materials.md#modify-gltf-materials) para obter mais detalhes.

## Boas práticas para materiais

* Se a sua cena incluir vários modelos que usam a mesma textura, faça referência à textura como um ficheiro externo, em vez de a incorporar no modelo 3D.

As texturas incorporadas são duplicadas em cada modelo e aumentam o tamanho da cena. *.glb* têm as texturas incorporadas por predefinição, mas pode usar [**glTF pipeline**](https://github.com/AnalyticalGraphicsInc/gltf-pipeline) para as extrair para o exterior.

> Nota: depois de fazer referência a um ficheiro de textura que não será incorporado, certifique-se de que esse ficheiro não será movido nem renomeado, caso contrário, a referência ao ficheiro será perdida. O ficheiro também tem de estar dentro da pasta da cena para ser carregado juntamente com a cena.

* Ao definir a transparência de um material, tente usar sempre *Alpha clip* em vez de *Alpha blend*, a menos que precise especificamente de um material parcialmente transparente (como vidro). Isto evitará problemas em que o motor renderiza o modelo errado à frente do outro.
* Como regra geral, lembre-se de ativar sempre *backface culling* nos seus materiais. Isto melhora o desempenho da cena, uma vez que o motor renderiza apenas a face visível dos modelos. Desative esta opção apenas *backface culling* se precisar que um modelo seja renderizado dos dois lados (por exemplo, um conjunto de folhas de uma árvore feito de planos 3D).

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

* Use as [**texturas predefinidas**](https://github.com/decentraland/builder-assets/tree/master/textures) da Decentraland, que são pré-carregadas pelos jogadores, fazendo com que os seus recursos sejam renderizados muito mais rapidamente.
* Leia [**este artigo**](https://www.khronos.org/blog/art-pipeline-for-gltf) para obter uma visão geral detalhada de um pipeline de arte completo que utiliza texturas PBR em modelos glTF.
* Pode encontrar uma referência detalhada sobre como criar materiais compatíveis com glTF no Blender na [**documentação do Blender**](https://docs.blender.org/manual/en/latest/addons/import_export/scene_gltf2.html) .
* Encontre texturas PBR gratuitas e de alta qualidade em [**cgbookcase**](https://cgbookcase.com/) .


---

# 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/modelacao-3d-e-animacoes/materials.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.
