# Essenciais do Scene Editor

A UI do Scene Editor está dividida em algumas secções diferentes, com finalidades diferentes.

![](/files/c8dd2a51324873abecc0ae9049b17f7d4d35ad40)

* **Canvas**: Manipule itens diretamente e veja como a sua cena fica.
* **Entity tree**: Contém uma lista de todos os itens na cena e a sua hierarquia.
* **Properties**: Apresenta detalhes sobre o item atualmente selecionado.
* **Resources**: Mostra os recursos que estão disponíveis para usar.

## Mover-se

Para te orientares no Scene Editor:

* Use **A** e **W** para aproximar ou afastar. Também podes usar a roda de scroll do rato, ou **+** e **-** teclas
* Use **S** e **D** para mover lateralmente.
* Use **Q** e **E** para mover para cima e para baixo.
* Clique no **Botão direito do rato** e arrasta para rodar a camera.
* Pressiona **Barra de espaços** para repor a camera na posição padrão
* Use **Botão esquerdo do rato** para clicar e selecionar itens e movê-los.

## Preview on mobile

O menu suspenso junto ao **Preview** botão tem uma **Show QR Code for Mobile** opção. Leia o código QR com um telemóvel na mesma rede Wi-Fi para abrir a sua cena no [aplicativo móvel do Decentraland](/creator/content-creator-pt/scenes-sdk7/criar-para-mobile/building-for-mobile.md). Esta é a forma recomendada de validar UI, controlos e desempenho para jogadores móveis. Veja [Preview on mobile](/creator/content-creator-pt/scenes-sdk7/criar-para-mobile/preview-on-mobile.md) para o guia completo.

## Definir o Ground

O Ground da cena pode usar várias texturas diferentes. Pode encontrá-las nos diferentes asset packs temáticos no menu de itens.

Itens do tipo **Ground** têm um ícone de balde de tinta. Se arrastar um destes para a sua cena, ele cobre todo o Ground da sua cena com cópias deste item.

![](/files/089d3bb893a57d8654449ce9d52221cc76d48ee3)

Também pode adicionar uma única cópia do item mantendo **Shift** enquanto arrasta o Ground para a cena.

![](/files/abbfe5d6ab620eee7a760c87877502449b4e3823)

