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

# Meshes

Aprende qué propiedades de mesh de sombrero son compatibles en los modelos 3D importados a Decentraland.

Los modelos 3D tienen una *malla* compuesta por *caras triangulares*. Estas caras se unen en las *aristas* (las líneas a lo largo de las cuales se tocan) y los *vértices* (los puntos donde se unen sus esquinas).

{% hint style="info" %}
**💡 Consejo**: Instala el [plugin Decentraland Tools para Blender](https://extensions.blender.org/add-ons/decentraland-tools/). Incluye varias Functions útiles para editar y exportar modelos 3D, Wearables y Emotes.
{% endhint %}

## Limitaciones de espacio

Todos los modelos 3D de la escena deben caber dentro de los límites de sus parcelas. Si alguna parte de tus modelos sobrepasa estos límites al ejecutar una vista previa, las partes que sobresalgan se recortarán y no se renderizarán.

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

En el editor de Creator Hub, verás el modelo teñido de rojo y su caja delimitadora marcada en rojo.

![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-6907f08addc3dc3e1f828f7f28ae4c16ad7b50db%2Ftrain-out-of-bounds.webp?alt=media)

{% hint style="info" %}
**📔 Nota**: En el antiguo cliente web de Decentraland, por motivos de rendimiento, si alguna parte de un modelo 3D quedaba fuera de los límites, aunque solo fuera la caja delimitadora, no se renderizaba el modelo entero. En el cliente de escritorio Decentraland 2.0, solo se recortan las partes del modelo que quedan fuera de los límites. Las partes del modelo que están dentro de la escena sí se renderizan.
{% endhint %}

## Cajas delimitadoras

Si tienes un modelo cuyos vértices están todos ordenadamente dentro del área de la escena, pero que tiene cajas delimitadoras grandes, en su mayoría vacías y que sobrepasan los límites de la escena, Creator Hub marcará todo el modelo como situado fuera de los límites de la escena. Las partes del modelo que estén dentro de tus parcelas se renderizarán correctamente y podrás publicar la escena.

Cada malla tiene una caja delimitadora que rodea los límites de la forma. Para que un modelo 3D sea más práctico en Decentraland, asegúrate de que sus cajas delimitadoras no se extiendan más allá del modelo de lo necesario.

Para evitar este problema, puedes limpiar tus modelos 3D y restablecer la posición y la rotación de las mallas para que las cajas delimitadoras no sobrepasen las mallas que rodean.

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

*En Blender, puedes hacerlo seleccionando los objetos, presionando Ctrl+A y luego aplicando «All transforms».*

Por ejemplo, ten cuidado al rotar una submalla cerca del borde de tu modelo. Como las cajas delimitadoras son cubos, aunque la malla sea redonda, las esquinas de su caja delimitadora podrían sobresalir después de rotarla 45°.

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

Te recomendamos aplicar la rotación y la escala de cada malla del modelo para asegurarte de que no haya cajas delimitadoras no deseadas que sobresalgan del tamaño necesario.

## Limitaciones de triángulos

Como Decentraland es un mundo abierto lleno de escenas y objetos diferentes que se descargan sobre la marcha (en el mismo espacio 3D), es importante optimizar nuestras mallas para que el rendimiento durante el juego sea bueno. En este sentido, hay algunas limitaciones de las escenas que siempre debemos tener presentes al trabajar con mallas:

> n representa la cantidad de parcelas que ocupa una escena.

* **Triángulos:** n x 10000 Cantidad total de triángulos para todos los modelos de la escena.
* **Altura:** 330 metros, independientemente de la cantidad de parcelas.
* **Tamaño de los archivos:** 15 MB por parcela - 300 MB como máximo. Tamaño total de los archivos subidos al servidor de contenido. Incluye modelos 3D y audio. No incluye archivos que no se suben, como los paquetes de node.js.
* **Tamaño máximo de archivo: 50 MB por archivo** Ningún archivo individual de la escena, sea del tipo que sea, puede superar los 50 MB, independientemente de cuántas parcelas tenga la escena.

Para obtener más información, consulta todas las limitaciones de las escenas [aquí.](https://docs.decentraland.org/creator/development-guide/scene-limitations/)

{% hint style="warning" %}
**🔥Consejo de optimización🔥: Añadir el recuento de polígonos** Un consejo útil es llevar siempre un control del recuento de polígonos de tus modelos. Para hacerlo en Blender, debes activar las estadísticas en el panel de superposiciones de la vista.

<img src="https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-8cfbd1397ed139852514fb88fec9867a6837c38a%2F41-stats.webp?alt=media" alt="" data-size="original">
{% endhint %}

## Mallas en escenas grandes

Al crear mallas, debemos tener presentes estas 2 prácticas recomendadas:

* **Modularidad:** Divide las mallas grandes en partes más pequeñas y modulares. Por ejemplo, en lugar de usar una sola malla para todo un edificio, puedes dividirlo en mallas separadas para cada pared, piso y sección. Esto permite que el frustum culling de Unity funcione de forma más eficaz, ya que solo es necesario tener en cuenta las partes visibles para el renderizado. También mejorará el uso de memoria, porque una misma malla se puede reutilizar varias veces para el mismo objeto en distintas ubicaciones (para lograrlo, tendrás que hacer referencia a la misma malla en la definición de la escena SDK7 o usar instancias en lugar de duplicar objetos al exportar la escena desde Blender).
* **Volumen delimitador**: Asegúrate de que el volumen delimitador de cada objeto se ajuste lo máximo posible. El espacio sobrante en el volumen delimitador puede hacer que los objetos se rendericen cuando no son visibles.

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

### ¿Qué es el frustum culling?

El frustum culling es una técnica de optimización que desactiva los renderizadores (mallas) de los objetos que están fuera del área de visión de la cámara. Consulta estos 2 ejemplos:

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

*Un nivel interior con forma de laberinto. Esta vista normal de la escena muestra todos los Game Objects visibles.*

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

*El frustum culling normal solo renderiza los objetos que están dentro del campo de visión de la cámara. Este proceso es automático y siempre se lleva a cabo.*

## Instanciar objetos frente a duplicarlos

En Blender, duplicar un objeto crea una copia completamente independiente, mientras que instanciarlo crea un duplicado que comparte los mismos datos que el objeto original.

Al duplicar un objeto, se crea uno nuevo con un conjunto de datos completamente independiente, incluidos todos sus elementos geométricos, materiales y animaciones. Esto significa que los cambios realizados en el objeto original no se reflejarán en el duplicado, y viceversa.

Por otro lado, al instanciar un objeto, los cambios realizados en el objeto original se reflejarán en todas sus instancias, y viceversa. Esto se debe a que todas las instancias comparten los mismos datos subyacentes.

En términos de rendimiento, crear instancias puede ser mucho más eficiente que duplicar, especialmente cuando se trabaja con Scenes complejas o con un gran número de objetos. Esto se debe a que las instancias usan menos memoria que los duplicados, ya que no crean datos nuevos para cada instancia. Además, las instancias pueden permitir que Blender optimice el proceso de renderizado al tratar todas las instancias como un único objeto, en lugar de renderizar cada duplicado por separado.

En general, crear instancias puede ser una herramienta eficaz para mejorar el rendimiento y la eficiencia del flujo de trabajo en Blender y en tu Scene de Decentraland, especialmente cuando se trabaja con Scenes grandes y complejas.

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

En algunos casos, al copiar objetos como árboles, plantas y farolas, crear instancias puede mejorar considerablemente el rendimiento en comparación con duplicarlos. Por ejemplo, esta Scene tiene catorce farolas, todas exactamente iguales. Sabemos que cada farola tiene dos Textures diferentes: una para el poste y otra para la luz. Por tanto, en este caso tendremos dos llamadas de dibujo, una por Texture.

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

En Blender, cuando llegas a la fase de clonar y colocar elementos en el espacio, tienes tres opciones: duplicar, crear instancias o unir los objetos.

Analicemos las ventajas y desventajas de cada procedimiento.

### Duplicar objetos

| Menú:             | Objeto ‣ Duplicar objetos |
| ----------------- | ------------------------- |
| Atajo de teclado: | Shift-D                   |

Esto creará una copia visualmente idéntica del objeto seleccionado, pero se tratarán como objetos diferentes. Por tanto, al exportar tendrás 2 llamadas de dibujo por objeto, 2 \* 14 = 28 llamadas de dibujo, y un uso total de disco de 320 kb.

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

### Crear instancias de objetos

| Panel:            | Barra de herramientas ‣ Herramientas ‣ Editar ‣ Duplicar vinculado |
| ----------------- | ------------------------------------------------------------------ |
| Menú:             | Objeto ‣ Duplicar vinculado                                        |
| Atajo de teclado: | Alt-D                                                              |

Esto creará un objeto nuevo con todos sus datos vinculados al objeto original. Si modificas uno de los objetos vinculados en el modo de edición, todas las copias vinculadas se modifican. Las propiedades de Transform siguen siendo copias, no vínculos, por lo que puedes rotar, escalar y mover libremente los objetos sin afectar a las demás copias.

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

*Al exportar estos modelos, seguiremos teniendo el mismo número de llamadas de dibujo (28). Sin embargo, observa que ahora solo tenemos un mesh, lo que reduce considerablemente el uso de disco (41 kb).*

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

*Para mantener todo organizado, puedes crear instancias de colecciones en tu Scene. De este modo, puedes controlar todas las instancias desde una única Folder y fuente.*

{% hint style="info" %}
**💡 Consejo**: La misma lógica se aplica en el SDK. Catorce Entities que apuntan con su  `GltfContainer`  al mismo archivo  *.glb*  se comportan como instancias: el archivo se descarga y se convierte una sola vez, y sus meshes y Textures se mantienen en memoria una sola vez, independientemente de cuántas Entities lo usen. Dividir el mismo contenido en catorce archivos  *.glb*  casi idénticos equivale a duplicarlos y supone catorce descargas y catorce copias en memoria.
{% endhint %}

### Unir objetos

| Menú:             | Objeto ‣ Unir |
| ----------------- | ------------- |
| Atajo de teclado: | Ctrl-J        |

Esto une los objetos seleccionados en un único objeto con un único mesh. Funciona en el modo objeto, combina todo en el último objeto  *activo*  seleccionado y requiere que todos los objetos seleccionados sean del mismo tipo. Los Materials se conservan y se combinan, por lo que nuestras catorce farolas dejan de ser catorce objetos renderizables y pasan a ser uno solo, y el Engine las dibuja con 2 llamadas de dibujo en lugar de 28: una por cada Material.

Esta es la única de las tres opciones que realmente reduce las llamadas de dibujo, y conviene aclarar por qué: el Engine de Decentraland construye tu Scene en Runtime a partir de contenido transmitido por Streaming, por lo que no puede agrupar objetos repetidos por ti como lo haría un Engine con contenido preparado de antemano. Si necesitas menos llamadas de dibujo, debes unir los objetos en Blender.

Esa reducción tiene un coste. Al unir objetos, renuncias a varias cosas a la vez:

* **El uso de disco vuelve a aumentar.** El mesh combinado almacena la geometría de los catorce postes, por lo que pierdes el ahorro que te ofrecían las instancias.
* **El descarte por campo de visión pasa a ser de todo o nada.** Un objeto combinado se dibuja por completo siempre que cualquier parte de él aparece en pantalla. Si hay catorce farolas repartidas a lo largo de una calle, casi siempre habrá una visible, por lo que acabarás dibujando las catorce en todo momento, lo que puede costar fácilmente más que las llamadas de dibujo que ahorraste.
* **Las partes dejan de poder controlarse individualmente.** Ya no puedes mover, animar, hacer Click en una sola farola ni ocultarla, porque solo queda un objeto.

Usa la unión de forma limitada: para muchos objetos pequeños que siempre se ven juntos en un mismo lugar, con los que nunca se interactúa y solo después de confirmar que el número de objetos es lo que realmente perjudica el rendimiento. Para todo lo demás, crear instancias es la mejor opción por defecto.

{% hint style="warning" %}
**📔 Nota**: Exportar catorce objetos separados a un único archivo  *.glb*   **no**  equivale a unirlos. El Engine sigue viendo catorce objetos y sigue emitiendo 28 llamadas de dibujo. Solo unir los meshes cambia esa cifra.
{% endhint %}

## Nombres de los meshes

Usa nombres descriptivos para tus meshes. El nombre debe dar contexto sobre dónde se usa el recurso o con qué parte del objeto está relacionado.

Para nombrar los recursos, usa una combinación de `PascalCase` y `snake_case`, que podemos llamar `PascalSnake_case`. Reglas básicas: cada palabra nueva o palabra que va después de un separador (`_`) empieza con **Mayúscula.**

* Usa nombres descriptivos para tus Meshes **Ejemplos:** 🟢 **Se prefieren** los nombres `Theater`, `Tram` 🔴 **Evita** los nombres `Untitiled.008`, `primitive(1)`, `Cylinder.091`, `_sphere-AB`
* Usa guiones bajos `_` como separadores para aportar más contexto al nombre. Coloca primero los elementos más comunes y deja los detalles para el final. **Ejemplos:** 🟢 **Se prefieren** los nombres `FountainStatue`, `TheaterMainWall`, `TramWheelLeft` 🔴 **Evita** los nombres `North_MainWall_Theater`, `Tram_LeftFront_Wheel`

Si hay más de un objeto con el mismo nombre, añade un número después de la palabra: `FountainStatue01, FountainStatue02, etc.`

## Herramientas para crear modelos

Hay muchos addons y herramientas externas que facilitan el trabajo al crear assets, para que el proceso sea más rápido y eficiente. Algunas son gratuitas y otras de pago. Por mencionar algunas:

### Decimate

Este es un modificador muy conocido que se puede usar para reducir la cantidad de tris de tu Mesh sin alterar la estructura de la superficie del modelo. Aunque es una herramienta muy potente para optimizar modelos, ten en cuenta que, una vez que el modelo se haya decimado, la topología puede verse afectada y quedar desordenada (porque la geometría se divide en partes impredecibles). Por otro lado, la decimación convierte los quads de tu Mesh en triángulos, lo que dificulta modificarlo después. En ese sentido, **la decimación puede ser útil para modelos estáticos, pero no se recomienda para modelos animados.**

![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a9339c43ca63e7f2599fd928ef1d3c733154fa79%2F42-decimate-01.webp?alt=media) ![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-434b2725cc7cc70a152e6b055a89c27891d79c65%2F43-decimate-02.webp?alt=media)

Otra forma de optimizar tus Meshes mediante decimación es decimar el modelo y luego hacer una retopología adecuada. De esta forma, puedes obtener un resultado más predecible y una topología limpia.

Algunos addons de retopología que pueden ser útiles (algunos son de pago):

* **Simplygon:** <https://www.simplygon.com/>
* **Speedretopo:** <https://blendermarket.com/products/speedretopo?ref=2>
* **Retopoflow:** <https://blendermarket.com/products/retopoflow>

### Modificador Mirror

El modificador Mirror de Blender es una herramienta para crear modelos simétricos reflejando una mitad de un objeto en cualquier dirección (X,Y,Z). Es muy útil cuando tienes modelos simétricos, ya que reduce el tiempo de modelado 3D y de desenvolver las UV (porque solo tendrás que desenvolver una parte del modelo y el resto compartirá las mismas coordenadas UV), y también permite optimizar las texturas al evitar desperdiciar resolución en partes que son esencialmente reflejos.

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

### Cambio de nombre por lotes

Una herramienta muy práctica para cambiar convenciones de nombres fácilmente es Batch Rename, integrada en el conjunto de herramientas de Blender. Para acceder a ella, ve a *Editar* y luego a *Cambio de nombre por lotes*.

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

Selecciona los objetos cuyo nombre quieras cambiar y reemplaza el nombre de objeto predeterminado por el nuevo. Esta herramienta ofrece distintos métodos y tipos de recursos para cambiar el nombre, por lo que también permite cambiar fácilmente los nombres de Meshes, animaciones, Bones, etc.

![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-fe3be0f7d4c5fbac746529bff8ba8bdf6327f058%2F47-batch-rename-methods.webp?alt=media) ![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-845886b63580e6c82b49a91d90b9753725440727%2F46-batch-rename-types.webp?alt=media)

## Prácticas recomendadas para la geometría [#](https://docs.decentraland.org/creator/3d-modeling/meshes/#best-practices-for-geometries)

* Ten en cuenta cuántas Faces añades a tus modelos 3D, ya que un mayor número de Faces hace que su renderizado requiera más recursos. Consulta [**las limitaciones de la Scene**](https://docs.decentraland.org/creator/development-guide/scene-limitations/) para ver los límites que impone una Scene.
* Asegúrate de que no haya Faces ocultas que no se puedan ver, pero que aumenten el recuento de triángulos.
* Para las formas que deban tener lados redondeados, configúralas como *suaves* en lugar de añadir Faces adicionales.
* Asegúrate de que las *normales* de todas las Faces apunten hacia afuera y no hacia adentro. Si al renderizar tu modelo parece que faltan algunas Faces, lo más probable es que esta sea la causa.
* Aplica la rotación y la escala de tus Meshes para que sus cuadros delimitadores no se extiendan más de lo necesario.


---

# 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/meshes.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.
