> 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/3d-models.md).

# Modelos 3D

Saiba quais assets e components são suportados em modelos 3D externos e como configurá-los antes de importá-los para o Decentraland.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-53d39d4a954bc59ae0ec6b47e31b8dc04d0c6a4b%2F01-3d-essentials-banner.webp?alt=media)

Ao importar modelos 3D para Decentraland, é importante garantir que estejam no formato glTF. Esses modelos podem incluir vários recursos compatíveis. Esta secção explica como torná-los compatíveis com Decentraland e seguir as boas práticas.

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

Tenha em atenção que todos os modelos, shaders e texturas têm de cumprir as [**limitações das cenas**](https://docs.decentraland.org/creator/scenes-sdk7/optimizing/scene-limitations/).

## **Formatos de modelos 3D compatíveis**

Todos os modelos 3D em Decentraland têm de estar no formato glTF. [**glTF**](https://www.khronos.org/gltf) (GL Transmission Format) é um projeto aberto da Khronos que disponibiliza um formato comum e extensível para recursos 3D, eficiente e altamente interoperável com as tecnologias Web modernas.

Os modelos glTF podem ter a extensão *.gltf* ou *.glb* Os ficheiros glTF são legíveis por pessoas: pode abrir um num editor de texto e lê-lo como um ficheiro JSON. Isto é útil, por exemplo, para verificar se as animações estão devidamente associadas e consultar os respetivos nomes. Os ficheiros glb são binários, pelo que não são legíveis, mas são consideravelmente mais pequenos, o que é benéfico para o desempenho da cena.

Recomendamos que utilize *.gltf* enquanto estiver a trabalhar numa cena e, depois, mude para *.glb* quando a carregar.

Os seguintes aspetos de um modelo 3D podem estar incorporados num ficheiro *glTF* ou ser referenciados externamente:

* As texturas podem estar incorporadas ou ser referenciadas a partir de um ficheiro de imagem externo.
* Os dados binários relativos à geometria, às animações e a outros aspetos do modelo relacionados com buffers podem estar incorporados ou ser referenciados a partir de um ficheiro externo *.bin* .

{% hint style="warning" %}
**📔 Nota**: As animações *têm de* estar incorporadas no ficheiro *glTF* para serem utilizadas em Decentraland. Além disso, cada modelo só pode ter 1 mapa UV.
{% endhint %}

## **Por que utilizamos glTF**

Utilizamos glTF porque disponibiliza um conjunto poderoso de funcionalidades, incluindo:

* Objetos hierárquicos
* Estrutura esquelética e animação
* Pipeline robusto para materiais e shaders
* Informações da cena, como fontes de luz e câmaras (que poderão ser utilizadas em desenvolvimentos futuros).

Em comparação com *COLLADA*, as funcionalidades compatíveis são muito semelhantes. No entanto, como o glTF se concentra em disponibilizar um «formato de transmissão» e não um formato de editor, é mais interoperável com as tecnologias Web.

## **Exportar e converter glTF**

### **Exportar para glTF a partir do Blender**

O Blender tem um exportador glTF integrado.

Para exportar, selecione os modelos que pretende incluir no ficheiro .glb e, em seguida, aceda a File - Export - glTF 2.0

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a0c73d489695d94bf1513516f3c5070882415328%2F02-export-glt-from-blender.webp?alt=media) ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-fd4b360f85f1f67052fee21ce7e2ac5dcda0e37e%2F03-exporting-options.webp?alt=media)

*No painel lateral, selecione “Selected Objects” se pretender exportar apenas os objetos selecionados na cena. Além disso, no menu suspenso Mesh, selecione Apply Modifiers (se aplicável) e, em seguida, Export.*

### **Exportar para glTF a partir do 3D Studio Max**

O 3D Studio Max não é compatível com a exportação para glTF por predefinição, mas pode instalar um plugin para ativar essa funcionalidade.

