> 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/primeiros-passos/scene-editor-essentials.md). # Essenciais do Scene Editor Como usar o Scene Editor A UI do Scene Editor é dividida em algumas seções diferentes, com propósitos diferentes. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-80eb7f0f2596e0dde68a93113665f40c1157ea1e%2Feditor-layout.png?alt=media\&token=88a9399c-d2d6-421c-8400-82905670e298) * **Canvas**: Manipule os 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 selecionado no momento. * **Recursos**: Mostra os recursos disponíveis para uso. ## Como se locomover Para se orientar no Scene Editor: * Use **W** e **S** para aproximar ou afastar. Você também pode usar a roda de rolagem do mouse ou **+** e **-** teclas * Use **Um** e **D** para se mover lateralmente. * Use **Q** e **E** para mover para cima e para baixo. * Clique no **Botão direito do mouse** e arraste para girar a câmera. * Pressione **Barra de espaço** para redefinir a câmera para a posição padrão * Use **Botão esquerdo do mouse** para clicar, selecionar itens e movê-los pela cena. ## Prévia no mobile O **Play Options** menu ao lado do **Play** botão tem uma **Mostrar código QR para mobile** opção. Escaneie o código QR com um telefone na mesma rede Wi-Fi para abrir sua cena no [aplicativo móvel do Decentraland](/creator/content-creator-pt/criar-para-mobile/cliente-movel/overview.md). Esta é a maneira recomendada de validar UI, controles e desempenho para jogadores móveis. Veja [Prévia no mobile](/creator/content-creator-pt/criar-para-mobile/desenvolver/preview-on-mobile.md) para o guia completo. ## Set the Ground O Ground da cena pode usar várias texturas diferentes. Você 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 você arrastar um desses para a sua cena, ele cobre todo o Ground da sua cena com cópias desse item. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-8d952452b5bf6475868c3392c6f0472690587580%2Fground.png?alt=media\&token=4c0c854a-72d9-4dc8-853d-7ef652c50cc3) Você também pode adicionar uma única cópia do item mantendo **Shift** enquanto arrasta o Ground para a cena. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-069d473c6ec47b6f54ae95ee9d91bb27c2e81665%2Fground-entities.png?alt=media\&token=46274493-559b-40d7-858a-181664dfe9b9) A coleção de itens de Ground aparece na [entity tree](#the-entity-tree) dentro de uma pasta. Cada um deles está bloqueado, para evitar selecioná-los acidentalmente. [Desative](#lock-or-hide-items) os itens para movê-los ou editá-los. ## Adicionar itens Navegue pelas categorias temáticas dos asset packs no menu na parte inferior para encontrar diferentes itens que você pode colocar na sua cena. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-533d4553c3a38522cdd08dce8040a08c038699e7%2Fasset-packs.png?alt=media\&token=99210953-9718-4fa7-895c-317c45f74d6e) Você também pode usar a caixa de pesquisa. Observe que, quando você estiver dentro de um asset pack, a pesquisa procura apenas nesse asset pack. Para colocar um item, clique e arraste-o do menu do asset pack para um local na sua cena no canvas. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-30237e6006c76b69f5cfe737e543875987ed67b8%2Fdrop-item.gif?alt=media\&token=5d263b79-cd82-4436-bc8e-3a07e68df559) {% hint style="info" %} **💡 Dica**: Suas alterações são salvas automaticamente sempre que você adiciona, move ou edita as propriedades de qualquer item na sua cena. {% endhint %} Para duplicar um item, selecione-o e pressione **Ctrl + C** e depois em **Ctrl + V**. Você também pode encontrar o item na [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 excluir um item da cena, selecione-o e pressione a tecla *Delete* . Veja [Importar itens](/creator/content-creator-pt/scene-editor/construir/import-items.md) para adicionar seus próprios modelos 3D personalizados do disco. {% hint style="warning" %} **📔 Observação**: Depois que você arrastar um modelo 3D para a sua cena, ele é baixado para a pasta do 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. {% endhint %} ## Posicionar itens {% embed url="" %} 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: ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-4b95b511c15b05517739d57d024d0f0b23007782%2Fgizmos.png?alt=media\&token=72f1d0d2-cd0c-44dd-a3a0-bc32997577d3) * **Move tool**: Clique e arraste cada seta para mover o item em um eixo de cada vez. Com esta ferramenta, você também pode posicionar coisas acima do nível do Ground. * **Rotate tool**: Clique e arraste cada um dos anéis ao redor do item para girá-lo em um 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 em um único eixo para alterar suas proporções; para isso, clique em um dos eixos do gizmo e arraste. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-dfe9363a387a120ae140da69d76e1c66dc5d5399%2Fmove-items.gif?alt=media\&token=513ffbb0-992c-4a68-b2e8-8971081d1b57) Para ter maior precisão ao mover, girar ou dimensionar um item, pressione e segure a tecla *Shift* enquanto faz os ajustes. Isso evitará o snap à grade. Para alterar a granularidade do 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 desativada, o comportamento de **Shift** é invertido: você não segue a grade por padrão, você segue se mantiver **Shift**. * **Posição**: 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. * **Escala**: O tamanho dos incrementos de escala quando **Snap** está ativado. * **Align to world**: Uma única caixa de seleção que se refere ao eixo usado pelos gizmos. Quando marcada, os eixos das ferramentas Move e Rotate sempre se alinham com o mundo e não mudam com a orientação do objeto. Quando desmarcada, eles se alinham com a orientação do objeto. Para selecionar vários itens ao mesmo tempo, pressione e segure a tecla *Controlar* enquanto os seleciona. Depois, você pode mover, girar, dimensionar, duplicar ou excluir todos eles em uma única ação. ### Digite uma quantidade exata Quando arrastar não for preciso o suficiente, digite a quantidade: 1. Pressione uma tecla da ferramenta: **M** ou **G** para mover, **R** para girar, **X** para dimensionar. 2. Pressione **X**, **Y** ou **Z** para escolher um eixo. Dimensionar não precisa de um: sem um eixo, ele dimensiona todos os eixos pelo mesmo fator. 3. Digite o número. Use **.** para decimais, e **-** para alternar entre positivo e negativo. 4. Pressione **Enter** para aplicar, ou **Esc** para cancelar. **Backspace** apaga o que você digitou. Um chip na parte inferior do canvas mostra a entrada enquanto você a digita, informa o que ainda falta e confirma o que foi aplicado. Alguns exemplos: * **R** **X** **1** **5** **Enter** gira a seleção em 15 graus ao redor do X. * **X** **2** **Enter** torna a seleção duas vezes maior. * **M** **Y** **-** **3** **Enter** move-a 3 metros para baixo. Algumas coisas que vale a pena saber: * A quantidade é sempre relativa à posição atual da seleção, não a uma coordenada absoluta. * Os valores digitados ignoram a snap grid. * Com vários itens selecionados, todos eles se movem, giram ou dimensionam em torno do centro compartilhado, como um único passo de desfazer. * Ao pressionar **M**, **G** ou **R** uma segunda vez, ele ainda desliga seu gizmo. **X** não, porque enquanto você digita isso significa o eixo X. {% hint style="info" %} **💡 Dica**: O ícone de teclado no canto inferior direito do canvas abre a lista completa de atalhos. {% endhint %} ## Smart items Os Smart items são itens especiais que vêm com comportamentos interativos integrados. Veja [Smart items](/creator/content-creator-pt/scene-editor/interatividade/smart-items.md) para mais detalhes. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-f368bfdf7894d18f29875528bdd91cf8429e70b3%2Fsmart-items.jpg?alt=media\&token=8f5f5b70-db16-4d37-b41c-4ee0eafe87e4) ## A 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, bem como algumas entities padrão. {% hint style="info" %} **💡 Dica**: Tudo em uma cena é uma Entity; elas são os blocos básicos das cenas. 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 na visualização 3D da cena, você pode selecioná-lo na visualizaçã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 pode criar uma entity filha, transformá-la em um item personalizado ou adicionar um component à entity. ![A entity tree com o menu de clique direito aberto na entity Bird Fountain, listando Rename, Add child, Duplicate, Delete, Create Custom Item e Add component.](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-7e0e6082ae86443a0412c2f58c6bf75e94a754c4%2Fentity-tree-context-menu.png?alt=media\&token=45339b1e-d4df-4c63-aa89-408cda1c50e6) ### Pesquisando na entity tree Uma caixa de pesquisa no topo da entity tree permite encontrar entities pelo nome. Digite parte do nome de uma entity e a tree filtra para mostrar apenas as entities correspondentes e sua hierarquia de pais, para que você possa ver onde cada correspondência está na tree. A pesquisa não diferencia maiúsculas de minúsculas. As entities pais das correspondências são expandidas automaticamente para que cada resultado fique visível. Pressione **Escape** ou clique no ícone de limpar para remover o filtro e voltar à tree completa. Se uma entity estiver selecionada, ao limpar a pesquisa você volta para a entity selecionada, para não perder o ponto em que estava. ![A entity tree filtrada pelo termo de pesquisa fount: apenas as entities Camera, Scene e Bird Fountain permanecem visíveis, com a entity pai Scene expandida para mostrar a correspondência.](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-6a4ecf3021b21dc6e02f1bedabea0aa348d6de18%2Fentity-tree-search.png?alt=media\&token=1b43f8ba-3dbc-4d14-836c-87c27cddc493) ### Hierarquia de entities As 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 tree. Uma entity filha herda a posição da entity pai; assim, quando a entity pai se move, ela leva quaisquer filhas junto. Isso pode ser prático ao construir uma cena; por exemplo, você pode definir óculos e pratos como filhas 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 os itens se movam juntos. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a184c50ad6e26c4a37418ff8c28de2067ad3b02a%2Fitem-hierarchy.png?alt=media\&token=ac266788-86d2-4793-bb76-073ea66b0439) 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 algumas entities especiais que você pode ver na entity tree. * **Scene**: Isso se refere à root entity; tudo o que você adicionar na cena é filho dessa entity. Você pode abri-la para ver [settings da scene](#scene-settings). * **Player**: O avatar do jogador. Você pode adicionar components 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á fixada ao jogador. Use isso, por exemplo, para adicionar um marcador flutuante sobre a cabeça do jogador, que o acompanha por onde ele for. * **Camera**: 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á fixada na tela. Use isso, por exemplo, para exibir uma arma em um jogo de tiro, que esteja sempre visível mesmo se o jogador olhar para cima ou para baixo. ### Bloquear ou esconder itens Você pode achar útil às vezes bloquear um item para evitar selecioná-lo e movê-lo acidentalmente. Isso é especialmente útil para itens de fundo, como o Ground ou um prédio. Para bloquear um item, procure-o na entity tree à esquerda, passe o mouse sobre ele e selecione o ícone de cadeado. Você pode ativar e desativar esse comportamento usando o 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 telhado ou um prédio enquanto trabalha nos interiores. Itens ocultos ficam ocultos apenas na janela canvas do Scene Editor, não para jogadores que entram na cena. Para esconder um item, procure-o na entity tree à esquerda, passe o mouse sobre ele e selecione o ícone de olho. Você pode ativar e desativar esse comportamento usando o mesmo ícone. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-fb3144eb3c62fc5b632f69e8944f3392e91d8d0e%2Fhide-lock-item.png?alt=media\&token=648fe2be-673c-4890-ac27-c646bac6c28a) ## Painel de propriedades Selecione um item clicando nele no canvas ou na entity tree. Então você verá seus components exibidos no painel de propriedades, à direita da tela. Itens diferentes têm components diferentes, e cada um exibe configurações específicas. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-c9c570da87ad3e8ba629f2a0c0b64ea2587a34ac%2Fcomponents-in-editor.png?alt=media\&token=916b4ef9-6a25-4cc9-beaa-553b6ebed067) A maioria dos itens não interativos tem os seguintes components: * **Transform**: Define a posição, rotação e escala do item. * **GLTF**: Qual modelo 3D carregar. [Smart items](/creator/content-creator-pt/scene-editor/interatividade/smart-items.md) pode incluir outros components. Veja [Componentes](/creator/content-creator-pt/scene-editor/construir/components.md) para saber mais. ## Limitações da Scene As cenas de Decentraland precisam seguir certas limitações para poder executá-las lado a lado. Há um número máximo de materials, textures, triangles etc., proporcional ao número de parcels na cena. Veja [limitações da scene](/creator/content-creator-pt/scenes-sdk7/otimizacao/scene-limitations.md) para mais detalhes. Se o conteúdo da sua cena exceder qualquer um desses limites, o Scene Editor o notificará no canto inferior esquerdo. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-88f68a93b0cfcb7f8c48270f31ba7137655ee2e1%2Ftriangle-limit1.png?alt=media\&token=6ba1a8ad-a1e4-472b-b9ca-a3b9d1aab9d8) Você pode expandir este menu para ver detalhes. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-aebaad725f1d9397552b2fb36a318eec91589b9c%2Ftriangle-limit2.png?alt=media\&token=65973f60-8eda-4193-9a81-f5a42d4c5032) {% hint style="info" %} **💡 Dica**: Se você estiver construindo um Decentraland World, você sempre pode aumentar o [tamanho da cena](/creator/content-creator-pt/scene-editor/configurar/scene-settings.md#layout) para aumentar seus limites. {% endhint %} O conteúdo em uma cena de Decentraland também deve evitar se espalhar para parcels vizinhos. Se qualquer parte dos modelos da sua cena ultrapassar os limites, quando você abrir a preview da cena verá essas partes cortadas. O Scene Editor marcará todo o modelo em vermelho, mas você realmente só precisa se preocupar com as partes do modelo que ultrapassam os limites da cena. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-5eb877a01228cb5624728411a6bb06d3e0cfa194%2Fout-of-bounds.png?alt=media\&token=8c34ee0f-332c-4f3d-ad72-7a7a8ee04af6) {% hint style="info" %} **💡 Dica**: Se os modelos que você quer exibir não couberem, talvez você queira aumentar o tamanho da sua cena. Veja [tamanho da cena](/creator/content-creator-pt/scene-editor/configurar/scene-settings.md#layout) para ampliar sua cena. {% endhint %} Mesmo que toda a geometria do modelo 3D caiba na sua cena, um modelo pode ser marcado em vermelho se o Bounding Box do modelo ultrapassar a área. Se for esse o caso, você pode ignorar os avisos, pois o modelo inteiro será exibido corretamente. Saiba mais sobre [Bounding Boxes](/creator/content-creator-pt/modelacao-3d-e-animacoes/meshes.md#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. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-01a4d7c5065b98293092e6d7bad815766a62af29%2Fbrush-icon.png?alt=media\&token=834078d5-f08b-44a9-9dd3-413d66ee9a3f) Uma caixa de diálogo é aberta listando todos os assets na sua cena e destacando aqueles que não são referenciados por nenhum item. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-496245893e408c868cc77aa4989002aa713c8e71%2Fclean-up-assets.png?alt=media\&token=9ef69edf-2d70-4bec-96c3-dbef10420763) Selecione os assets que deseja excluir usando as caixas de seleção e depois clique em **Remove Selected** para removê-los permanentemente. Excluir um item da cena não remove seus arquivos. Modelos, textures ou sounds importados permanecem no seu projeto até que você os limpe, então revise periodicamente os assets não usados. {% hint style="warning" %} **Importante:** Se sua cena contiver código que referencia assets, alguns assets em uso podem aparecer como não usados. Esta caixa de diálogo detecta apenas assets referenciados por components na UI do Creator Hub. Depois que você clicar em **Remove Selected**, os arquivos são excluídos da pasta do projeto; esta ação é permanente e não pode ser desfeita. {% endhint %} ## Configurações da cena Clique no **ícone de lápis** no canto superior direito da tela. Isso abre uma série de propriedades ao nível da cena para editar. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-d2147688ebde75948ba26a9fbe1261f9abdc66c7%2Fpencil-icon.png?alt=media\&token=21677d31-8915-4809-a60a-6674c7497d98) Aqui você pode configurar várias propriedades, incluindo título e miniatura, tamanho da cena, categoria da cena e classificação etária, localizações de spawn do jogador e alternadores de recursos. Veja [Scene Settings](/creator/content-creator-pt/scene-editor/configurar/scene-settings.md). ## Ver também * Veja [Smart items](/creator/content-creator-pt/scene-editor/interatividade/smart-items.md) para ver como adicionar interatividade simples à sua cena. * Veja [Combinar com código](/creator/content-creator-pt/scene-editor/expandir-com-codigo/overview.md) para saber como editar o código da sua Scene. * Veja [Publicar cena](/creator/content-creator-pt/scene-editor/publicar/publish-scene.md) para ver como publicar sua cena no Decentraland. --- # 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/primeiros-passos/scene-editor-essentials.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.