For the complete documentation index, see llms.txt. This page is also available as Markdown.

Importar assets personalizados

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

Você pode importar seus próprios modelos 3D para o Scene Editor. Escolha modelos entre uma ampla seleção de fontes gratuitas ou pagas na internet, ou crie seus próprios modelos personalizados. Você também pode importar outros assets, como imagens, arquivos de som e vídeos.

Importar um asset

Para importar um modelo 3D, uma imagem, um arquivo de som ou um vídeo para sua scene a partir do seu disco local:

  1. Arraste os arquivos diretamente para o painel inferior. Você também pode clicar no + Import Assets botão no canto superior esquerdo do painel inferior e selecionar do seu disco local.


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



Agora você pode encontrar seu asset na aba Local Assets . Os assets são organizados em pastas por tipo: modelos 3D aparecem na pasta assets/Models , imagens em assets/Images, arquivos de som em assets/Audio, e vídeos em assets/Video.

Itens dos asset packs gratuitos integrados são armazenados em assets/asset-packs/, e itens personalizados criados no editor em assets/custom/. Scenes antigas podem ter imports de usuário em assets/scene/ em vez disso. Todos esses caminhos funcionam no código da sua scene, basta referenciar a pasta em que o asset está.

  • Para modelos 3D, arraste os .glb ou .gltf arquivos para o canvas para adicioná-los como itens na sua scene.

  • Outros tipos de assets, como imagens e arquivos de som, podem ser arrastados para os campos de um item. Por exemplo, você pode arrastar um .mp3 arquivo para o campo Path de um componente Audio Source .

💡 Dica: Você também pode colar arquivos diretamente na pasta do projeto. Depois disso, pressione o botão Refresh ao lado do botão Import Assets para ver os novos arquivos.



Formatos suportados

Audio

Os seguintes formatos de Audio são suportados:

  • .mp3

  • .wav

  • .ogg

Imagem

Os seguintes formatos de imagem são suportados:

  • .png

  • .jpg

  • .jpeg

Video

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

  • .mp4

Modelos 3D

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

  • .glTF

  • .glb

Ambos podem incluir arquivos externos de imagem de textura ou arquivos binários externos (.bin).

Você pode converter outros formatos para estes com vários editores e ferramentas diferentes. Veja modelagem 3D para recomendações e dicas.

Todos os materiais nos modelos precisam ser ou material básico ou PBR, e todas as texturas precisam estar em tamanhos que sejam potências de dois (ex.: 256, 512). Veja Limitações da scene para detalhes.

Cada arquivo importado, de qualquer tipo, deve ocupar menos de 50 MB para ser utilizável em uma scene. Arquivos maiores não são suportados.

Bibliotecas gratuitas de modelos 3D

Em vez de criar seus próprios modelos 3D, você também pode baixá-los de várias bibliotecas gratuitas ou pagas, ou gerá-los com ferramentas de IA. Veja Recursos Úteis para uma lista de bibliotecas de assets e ferramentas de IA generativa recomendadas.

Observe que, em vários desses sites, você pode escolher em que formato baixar o modelo. Sempre escolha .glTF ou .glb formato, se disponível. Se não estiver disponível, você deve convertê-los para .glTF ou .glb antes de poder usá-los em uma scene. Para isso, recomendamos importá-los para o Blender e exportá-los com um dos .glTF add-ons de exportação.

Colliders

Você pode perceber que, ao executar uma preview, o player consegue atravessar seus modelos 3D importados. Isso provavelmente acontece porque os modelos estão sem um collider mesh para definir uma geometria de colisão. Veja colliders para mais detalhes e instruções.

💡 Dica: Em vez de editar o modelo para adicionar um collider mesh, uma alternativa mais simples é adicionar um Invisible wall smart item com aproximadamente o mesmo formato para ocupar o seu lugar.

Animações

Se um modelo importado incluir animações, a primeira animação empacotada no modelo será reproduzida em loop.

Observe que você não tem nenhum controle sobre quando a animação começa ou para, nem sobre qual delas é reproduzida no caso de várias animações.

Se houver vários jogadores na scene, eles podem estar vendo a animação dessincronizada entre si.

Para alterar esse comportamento, você pode incluir um Animator componente. Veja Torne qualquer item smart para ferramentas sem código para tornar seu item interativo.

Atualizado