1. Transfira o plugin a partir [desta ligação](https://github.com/BabylonJS/Exporters/tree/master/3ds%20Max).
2. Instale o plugin seguindo [estas instruções](http://doc.babylonjs.com/resources/3dsmax#how-to-install-the-3ds-max-plugin).
3. Exporte ficheiros glTF com o plugin seguindo [estas instruções](http://doc.babylonjs.com/resources/3dsmax_to_gltf).

### **Exportar para glTF a partir do Maya**

Por predefinição, o Maya não permite exportar para glTF, mas pode instalar um plugin para ativar esta funcionalidade.

1. Instale o plugin seguindo [estas instruções](http://doc.babylonjs.com/resources/maya).
2. Exporte ficheiros glTF com o plugin seguindo [estas instruções](http://doc.babylonjs.com/resources/maya_to_gltf#pbr-materials).

{% hint style="warning" %}
**📔 Nota**: Em alternativa, também pode experimentar [este outro plugin](https://github.com/WonderMediaProductions/Maya2glTF) .
{% endhint %}

### **Exportar para glTF a partir do Unity**

Por predefinição, o Unity não permite exportar para glTF, mas pode instalar um plugin para ativar esta funcionalidade.

Transfira o plugin a partir [desta ligação](https://github.com/sketchfab/Unity-glTF-Exporter).

{% hint style="warning" %}
**📔 Nota**: Em alternativa, também pode experimentar [este outro plugin](https://assetstore.unity.com/packages/tools/utilities/collada-exporter-for-unity2017-99793) .
{% endhint %}

### **Exportar para glTF a partir do SketchUp**

Por predefinição, o SketchUp não permite exportar para glTF, mas pode instalar um plugin para ativar esta funcionalidade.

Transfira o plugin a partir [desta ligação](https://extensions.sketchup.com/en/content/gltf-exporter).

### **Converter FBX em glTF**

*.fbx* é um formato muito popular para modelos 3D. O nosso motor não o suporta, mas pode exportar facilmente um modelo *.fbx* para o formato *.gltf* .

Recomendamos estas ferramentas:

* [**Blender**](https://www.blender.org/download/): Uma forma fácil de converter .fbx em glTF é importar o .fbx para uma cena no Blender e, em seguida, exportá-lo a partir daí.
* [**Ferramenta CLI do Facebook**](https://github.com/facebookincubator/FBX2glTF): esta é a alternativa mais robusta, mas requer a utilização da linha de comandos.
* [**Blackthread**](https://blackthread.io/gltf-converter): Esta é a ferramenta Web mais completa. É menos robusta do que a CLI, mas muito mais fácil de utilizar.
* [**Modelconverter**](https://modelconverter.com/convert.html): Outra ferramenta Web fácil de utilizar.

## **Pré-visualizar um modelo glTF**

Uma forma rápida e fácil de pré-visualizar o conteúdo de um modelo glTF antes de o importar para uma cena é utilizar o [**Babylon.js Sandbox**](https://sandbox.babylonjs.com/). Basta arrastar e largar o ficheiro glTF (e o respetivo ficheiro *.bin* se aplicável) na tela para ver o modelo.

Na sandbox, também pode pré-visualizar as animações incorporadas no modelo. Selecione a animação que pretende apresentar no menu pendente.

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

## **Analisar glTF**

Uma excelente ferramenta para analisar ficheiros glTF é o [**glTF Sample Viewer**](https://github.khronos.org/glTF-Sample-Viewer-Release/). Esta ferramenta permite inspecionar canais e texturas, ver como reagem a diferentes ambientes de iluminação, pré-visualizar animações e muito mais! Ideal para modelos individuais.

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

Outra ferramenta útil é [**gltf.report/**](https://gltf.report/). Basta arrastar e largar os modelos no site para ver o conteúdo do pacote glTF e avaliar que partes do modelo podem ser otimizadas.

Esta ferramenta pode ser especialmente útil para ficheiros grandes que contenham vários modelos, texturas e animações. Por exemplo, ao ordenar as texturas por tamanho, pode identificar facilmente quais estão a consumir mais recursos.

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

## **Otimizar um glTF**

A ferramenta seguinte oferece algumas otimizações que tornam os modelos 3D mais leves e rápidos de transferir para os jogadores na sua cena.

[glTF pipeline](https://github.com/AnalyticalGraphicsInc/gltf-pipeline)

Entre outras coisas, converte o formato *.gltf* para *.glb*, um formato binário que ocupa muito menos espaço. Também coloca os ficheiros de textura fora do modelo 3D, permitindo utilizar a mesma textura em vários modelos.

{% hint style="warning" %}
**📔 Nota**: *.glb* O formato, por predefinição, inclui sempre as texturas no ficheiro. O motor não consegue reconhecer duas texturas incorporadas como sendo a mesma; têm de ser ficheiros externos que partilhem o mesmo hash.
{% endhint %}

## Ver também

As seguintes páginas também abordam tópicos relacionados com modelos 3D para Decentraland:

* [Meshes](https://docs.decentraland.org/creator/content-creator-pt/modelacao-3d-e-animacoes/meshes.md)
* [Materials](https://docs.decentraland.org/creator/content-creator-pt/modelacao-3d-e-animacoes/materials.md)
* [Textures](https://docs.decentraland.org/creator/content-creator-pt/modelacao-3d-e-animacoes/textures.md)
* [Colliders](https://docs.decentraland.org/creator/content-creator-pt/modelacao-3d-e-animacoes/colliders.md)
* [Animações](https://docs.decentraland.org/creator/content-creator-pt/modelacao-3d-e-animacoes/animations.md)
* [Recursos úteis](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/useful-resources.md): add-ons do Blender, bibliotecas de assets e ferramentas de IA para acelerar o seu fluxo de trabalho 3D


---

# 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/3d-models.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.
