Essenciais do Scene Editor

Como usar o Scene Editor

A interface do Scene Editor é dividida em algumas seções diferentes, com propósitos distintos.

• Canvas: Manipule itens diretamente e veja como sua cena fica.

• Entity tree: Contém uma lista de todos os itens na cena e sua hierarquia.

• Propriedades: Exibe detalhes sobre o item atualmente selecionado.

• Recursos: Mostra recursos que estão disponíveis para uso.

Movimentação

Para se orientar no Scene Editor:

• Use A e W para mover para perto ou para longe. Você também pode usar a roda do mouse, ou + e - teclas

• Use S e D para mover-se para os lados.

• Use Q e E para mover-se para cima e para baixo.

• Clique no Botão direito do mouse e arraste para rotacionar a câmera.

• Pressione Barra de espaço para resetar a câmera de volta à posição padrão

• Use Botão esquerdo do mouse para clicar e selecionar itens e para movê-los.

Definir o Ground

O ground da cena pode usar várias texturas diferentes. Você pode encontrá-las nos diversos asset packs temáticos no menu de itens.

Itens do tipo Ground têm um ícone de balde de tinta. Se você arrastar um desses para sua cena, ele cobre todo o ground da sua cena com cópias desse item.

Você também pode adicionar uma única cópia do item segurando Shift enquanto arrasta o ground para a cena.

A coleção de itens de ground aparece na entity tree dentro de uma pasta. Cada um deles está travado, para evitar seleção acidental. Desmarque os itens para movê-los ou editá-los.

Adicionar itens

Navegue pelas categorias de asset packs temáticos no menu inferior para encontrar diferentes itens que você pode colocar na sua cena.

Você também pode usar a caixa de busca. Note que quando você está dentro de um asset pack, a busca procura apenas nesse asset pack.

Para colocar um item, clique e arraste-o do menu do asset pack para uma posição na sua cena no canvas. Você

💡 Tip: Suas alterações são salvas automaticamente sempre que você adiciona, move ou edita propriedades de qualquer um dos itens da sua cena.

Para duplicar um item, selecione-o e pressione Ctrl + C e então Ctrl + V. Você também pode encontrar o item no entity tree para clicar com o botão direito e selecionar a opção Duplicate. O novo item ficará perfeitamente sobreposto ao original.

Para excluir um item da cena, selecione-o e pressione a Excluir tecla.

Veja Importar itens para adicionar seus próprios modelos 3D personalizados a partir do disco.

📔 Nota: Depois de arrastar um modelo 3D para sua cena, ele é baixado para a pasta do seu projeto e permanece lá mesmo se você o excluir. Esses modelos não usados podem aumentar o tamanho da sua cena.

Abra o Local Assets aba para excluir quaisquer modelos não usados.

Posicionar itens

Clique com o Botão esquerdo do mouse e arraste um item selecionado para movê-lo livremente pela cena no nível do ground.

Você também pode usar as ferramentas no menu superior:

• Move tool: Clique e arraste cada seta para mover o item em um único eixo por vez. Com essa ferramenta você também pode posicionar objetos acima do nível do ground.

• Rotate tool: Clique e arraste cada um dos aros ao redor do item para rotacionar o item em um eixo por vez.

• Scale tool: Clique no centro do gizmo e arraste para dentro ou para fora para aumentar. Essa ferramenta também permite esticar um item em um único eixo para alterar suas proporções; para isso clique em um dos eixos do gizmo e arraste.

Para ter maior precisão ao mover, rotacionar ou escalar um item, pressione e segure a Shift tecla enquanto faz ajustes. Isso evitará o encaixe (snapping) na grade.

Para alterar a granularidade de movimento e outras configurações, clique na seta para baixo à direita das ferramentas. As seguintes configurações estão disponíveis:

• Snap: Ativa ou desativa a grade. Quando desativado, o comportamento de Shift é invertido: por padrão você não segue a grade; você segue se segurar Shift.

  • Position: O tamanho dos incrementos de movimento em metros quando Snap está ativado.

  • Rotação: O tamanho dos incrementos de rotação em graus quando Snap está ativado.

  • é também um: O tamanho dos incrementos de escala quando Snap está ativado.

• Alinhar ao mundo: Refere-se ao eixo de movimento e rotação. Eles podem alinhar-se sempre ao mundo, ou alinhar-se à orientação do objeto. Se alinhados ao world, os eixos não mudam com a orientação do objeto.

  • Position: O eixo da ferramenta Move alinha-se com a direção para a qual o objeto aponta? Ou com o world?

  • Rotação: O eixo da ferramenta Rotate alinha-se com a orientação do objeto, ou com o world?

Para selecionar múltiplos itens ao mesmo tempo, pressione e segure a Control tecla enquanto os seleciona. Você pode então mover, rotacionar, escalar, duplicar ou excluir todos eles em uma única ação.

Smart items

Smart items são itens especiais que vêm com comportamentos interativos incorporados. Veja Smart items para mais detalhes.

The entity tree

Na margem esquerda, você verá uma estrutura em árvore com todas as entities na cena. Isso inclui todos os itens que você adiciona, assim como algumas entities padrão.

💡 Tip: Tudo em uma cena é uma Entity; elas 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.

Ao invés de selecionar um item clicando nele na visão 3D da cena, você pode selecioná-lo pela visão em árvore. Clique com o botão direito do mouse em uma entity para revelar mais opções: você pode renomear, excluir, ou duplicar, também criar uma entity filha, ou adicionar um componente à entity.

