> 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-5367cb41c363e65a52e8beaf39559643751a7b1f%2F01-3d-essentials-banner%20\(1\).png?alt=media) Ao importar modelos 3D para Decentraland, é importante garantir que estejam em formato glTF. Esses modelos podem incluir uma variedade de recursos suportados. Esta seção trata de como torná-los compatíveis com Decentraland e de seguir as melhores 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 o ajudar a editar e exportar modelos 3D, wearables e Emotes. {% endhint %} Observe que todos os modelos, shaders e texturas devem estar em conformidade com o [**limitações da scene**](https://docs.decentraland.org/creator/scenes-sdk7/optimizing/scene-limitations/). ## **Formatos de Modelo 3D Suportados** Todos os modelos 3D em Decentraland devem estar em formato glTF. [**glTF**](https://www.khronos.org/gltf) (GL Transmission Format) é um projeto aberto da Khronos que fornece um formato comum e extensível para ativos 3D, eficiente e altamente interoperável com tecnologias web modernas. Os modelos glTF podem ter uma *.gltf* ou um *.glb* extensão. Os arquivos glTF são legíveis por humanos; você pode abrir um em um editor de texto e lê-lo como um arquivo JSON. Isso é útil, por exemplo, para verificar se as animações estão corretamente anexadas e para conferir seus nomes. Os arquivos glb são binários, então não são legíveis, mas são consideravelmente menores em tamanho, o que é bom para o desempenho da cena. Recomendamos usar *.gltf* enquanto você estiver trabalhando em uma cena, mas depois mudar para *.glb* na hora de enviá-lo. Os seguintes aspectos de um modelo 3D podem ser incorporados em um *glTF* arquivo ou referenciados externamente: * As texturas podem ser incorporadas ou referenciadas a partir de um arquivo de imagem externo. * Os dados binários sobre geometria, animações e outros aspectos relacionados ao buffer do modelo podem ser incorporados ou referenciados a partir de um *.bin* arquivo. {% hint style="warning" %} **📔 Observação**: Animações *devem* ser incorporados dentro do *glTF* arquivo para usar em Decentraland. Além disso, cada modelo pode ter apenas 1 mapa UV. {% endhint %} ## **Por que Usamos glTF** Usamos glTF porque ele fornece um conjunto poderoso de recursos que inclui: * 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âmeras (que podem ser usadas em desenvolvimentos futuros). Comparado a *COLLADA*, os recursos suportados são muito semelhantes. No entanto, como o glTF se concentra em fornecer um “formato de transmissão” em vez de um formato de editor, ele é mais interoperável com tecnologias web. ## **Exportar e Converter glTF** ### **Exportar para glTF a partir do Blender** O Blender tem um exportador nativo de glTF. Para exportar, selecione os modelos que você quer que estejam contidos no arquivo .glb e depois vá em File - Export - glTF 2.0 ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-30e38513ce59831ac027cf1787af061bfdb7c267%2F02-export-glt-from-blender%20\(1\).png?alt=media) ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-86db9dd94033fbf82446265353dce37915351452%2F03-exporting-options%20\(1\).png?alt=media) *No painel lateral, marque “Selected Objects” caso queira exportar apenas os objetos selecionados na cena. Além disso, no dropdown Mesh selecione Apply Modifiers (se houver), e então clique em Export.* ### **Exportar para glTF a partir do 3D Studio Max** O 3D Studio Max não suporta exportação para glTF por padrão, mas você pode instalar um plugin para habilitá-la. 1. Baixe o plugin em [este link](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 arquivos glTF usando o plugin seguindo [estas instruções](http://doc.babylonjs.com/resources/3dsmax_to_gltf). ### **Exportar para glTF a partir do Maya** O Maya não suporta exportação para glTF por padrão, mas você pode instalar um plugin para habilitá-la. 1. Instale o plugin seguindo [estas instruções](http://doc.babylonjs.com/resources/maya). 2. Exporte arquivos glTF usando o plugin seguindo [estas instruções](http://doc.babylonjs.com/resources/maya_to_gltf#pbr-materials). {% hint style="warning" %} **📔 Observação**: Como alternativa, você pode tentar [este outro plugin](https://github.com/WonderMediaProductions/Maya2glTF) também. {% endhint %} ### **Exportar para glTF a partir do Unity** O Unity não suporta exportação para glTF por padrão, mas você pode instalar um plugin para habilitá-la. Baixe o plugin em [este link](https://github.com/sketchfab/Unity-glTF-Exporter). {% hint style="warning" %} **📔 Observação**: Como alternativa, você pode tentar [este outro plugin](https://assetstore.unity.com/packages/tools/utilities/collada-exporter-for-unity2017-99793) também. {% endhint %} ### **Exportar para glTF a partir do SketchUp** O SketchUp não suporta exportação para glTF por padrão, mas você pode instalar um plugin para habilitá-la. Baixe o plugin em [este link](https://extensions.sketchup.com/en/content/gltf-exporter). ### **Converter FBX em glTF** *.fbx* é um padrão muito popular para modelos 3D. Ele não é suportado por nossa engine, mas você pode facilmente exportar um *.fbx* modelo *.gltf* para o formato. Recomendamos usar estas ferramentas: * [**Blender**](https://www.blender.org/download/): Uma maneira fácil de converter .fbx em glTF é importar o .fbx para uma cena usando o Blender e depois exportá-lo a partir daí. * [**Ferramenta CLI do Facebook**](https://github.com/facebookincubator/FBX2glTF): esta é a alternativa mais robusta, mas requer o uso da linha de comando. * [**Blackthread**](https://blackthread.io/gltf-converter): esta é a ferramenta baseada na web mais completa. Menos robusta que a CLI, mas muito mais fácil de usar. * [**Modelconverter**](https://modelconverter.com/convert.html): Outra ferramenta baseada na web fácil de usar. ## **Visualizar um modelo glTF** Uma maneira rápida e fácil de visualizar o conteúdo de um modelo glTF antes de importá-lo para uma cena é usar o [**Babylon.js Sandbox**](https://sandbox.babylonjs.com/). Basta arrastar e soltar o arquivo glTF (e seu *.bin* arquivo, se aplicável) no canvas para visualizar o modelo. No sandbox, você também pode visualizar as animações incorporadas no modelo, selecionando qual exibir escolhendo-a em um menu suspenso. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-bf9bd765a4a99705f7649909c74acd6dddb860d1%2F04-preview-gltf%20\(1\).png?alt=media) ## **Analisar glTF** Uma ótima ferramenta para analisar seus glTFs é usar o [**glTF Sample Viewer**](https://github.khronos.org/glTF-Sample-Viewer-Release/). Esta ferramenta permite inspecionar canais, texturas, a resposta a diferentes ambientes de luz, 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-9d1b28696f55191432bb5c9c315c7497f91b970c%2F05-gltf-sample-viewer%20\(1\).png?alt=media) Outra ferramenta útil é o [**gltf.report/**](https://gltf.report/). Basta arrastar e soltar seus modelos no site para visualizar o conteúdo do pacote glTF e avaliar quais partes do modelo podem ser otimizadas. Essa ferramenta pode ser especialmente útil para arquivos grandes contendo múltiplos modelos, texturas e animações. Por exemplo, ao organizar texturas por tamanho, você pode identificar facilmente quais texturas estão consumindo mais recursos. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-ca94129743df645c2e758d463f7837dea3dd03d0%2F05-gltf-report%20\(1\).png?alt=media) ## **Otimizar um glTF** A ferramenta a seguir oferece algumas otimizações que tornarão os modelos 3D mais leves e mais rápidos para os jogadores baixarem na sua cena. [glTF pipeline](https://github.com/AnalyticalGraphicsInc/gltf-pipeline) Entre outras coisas, ela converte *.gltf* o formato em *.glb*, que é binário e, portanto, ocupa muito menos espaço. Ela também coloca os arquivos de textura fora do modelo 3D, o que permite usar a mesma textura em vários modelos. {% hint style="warning" %} **📔 Observação**: *.glb* O formato, por padrão, sempre tem texturas incorporadas no arquivo. O Engine não consegue reconhecer duas texturas incorporadas como sendo a mesma; elas precisam ser arquivos externos que compartilhem o mesmo hash. {% endhint %} ## Ver também As páginas a seguir também abordam tópicos relacionados a modelos 3D para Decentraland: * [Meshes](/creator/content-creator-pt/modelacao-3d-e-animacoes/meshes.md) * [Materiais](/creator/content-creator-pt/modelacao-3d-e-animacoes/materials.md) * [Texturas](/creator/content-creator-pt/modelacao-3d-e-animacoes/textures.md) * [Colliders](/creator/content-creator-pt/modelacao-3d-e-animacoes/colliders.md) * [Animações](/creator/content-creator-pt/modelacao-3d-e-animacoes/animations.md) * [Recursos Úteis](/creator/content-creator-pt/scenes-sdk7/primeiros-passos/useful-resources.md): complementos do Blender, bibliotecas de assets e ferramentas de IA para acelerar 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=&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.