A coleção de itens de Ground aparece no [entity tree](#the-entity-tree) dentro de uma pasta. Cada um deles está bloqueado, para evitar selecioná-lo acidentalmente. [Desative a seleção](#lock-or-hide-items) dos itens para os mover ou editar.

## Adicionar itens

Navega pelas categorias do asset pack temático no menu na parte inferior para encontrares diferentes itens que podes colocar na tua scene.

![](/files/35e9b0657f508fd751f266e8e0fc0b3faa1dc4e6)

Também pode usar a caixa de pesquisa. Note que, quando está dentro de um asset pack, a pesquisa só procura nesse asset pack.

Para colocar um item, clique e arraste-o a partir do menu do asset pack para uma localização na sua cena no canvas. Vai

![](/files/0ea973775af50a97c0a9a08b28dd462ceb5d477a)

{% hint style="info" %}
**💡 Dica**: As suas alterações são guardadas automaticamente sempre que adiciona, move ou edita propriedades de qualquer um dos itens na sua cena.
{% endhint %}

Para duplicar um item, selecione-o e prima **Ctrl + C** e depois **Ctrl + V**. Também pode encontrar o item no [entity tree](#the-entity-tree) para clicar com o botão direito e selecionar a opção **Duplicate**. O novo item ficará perfeitamente sobreposto ao original.

Para apagar um item da cena, selecione-o e prima a tecla *Delete* .

Veja [Import items](/creator/content-creator-pt/scene-editor/construir/import-items.md) para adicionar os seus próprios modelos 3D personalizados a partir do disco.

{% hint style="warning" %}
**📔 Nota**: Depois de arrastar um modelo 3D para a sua cena, ele é descarregado para a pasta do seu projeto e lá permanece mesmo que o apague. Estes modelos não utilizados podem aumentar o tamanho da sua cena.

Abra o **Local Assets** separador para apagar quaisquer modelos não utilizados.
{% endhint %}

## Posicionar itens

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

Clique com o **Botão esquerdo do rato** e arraste um item selecionado para o mover livremente pela cena ao nível do chão.

Também pode usar as ferramentas no menu superior:

![](/files/58a4372618e5315a7aac010b45917f208214ba56)

* **Move tool**: Clique e arraste cada seta para mover o item num único eixo de cada vez. Com esta ferramenta também pode posicionar coisas acima do nível do chão.
* **Rotate tool**: Clique e arraste cada um dos aros em torno do item para rodar o item num eixo de cada vez.
* **Scale tool**: Clique no centro do gizmo e arraste para dentro ou para fora para aumentar. Esta ferramenta também permite esticar um item num único eixo para alterar as suas proporções; para isso, clique num dos eixos do gizmo e arraste.

![](/files/c323852f1c1fc8ba8f2edfa3f9892b99549dc360)

Para ter maior precisão ao mover, rodar ou redimensionar um item, prima e mantenha premida a tecla *Shift* enquanto faz ajustes. Isto evitará o snapping à grelha.

Para alterar a granularidade do movimento e outras definições, clique na seta para baixo à direita das ferramentas. Estão disponíveis as seguintes definições:

* **Snap**: Ativar ou desativar a grelha. Quando desligado, o comportamento de **Shift** é invertido: por predefinição, não segue a grelha; segue-a se mantiver premida a tecla **Shift**.
  * **Position**: O tamanho dos incrementos de movimento em metros quando **Snap** está ativado.
  * **Rotation**: O tamanho dos incrementos de rotação em graus quando **Snap** está ativado.
  * **Scale**: O tamanho dos incrementos de escala quando **Snap** está ativado.
* **Align to world**: Refere-se ao eixo de movimento e rotação. Podem alinhar-se sempre com o mundo ou alinhar-se com a orientação do objeto. Se alinhados ao mundo, os eixos não mudam com a orientação do objeto.
  * **Position**: Os eixos da Move tool alinham-se com a direção para onde o objeto está virado? Ou com o mundo?
  * **Rotation**: Os eixos da Rotate tool alinham-se com a orientação do objeto, ou com o mundo?

Para selecionar vários itens ao mesmo tempo, prima e mantenha premida a tecla *Control* enquanto os seleciona. Depois pode mover, rodar, redimensionar, duplicar ou apagar todos eles numa única ação.

## Smart items

Smart items são itens especiais que vêm com comportamentos interativos incorporados. Veja [Smart items](/creator/content-creator-pt/scene-editor/interatividade/smart-items.md) para mais detalhes.

![](/files/14677133200a0eb3162651bf30be7390243e5dad)

## The entity tree

Na margem esquerda, verá uma estrutura em árvore com todas as entities na cena. Isto inclui todos os itens que adicionar, bem como algumas entities predefinidas.

{% hint style="info" %}
**💡 Dica**: Tudo numa cena é uma Entity; são os blocos de construção básicos das scenes. Itens são Entities que têm pelo menos uma posição e uma forma visível.
{% endhint %}

Em vez de selecionar um item clicando nele a partir da vista 3D da scene, pode selecioná-lo a partir da vista em árvore. Clique com o botão direito do rato numa entity para revelar mais opções: pode renomear, apagar ou duplicar; também pode criar uma child entity ou adicionar um component à entity.

As entities seguem uma hierarquia que pode ter tantos níveis quantos quiser. Estabeleça uma relação pai-filho entre duas entities arrastando um item para outro na árvore. Uma child entity herda a posição do pai, por isso, quando o pai se move, leva consigo quaisquer filhos. Isto pode ser prático ao construir uma scene; por exemplo, pode definir copos e pratos como filhos de uma mesa e depois mover a mesa sem precisar de reajustar mais nada. Também pode ser importante quando interage com a scene, para que os itens se movam em conjunto.

![](/files/6f94351c9de16817b2b250117ed95adb83a6e624)

Também pode minimizar ou expandir os filhos de uma entity para manter a vista simples; esta ação não tem efeito na scene.

### Entities especiais

A scene inclui algumas entities especiais que pode ver no entity tree.

* **Scene**: Isto refere-se à root entity; tudo o que adicionar na scene é um filho desta entity. Pode abri-la para ver [scene settings](#scene-settings).
* **Player**: O avatar do jogador. Pode adicionar components especiais a esta entity que podem alterar mecânicas de jogo. Também pode arrastar outras entities para que sejam filhos do avatar. Se uma entity for filha do avatar, a sua posição ficará fixa ao jogador. Use isto, por exemplo, para adicionar um marcador flutuante acima da cabeça do jogador, que o acompanha enquanto este se move.
* **Camera**: A câmera do jogador. Pode arrastar outras entities para que sejam filhos da câmera. Se uma entity for filha da câmera, a sua posição ficará fixa no ecrã. Use isto, por exemplo, para mostrar uma arma num jogo de tiro, que esteja sempre visível mesmo que o jogador aponte para cima ou para baixo.

### Bloquear ou ocultar itens

Pode ser útil por vezes bloquear um item, para evitar selecioná-lo e movê-lo acidentalmente. Isto é especialmente útil para itens de fundo, como o Ground, ou um edifício. Para bloquear um item, procure-o no entity tree à esquerda, passe o rato por cima e selecione o ícone de cadeado. Pode ativar ou desativar este comportamento através desse mesmo ícone.

Também pode querer ocultar um item que possa obstruir a sua vista enquanto coloca outros. Isto é especialmente útil para ocultar o telhado ou um edifício, enquanto trabalha nos interiores. Os itens ocultos só ficam ocultos na janela canvas do Scene Editor, não para os jogadores que entram na scene. Para ocultar um item, procure-o no entity tree à esquerda, passe o rato por cima e selecione o ícone de olho. Pode ativar ou desativar este comportamento através desse mesmo ícone.

![](/files/66e59555c81ef1c016bf7e80528b786262fa16ca)

## Painel de Properties

Selecione um item clicando nele no canvas ou no entity tree. Em seguida, verá os seus components apresentados no painel de Properties, à direita do ecrã. Diferentes itens têm different components, e cada um apresenta definições específicas.

![](/files/b4c596aec2dd51b665434b12256963c11a7f96ed)

A maioria dos itens não interativos tem os seguintes components:

* **Transform**: Define a posição, rotação e escala do item.
* **GLTF**: Que modelo 3D carregar.

[Smart items](/creator/content-creator-pt/scene-editor/interatividade/smart-items.md) pode incluir outros components.

Veja [Components](/creator/content-creator-pt/scene-editor/construir/components.md) para saber mais.

## Scene limitations

As scenes do Decentraland precisam de seguir certas limitações, para poderem ser executadas umas ao lado das outras. Existe um número máximo de materials, textures, triangles, etc., proporcional ao número de parcels na scene. Veja [limitações da scene](/creator/content-creator-pt/scenes-sdk7/otimizacao/scene-limitations.md) para mais detalhes.

Se o conteúdo da sua scene exceder algum destes limites, o Scene Editor irá notificá-lo no canto inferior esquerdo.

![](/files/7989f91402c99f16fc672e89cf726d961de757ce)

Pode expandir este menu para ver detalhes.

![](/files/fa35bd314d7fc94eacfa6e333c915e69fecf8298)

{% hint style="info" %}
**💡 Dica**: Se estiver a construir um Decentraland World, pode sempre aumentar o [tamanho da scene](#scene-sizes) para aumentar os seus limites.
{% endhint %}

O conteúdo numa scene do Decentraland também deve evitar ultrapassar os parcels vizinhos. Se alguma parte dos modelos na sua scene se estender para além dos limites, quando abrir a preview da scene verá essas partes cortadas. O Scene Editor marcará o modelo inteiro a vermelho, mas só precisa de se preocupar realmente com as partes do modelo que se estendem para além dos limites da scene.

![](/files/9336a69231a43ff30712d844b60fc18335de1199)

{% hint style="info" %}
**💡 Dica**: Se os modelos que pretende mostrar não couberem, pode querer aumentar o tamanho da sua scene. Veja [tamanho da scene](#scene-sizes) para ampliar a sua scene.
{% endhint %}

Mesmo que toda a geometria do modelo 3D caiba na sua scene, um modelo pode ser marcado a vermelho se a Bounding Box do modelo se estender para além da área. Se for esse o caso, pode ignorar os avisos, pois o modelo inteiro será apresentado corretamente. Saiba mais sobre [Bounding Boxes](https://github.com/decentraland/docs/blob/main/creator/scene-editor/3d-modeling/meshes.md#bounding-boxes).

## Limpar assets

Mantenha o seu projeto organizado removendo assets que já não são usados. Abra o **Local Assets** separador na parte inferior do ecrã e clique no ícone do pincel.

![](/files/952107babaf35e52e70cb742876bff3e19fc7c18)

Abre-se uma janela de diálogo com a lista de todos os assets na sua scene e destaca os que não são referenciados por nenhum item.

![](/files/4d26934588f2c379aaed186b8632069119651168)

Selecione os assets que pretende apagar usando as caixas de seleção e, depois, clique em **Remove Selected** para os remover permanentemente.

Apagar um item da scene não remove os seus ficheiros. Modelos, texturas ou sons importados permanecem no seu projeto até os limpar, por isso reveja periodicamente os assets não utilizados.

{% hint style="warning" %}
**Importante:** Se a sua scene contiver código que referencia assets, alguns assets em uso podem aparecer como não utilizados. Esta janela de diálogo apenas deteta assets referenciados por components na UI do Creator Hub. Apagar assets é irreversível — depois de clicar em **Remove Selected**, os ficheiros são apagados permanentemente.
{% endhint %}

## Definições da scene

Clique no ícone do \*lápis\*\* no canto superior direito do ecrã. Isto abre uma série de propriedades ao nível da scene para editar.

![](/files/ea4f5a0409da4681504556218c82ae7bcb3285b7)

Aqui pode configurar várias propriedades, incluindo o título e a miniatura, o tamanho da scene, a categoria da scene e a classificação etária, as localizações de spawn dos players e os alternadores de funcionalidades.

Veja [Scene Settings](/creator/content-creator-pt/scene-editor/configurar/scene-settings.md).

## Veja também

* Veja [Smart items](/creator/content-creator-pt/scene-editor/interatividade/smart-items.md) sobre como adicionar interatividade simples à tua scene.
* Veja [Combine com código](/creator/content-creator-pt/scene-editor/expandir-com-codigo/overview.md) para saber como editar o código da sua cena.
* Veja [Publicar scene](/creator/content-creator-pt/scene-editor/publicar/publish-scene.md) sobre como publicar a tua scene em Decentraland.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.decentraland.org/creator/content-creator-pt/scene-editor/comecar/scene-editor-essentials.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