Entities seguem uma hierarquia que pode ter quantos níveis você quiser. Estabeleça uma relação pai-filho entre duas entities arrastando um item sobre outro na árvore. Uma entity filha herda a posição do pai, então quando o pai se move, leva consigo as filhas. Isso pode ser prático ao construir uma cena; por exemplo, você pode definir copos e pratos como filhos de uma mesa, e então mover a mesa sem precisar reajustar mais nada. Também pode ser importante ao interagir com a cena, para que itens se movam juntos.

Você também pode minimizar ou expandir as filhas de uma entity para manter a visualização simples; essa ação não tem efeito na cena.

Entities especiais

A cena inclui um par de entities especiais que você pode ver na entity tree.

• Scene: Isto se refere à root entity; tudo o que você adicionar na cena é filho desta entity. Você pode abri-la para visualizar scene settings.

• Nidifique-o sob o: O avatar do jogador. Você pode adicionar componentes especiais a essa entity que podem alterar mecânicas de gameplay. Você também pode arrastar outras entities para serem filhas do avatar. Se uma entity for filha do avatar, sua posição ficará fixa ao jogador. Use isso, por exemplo, para adicionar um marcador flutuante sobre a cabeça do jogador, que o acompanha.

• para exibir a saúde do jogador sobre o avatar: A câmera do jogador. Você pode arrastar outras entities para serem filhas da câmera. Se uma entity for filha da câmera, sua posição ficará fixa na tela. Use isso, por exemplo, para exibir uma arma em um jogo de tiro, que está sempre visível mesmo se o jogador apontar para cima ou para baixo.

Travar ou esconder itens

Pode ser útil às vezes travar um item para evitar selecioná-lo e movê-lo acidentalmente. Isso é especialmente útil para itens de fundo, como o ground, ou um edifício. Para travar um item, localize-o na entity tree à esquerda, passe o cursor sobre ele e selecione o ícone de cadeado. Você pode alternar esse comportamento ligando e desligando esse mesmo ícone.

Você também pode querer esconder um item que possa obstruir sua visão enquanto posiciona outros. Isso é especialmente útil para esconder o teto ou um edifício enquanto trabalha no interior. Itens ocultos ficam apenas ocultos na janela do canvas do Scene Editor, não para jogadores que entram na cena. Para esconder um item, localize-o na entity tree à esquerda, passe o cursor sobre ele e selecione o ícone de olho. Você pode alternar esse comportamento ligando e desligando esse mesmo ícone.

Painel de propriedades

Selecione um item clicando nele no canvas ou na entity tree. Então você verá seus componentes exibidos no painel de propriedades, à direita da tela. Itens diferentes têm componentes diferentes, cada um exibindo configurações específicas.

A maioria dos itens não interativos possui os seguintes componentes:

• Transform: Define posição, rotação e escala do item.

• GLTF: Qual modelo 3D carregar.

Smart items pode incluir outros componentes.

Veja Components para saber mais.

Limitações da cena

As scenes do Decentraland precisam seguir certas limitações para poderem rodar uma ao lado da outra. Há um número máximo de materials, textures, triângulos, etc., que é proporcional ao número de parcels na cena. Veja limitações da cena para mais detalhes.

Se o conteúdo da sua cena exceder quaisquer desses limites, o Scene Editor notificará isso no canto inferior esquerdo.

Você pode expandir este menu para ver detalhes.

💡 Tip: Se você estiver construindo um Decentraland World, você sempre pode aumentar o scene size para aumentar seus limites.

O conteúdo em uma cena do Decentraland também deve evitar ultrapassar os parcels vizinhos. Se qualquer parte dos modelos na sua cena se estender além dos limites, quando você abrir a pré-visualização da cena verá essas partes cortadas. O Scene Editor marcará o modelo inteiro em vermelho, mas você deve realmente se preocupar apenas com as partes do modelo que se estendem além dos limites da cena.

💡 Tip: Se os modelos que você quer exibir não couberem, talvez você queira aumentar o tamanho da sua cena. Veja scene size para ampliar sua cena.

Mesmo que toda a geometria do modelo 3D caiba na sua cena, um modelo pode ser marcado em vermelho se a Bounding Box do modelo se estender além da área. Se este for o caso, você pode ignorar os avisos, pois o modelo inteiro será exibido corretamente. Saiba mais sobre Bounding Boxes.

Limpar assets

Mantenha seu projeto organizado removendo assets que não são mais usados. Abra a Local Assets aba na parte inferior da tela e clique no ícone de pincel.

Um diálogo se abre listando todos os assets na sua cena e destacando aqueles não referenciados por nenhum item.

Selecione os assets que deseja excluir usando as caixas de seleção, então clique em Remove Selected para removê-los permanentemente.

Excluir um item da cena não remove seus arquivos. Modelos importados, textures ou sons permanecem no seu projeto até que você os limpe, então revise periodicamente os assets não utilizados.

Importante: Se sua cena contém código que referencia assets, alguns assets em uso podem aparecer como não utilizados. Este diálogo detecta apenas assets referenciados por componentes na UI do Creator Hub. Excluir assets é irreversível—uma vez que você clicar em Remove Selected , os arquivos são permanentemente excluídos.

Configurações da cena

Clique no *ícone de lápis** no canto superior direito da tela. Isso abre uma série de propriedades em nível de cena para editar.

Aqui você pode configurar múltiplas propriedades incluindo título e miniatura, tamanho da cena, categoria da cena e classificação etária, locais de spawn dos jogadores e alternância de recursos.

Veja Scene Settings.

Veja também

• Veja Smart items para saber como adicionar interatividade simples à sua cena.

• Veja Combine with code para saber como editar o código da sua cena.

• Veja Publicar cena para saber como publicar sua cena no Decentraland.