> 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/materials.md).

# Materiales

Aprende qué propiedades de material y texturas son compatibles con los modelos 3D importados a Decentraland.

Los materiales están incrustados en un archivo *.gltf* o *.glb* .

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

Este documento se refiere a los materiales importados en un modelo 3D. Para ver los materiales definidos mediante código que se aplican a formas primitivas, consulta [**materials**](https://docs.decentraland.org/creator/development-guide/materials/) .

{% hint style="warning" %}
**📔 Nota**: Actualmente no puedes cambiar dinámicamente los materiales de un modelo 3D desde el código de tu escena, a menos que se trate de una forma primitiva.
{% endhint %}

## Compatibilidad con shaders

No todos los shaders se pueden usar en los modelos que se importan en Decentraland. Asegúrate de usar uno de los siguientes:

* **Materiales estándar:** se admiten todos los shaders, por ejemplo, difuso, especular, transparencia, etc.
* **Materiales PBR (renderizado basado en la física)**: Este shader es más flexible, ya que incluye propiedades como difuso, rugosidad, metalicidad y emisión, que te permiten configurar cómo interactúa un material con la luz.

La imagen de abajo muestra dos modelos idénticos, creados con los mismos colores y texturas. El modelo de la izquierda usa exclusivamente materiales *PBR* , algunos de los cuales incluyen *metalicidad*, *transparencia*, y *emisión*. El modelo de la derecha usa exclusivamente materiales *estándar* , algunos de los cuales incluyen *transparencia* y *emisión*.

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

### Propiedades PBR que actualmente funcionan con Decentraland Engine

> * Color base
> * Metálico
> * Rugosidad
> * Especular
> * Emisivo
> * Intensidad de emisión
> * Alfa
> * Normal

![](https://1216664193-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 cómo se comportan estas propiedades en el mundo, puedes visitar este [mundo de pruebas](decentraland://?realm=TestEnvironment.dcl.eth) para encontrar distintos objetos y materiales, y ver cómo interactúan con las luces y el entorno del mundo.

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

### Color base/difuso

Define el color base de la superficie del objeto. Por sí solo, no se ve afectado por la iluminación; por eso se combina con otros nodos, como rugosidad, metalicidad, especular, etc.

### Metálico

Un shader metálico es una técnica de renderizado que se utiliza para simular la apariencia de las superficies metálicas. Tiene en cuenta las propiedades físicas de los metales y cómo interactúan con la luz para producir el brillo y la reflectividad característicos del metal.

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

### Rugosidad

Los materiales con rugosidad permiten simular de forma realista cómo interactúa la luz con la superficie del material. Normalmente, se usan mapas de rugosidad para dar a los modelos distintos niveles de «suavidad» o «rugosidad» en sus superficies. Para proporcionar este tipo de información, se suele usar un mapa de textura en escala de grises.

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

Esta propiedad permite pasar de un modelo de material no metálico a uno metálico. Un valor de 1.0 produce un reflejo especular completo, teñido con el color base, sin reflexión difusa ni transmisión. Con un valor de 0.0, el material consta de una capa base difusa o transmisiva, con una capa de reflexión especular encima.

### Especular

En un shader de renderizado basado en la física (PBR), las propiedades especulares describen cómo interactúa la luz con una superficie en cuanto a reflectividad y brillo. La reflexión especular es el reflejo de la luz en una superficie, similar al de un espejo. En PBR, esta propiedad controla cuánta luz refleja una superficie de esta manera. Los materiales como los metales suelen tener una reflexión especular intensa, que produce reflejos brillantes y definidos, mientras que los materiales no metálicos, como los plásticos, tienen una reflexión especular menor, lo que da lugar a reflejos más amplios y suaves.

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

### Alfa

Puedes configurar un material para que sea *transparente*. Los materiales transparentes dejan ver a través de ellos en distintos grados, según su valor de *alfa*. Para ello, activa la propiedad de transparencia del material y luego ajusta su valor de *alfa* a la cantidad deseada. Un alfa de 1 hará que el material sea completamente opaco; un alfa de 0 hará que sea invisible.

La imagen de abajo muestra dos modelos idénticos creados con materiales estándar. El de la izquierda solo usa materiales opacos; el de la derecha usa materiales transparentes y opacos en algunas de sus partes.

{% hint style="warning" %}
💡 Recuerda que usar materiales transparentes siempre tiene un mayor costo de rendimiento que usar materiales difusos. Intenta siempre reducir al mínimo la cantidad de materiales transparentes.
{% endhint %}

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

Hay dos modos principales de transparencia: *Alpha Clip* y *Alpha Blend*. Estas son las principales diferencias:

* **Alpha Clip:** Alpha Clip representa valores absolutos de 0 o 1 según un umbral de recorte aplicado a un valor de escala de grises. El color anterior se sobrescribe con el color de la superficie, pero solo si el valor alfa está por encima del valor de Clip Threshold.

![](https://1216664193-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:** Alpha Blend interpola los valores entre 0 y 1. Puedes usar la combinación alfa para superponer el color de la superficie sobre el color anterior.

![](https://1216664193-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" %}
**🔥Consejo de optimización🔥** A menos que necesites específicamente un nivel intermedio de transparencia, **para el renderizado siempre es más eficiente usar \_Alpha Clip***\*\* en lugar de \*\****Alpha Blend**\_**.**
{% endhint %}

{% hint style="warning" %}
**⚠️ Problemas de ordenamiento**

Cuando usas modos de combinación transparentes en tu juego, es fundamental tener en cuenta el orden en que se combinan los colores. Esto se debe a que el orden de combinación puede afectar significativamente el color final de salida. Actualmente, el Engine solo admite el ordenamiento por objeto, lo que significa que ordena automáticamente todas las superficies transparentes según el origen del objeto. Sin embargo, por ahora no se admiten el ordenamiento por fragmento (píxel) ni el ordenamiento por triángulo.

Para evitar problemas relacionados con el ordenamiento, es mejor no usar objetos que tengan Alpha Clip y Alpha Blend en el mismo Mesh. Esto puede ayudar a evitar artefactos de combinación inesperados y garantizar que tu juego se vea de la mejor manera posible.
{% endhint %}

### Emisivo

También puedes hacer que un material sea *emisivo*. Los materiales emisivos emiten su propia luz. Ten en cuenta que, al renderizarse, no iluminan realmente los objetos cercanos de la escena; solo parecen tener un resplandor difuminado a su alrededor.

La imagen de abajo muestra dos modelos idénticos creados con materiales estándar. El de la derecha tiene materiales emisivos brillantes en algunas de sus superficies.

![](https://1216664193-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://1216664193-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 hacer que un material sea emisivo en Blender, simplemente añade un `emission` al material.*

### Intensidad de emisión

Intensidad de la luz emitida. Un valor de 1.0 garantiza que el objeto de la imagen tenga exactamente el mismo color que el color de emisión; es decir, que no tenga sombreado.

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

*Puedes comprobar en el* [*mundo de prueba*](decentraland://?realm=TestEnvironment.dcl.eth) *cómo se comporta la intensidad de emisión en el mundo*

### Normal

El nodo "normal" de un shader PBR es un componente fundamental que se usa para controlar las normales de superficie de un material. Las normales son vectores que definen la dirección perpendicular a una superficie en un punto específico y desempeñan un papel crucial para determinar cómo interactúa la luz con la superficie.

![](https://1216664193-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

Actualmente, el Engine de Decentraland no admite la pintura de vértices en modelos 3D.

## Limitaciones de los materiales

Ten en cuenta que los límites de materiales por parcela son:

> log2(n+1) x 20: cantidad de materiales en la escena. Incluye los materiales importados como parte de los modelos.

Es importante tener en cuenta que cada material representa una llamada de dibujo por objeto, por lo que es fundamental usar la menor cantidad posible de materiales e intentar reutilizarlos tanto como sea posible mediante técnicas como las atlases de texturas. Esto también ayudará a que la escena tenga un estilo cohesivo entre sus assets.

## Nombres de materiales

Para mantener un pipeline de arte organizado y saludable, recomendamos asignar nombres adecuados a los materiales. Una forma de hacerlo es usar esta convención:

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

Por ejemplo, supongamos que creamos dos árboles diferentes: uno emisivo y brillante para la primavera y otro frío y metálico para el invierno. Podríamos nombrar los materiales así: *"TreeSpring\_Emissive\_MAT"* y el otro *"TreeWinter\_Metallic\_MAT"*

En conclusión,

* 🟢 **Prefiere** usar nombres que empiecen por el objeto y su clasificación: *"Wood\_Oak\_MAT"*, *"SciFiFence\_Metallic\_MAT"*, etc.
* 🔴 **Evita** usar nombres como *"Material009"*, *"material1"*, ya que dificultan mucho el seguimiento de la escena y los modelos.

## Anular materiales glTF

Puedes anular los materiales de un *glTF* modelo usando el componente [GltfNodeModifiers](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/fundamentos-del-contenido-3d/materials.md#modify-gltf-materials) en el código de tu escena. Consulta [Modificar materiales glTF](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/fundamentos-del-contenido-3d/materials.md#modify-gltf-materials) para obtener más detalles.

## Prácticas recomendadas para materiales

* Si tu escena incluye varios modelos que usan la misma textura, haz referencia a la textura como un archivo externo en lugar de incrustarla en el modelo 3D.

Las texturas incrustadas se duplican en cada modelo y aumentan el tamaño de la escena. *.glb* incrustan sus texturas de forma predeterminada, pero puedes usar [**glTF pipeline**](https://github.com/AnalyticalGraphicsInc/gltf-pipeline) para extraerla al exterior.

> Nota: Después de hacer referencia a un archivo de textura que no se va a incrustar, asegúrate de que ese archivo no se mueva ni se cambie de nombre; de lo contrario, se perderá la referencia. El archivo también debe estar dentro de la carpeta de la escena para que se cargue junto con ella.

* Al configurar la transparencia de un material, intenta usar siempre *Alpha clip* en lugar de *Alpha blend*, a menos que necesites específicamente un material parcialmente transparente (como el vidrio). Esto evitará que el motor renderice por delante el modelo equivocado.
* Como regla general, recuerda activar siempre *backface culling* en tus materiales. Esto mejorará el rendimiento de tu escena, ya que el motor solo renderizará las caras visibles de tus modelos. Desactiva esta opción únicamente *backface culling* si necesitas que un modelo se renderice por ambos lados (por ejemplo, un conjunto de hojas de un árbol creado con planos 3D).

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

* Usa las [**texturas predeterminadas**](https://github.com/decentraland/builder-assets/tree/master/textures) de Decentraland, que los jugadores ya tienen precargadas, para que tus assets se rendericen mucho más rápido.
* Lee [**este artículo**](https://www.khronos.org/blog/art-pipeline-for-gltf) para obtener una descripción detallada de un pipeline artístico completo que utiliza texturas PBR en modelos glTF.
* Puedes encontrar una referencia detallada sobre cómo crear materiales compatibles con glTF en Blender en [**la documentación de Blender**](https://docs.blender.org/manual/en/latest/addons/import_export/scene_gltf2.html) .
* Encuentra texturas PBR gratuitas y de alta calidad en [**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-es/modelado-y-animaciones-3d/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.
