> 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/scene-editor/construir/import-items.md).

# Importar assets personalizados

Importe seus próprios modelos 3D, imagens, sons etc. para usar nas suas scenes.

Pode importar os seus próprios modelos 3D para o Scene Editor. Escolha modelos de uma vasta seleção de fontes gratuitas ou pagas na Internet, ou crie os seus próprios modelos personalizados. Também pode importar outros assets como imagens, sound files e vídeos.

{% embed url="<https://www.youtube.com/watch?v=UepXpH-k0EI>" %}

## Importar um asset

Para importar um modelo 3D, uma imagem, um sound file ou um vídeo para a sua scene a partir do disco local:

1. Arraste files diretamente para o bottom panel. Também pode clicar no **+ Import Assets** button no canto superior esquerdo do bottom panel e selecione a partir da sua unidade local.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-5948f0f1cc9c6dcf332a8b5398abf3a03bfa5a6b%2Fimport-assets.png?alt=media\&token=b446baae-3ec1-4e75-aa08-a4083655a06c)

2. Verifique a miniatura do modelo e clique em **Import**. Ao importar vários assets, use os botões de seta para percorrer cada asset.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-40d2f049b11f39a8ff535565ffb2c47f1366e916%2Fimport-confirmation.png?alt=media\&token=76a7552f-b366-4f71-8d48-d2dae1092a0e)

Agora pode encontrar o seu asset no **Local Assets** tab. Os assets estão organizados em folders por tipo: os modelos 3D aparecem na *assets/Models* folder, as imagens em *assets/Images*, os sound files em *assets/Audio*, e os vídeos em *assets/Video*.

Os itens dos asset packs gratuitos incorporados são guardados em *assets/asset-packs/*, e os itens personalizados criados no editor em *assets/custom/*. Scenes mais antigas podem ter imports do utilizador em *assets/scene/* em vez disso. Todos estes paths funcionam no código da sua scene; basta referenciar a folder em que o asset se encontra.

* Para modelos 3D, arraste os `.glb` ou `.gltf` files para o canvas para os adicionar como itens na sua scene.
* Também pode arrastar uma imagem, um som ou um video file para o canvas. O editor cria um item pronto a usar que já aponta para o seu file:

  * Um `.png`, `.jpg` ou `.jpeg` file torna-se um **Image** item.
  * Um `.mp3`, `.ogg` ou `.wav` file torna-se um item de som ambiente.
  * Um `.mp4` file torna-se um **Ecrã de vídeo** item.

  O novo item recebe o nome do file e vem com os mesmos components e settings que o item equivalente dos asset packs, por isso pode ajustá-lo imediatamente no inspector.
* Qualquer asset também pode ser arrastado para os fields de um item que já está na scene. Por exemplo, pode arrastar um `.mp3` file para o *Path* campo de um *Audio Source* component.

{% hint style="info" %}
**💡 Dica**: Também pode colar files diretamente na folder do projeto `assets` folder, a partir do Finder, Explorer ou de qualquer outro lugar. Eles aparecem no **Local Assets** tab por si só, pouco depois de a cópia terminar. Se não aparecerem, pressione o **Refresh** button ao lado do **Import Assets** botão.

<img src="https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-b1d21406bc228bc4e5def5af418231be27f50405%2Frefresh-assets.png?alt=media" alt="" data-size="original">
{% endhint %}

### Formatos suportados

#### Áudio

Os seguintes formatos de Audio são suportados:

* *.mp3*
* *.wav*
* *.ogg*

#### Image

Os seguintes formatos de imagem são suportados:

* *.png*
* *.jpg*
* *.jpeg*

#### Vídeo

Os seguintes formatos de vídeo são suportados:

* *.mp4*

#### Modelos 3D

Os seguintes formatos de modelos 3D são suportados:

* *.glTF*
* *.glb*

Ambos podem incluir ficheiros externos de imagem de textura, ou ficheiros binários externos (*.bin*) files.

Pode converter outros formatos para estes formatos com vários editores e ferramentas diferentes. Veja [modelação 3D](/creator/content-creator-pt/modelacao-3d-e-animacoes/3d-models.md) para recomendações e dicas.

Todos os materials nos modelos precisam de ser ou *basic material* ou *PBR*, e todas as textures precisam de ter tamanhos que sejam potências de dois (ex.: 256, 512). Veja [Limitações da Scene](/creator/content-creator-pt/scenes-sdk7/otimizacao/scene-limitations.md) para mais detalhes.

Cada file importado, de qualquer tipo, deve ocupar menos de 50 MB para ser utilizável numa scene. Files maiores não são suportados.

**Bibliotecas gratuitas para modelos 3D**

Em vez de construir os seus próprios modelos 3D, também os pode transferir de várias bibliotecas gratuitas ou pagas, ou gerá-los com ferramentas de IA. Veja [Recursos Úteis](/creator/content-creator-pt/scenes-sdk7/primeiros-passos/useful-resources.md) para uma lista de bibliotecas de assets recomendadas e ferramentas de IA generativa.

{% hint style="warning" %}
**📔 Observação**: Preste atenção às restrições de licença do conteúdo que descarrega.
{% endhint %}

Note que, em vários destes sites, pode escolher o formato em que descarrega o modelo. Escolha sempre *.glTF* ou *.glb* formato se estiver disponível. Se não estiver disponível, terá de os converter para *.glTF* ou *.glb* antes de os poder usar numa scene. Para isso, recomendamos importá-los para o Blender e exportá-los com um dos *.glTF* export add-ons.

### Colliders

Pode acontecer que, ao executar uma Preview, o player consiga atravessar os seus modelos 3D importados. É provável que isso aconteça porque os modelos não têm um *mesh de collider* para definir uma geometria de colisão. Veja [colliders](/creator/content-creator-pt/modelacao-3d-e-animacoes/colliders.md) para mais detalhes e instruções.

{% hint style="info" %}
**💡 Dica**: Em vez de editar o modelo para adicionar um *mesh de collider*, uma alternativa mais simples é adicionar um *Parede invisível* smart item com aproximadamente a mesma forma para ocupar o seu lugar.
{% endhint %}

### Animações

Se um modelo importado incluir animations, a primeira animation embebida no model será reproduzida em loop.

Note que não tem qualquer controlo sobre quando a animation começa ou para, ou sobre qual é reproduzida no caso de várias animations.

Se houver vários players na scene, podem estar a ver a animation desencontrada entre si.

Para alterar este comportamento, pode incluir um **Animator** componente. Veja [Torne qualquer item num smart item](/creator/content-creator-pt/scene-editor/interatividade/make-any-item-smart.md) para ferramentas sem código tornarem o seu item interativo.


---

# 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/scene-editor/construir/import-items.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.
