> 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/about-editor.md).

# Editando Scenes

O Scene Editor é uma ferramenta visual simples que permite criar e publicar scenes do Decentraland.

O Creator Hub inclui um Scene Editor poderoso que combina uma interface simples sem código com a possibilidade de escrever código para personalizar ainda mais as suas cenas.

![Creator Hub](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-68c59578e17b2182dd5ab0e0fa11cb5ed7a65ec4%2Ficon-creator-hub.webp?alt=media)

Consulte [Instalação do Creator Hub](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/primeiros-passos/editor-installation.md) para começar.

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

## Criar uma cena

Para criar uma nova cena, abra o Creator Hub e clique na seta junto ao **Criar** botão. No menu pendente, selecione **Nova cena**.

![Menu pendente do botão Criar aberto, com as opções Nova cena e Importar cena.](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-68b6392ef998808cda1b392225cf7c5e75fef093%2Fcreate-dropdown.webp?alt=media)

Em seguida, ser-lhe-á pedido que atribua um nome à cena e escolha uma localização para a guardar. Para começar com um projeto que já tenha algum conteúdo, em vez de uma cena vazia, clique em **Modelos** no separador **Cenas** e escolha um.

Consulte [Gerir cenas](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/primeiros-passos/manage-scenes.md) para obter mais informações.

Quando a cena abrir, verá a árvore de entidades à esquerda, o canvas ao centro, as propriedades do item selecionado à direita e os pacotes de recursos na parte inferior.

![O Scene Editor com uma pequena cena aberta: a árvore de entidades à esquerda apresenta Player, Camera, Scene e alguns itens; o canvas mostra um chão relvado com um grelhador e uma fonte com um pássaro; e o painel de propriedades à direita apresenta os componentes Transform e GLTF do Bird Fountain selecionado.](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-83681e011189dbcb7eaacb2effe6e4bcb8ad2f0b%2Feditor-overview.webp?alt=media)

Consulte [Noções essenciais do Scene Editor](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/primeiros-passos/scene-editor-essentials.md) para conhecer cada secção.

## Deslocar-se

Para se orientar no Scene Editor:

* Use **W** e **S** para se aproximar ou afastar. Também pode usar a roda de deslocamento do rato ou as **+** e **-** teclas
* Use **A** e **D** para se deslocar para os lados.
* Use **Q** e **E** para se deslocar para cima e para baixo.
* Use o **botão esquerdo do rato** para clicar e selecionar itens e movê-los.
* Use o **botão direito do rato** e arraste para rodar a câmara.

{% hint style="info" %}
**💡 Sugestão**: Também pode rodar a câmara premindo **Alt** no Windows, ou **Option** no Mac enquanto arrasta. Isto é especialmente útil quando utiliza um trackpad em vez de um rato.
{% endhint %}

* Prima **a barra de espaços** para repor a câmara na posição predefinida

## Adicionar itens

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

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-bf56fe21f5916c77182abb3aa7b7ed99c67cde25%2Fasset-packs.webp?alt=media)

Para colocar um item, clique nele e arraste-o do menu de asset packs para uma localização na cena, no canvas.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-8561efddc6a8ddee20c36ede62504a8a5562c472%2Fdrop-item.webp?alt=media)

Clique num item selecionado e arraste-o para o mover livremente pela cena, ao nível do chão. Consulte [Noções essenciais do Scene Editor](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/primeiros-passos/scene-editor-essentials.md#position-items) para obter mais informações.

{% hint style="info" %}
**💡 Sugestão**: Alguns itens são **Smart items**, que incluem comportamentos interativos integrados. Consulte [Smart items](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/smart-items.md) para obter mais informações.
{% endhint %}

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-90308b58b54243d6359f739f40a4db710cdbd41a%2Fsmart-items.webp?alt=media)

Cada separador do painel de assets tem um campo de pesquisa. Em **Asset Packs**, um caminho de navegação e um botão para voltar mostram em que pack se encontra. Selecione um item para o ver no painel de pré-visualização à direita, juntamente com a descrição e as etiquetas. Consulte [Explorar e organizar os seus assets](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/construir/import-items.md#browse-and-organize-your-assets) para saber tudo o que pode fazer com o painel.

Para que a vista 3D ocupe toda a altura da janela, recolha o painel de assets com o botão de seta na extremidade direita da barra de separadores. O painel fica reduzido aos separadores, e o mesmo botão volta a expandi-lo até à altura anterior. Clicar em qualquer separador enquanto o painel está recolhido também o volta a abrir.

### Animações do Avatar

O pack **Avatar Animations** contém animações para o Avatar do jogador, em vez de itens para colocar: poses sentadas, pesca, transporte de uma caixa, dança e muito mais. Estão organizadas nos mesmos grupos **Actions**, **Sitting** e **Expressions** que os restantes.

Passe o cursor sobre um cartão para ver a animação. Arraste um cartão para a vista 3D para copiar o respetivo ficheiro para os assets locais da cena. Não é adicionada nenhuma Entity, porque uma animação não é algo que fique na cena: é reproduzida através de código. Consulte [Avatar Animations](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/avatares/avatar-animations.md).

Os cartões assinalados com o emblema **Built-in** funcionam de forma diferente. Estas animações já estão incluídas no Decentraland, por isso qualquer cena as pode reproduzir sem adicionar um ficheiro. Não é possível arrastá-las para a cena. Em vez disso, clique com o botão direito do rato num cartão e escolha **Copy name** para obter o nome a utilizar no seu código.

No separador **Local Assets** , o filtro **Avatar Animations** reúne os ficheiros de animação do seu projeto, juntamente com a pasta só de leitura **Built-in animations** que lista as animações que não precisam de ficheiro.

## Pré-visualização

Para testar a sua cena e vivenciá-la como um jogador, clique no botão **Play** no canto superior direito. Será aberta uma nova janela com o Decentraland Desktop Explorer, a executar apenas a sua cena. Aí, pode mover-se pela cena e interagir com os itens interativos.

{% hint style="warning" %}
**📔 Nota**: Se não o tiver instalado no seu computador, transfira o **Decentraland Launcher** em [Decentraland.org](https://decentraland.org).
{% endhint %}

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-10d53f215e20e8cf603bbf578d0b33df738d058f%2Fpreview-button.webp?alt=media)

Clique na seta ao lado do botão **Play** para abrir o menu **Play Options** e escolher se pretende pré-visualizar no cliente para computador, num navegador ou num telemóvel. Consulte [Pré-visualizar a sua cena](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/preview-scene.md) para ver a lista completa de opções disponíveis.

## Renderizador de cenas

O Scene Editor utiliza **Babylon** como renderizador predefinido para o canvas de edição. Pode mudar para **Bevy (experimental)**.

Para alterar o renderizador:

1. Clique no logótipo do Creator Hub no canto superior esquerdo e selecione **Definições**.
2. Aceda ao separador **EXPERIMENTAL** .
3. Ative **Enable Bevy Scene Renderer**.

![A caixa de diálogo App Preferences no separador EXPERIMENTAL, com a opção Enable Bevy Scene Renderer ativada.](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-f6ae19e4897ecd1a9bb3b0a61dcb4345e1635d87%2Fsettings-experimental.webp?alt=media)

O renderizador Bevy é um motor alternativo para o canvas de edição. Afeta o aspeto da cena durante a edição, mas não o aspeto que terá para os jogadores após a publicação.

Ao utilizar o renderizador Bevy, a barra de ferramentas inclui um menu suspenso do modo de câmara, botões para reproduzir e parar a cena no canvas, um controlo **Interact** (o ícone do comando) e um controlo **Mute scene audio** (o ícone do altifalante).

![A barra de ferramentas do editor com o renderizador Bevy: anular e refazer, as ferramentas de gizmo, um menu suspenso da câmara com a opção Free, botões para reproduzir e parar, o controlo Interact com o ícone do comando, a roda dentada Preferences e o botão Inspector.](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-3d22d467c89c0fdee1f54a4590ef12cc6687c20e%2Feditor-toolbar-bevy.webp?alt=media)

Utilize o controlo **Interact** para testar uma cena em execução diretamente no canvas do editor, sem abrir uma janela de pré-visualização separada. Assim, pode verificar rapidamente as interações sem parar a cena. Durante a interação, os smart items mostram no canvas as respetivas dicas ao passar o cursor, como a tecla a premir.

As cenas são abertas sem som no renderizador Bevy, para que o editor permaneça silencioso enquanto trabalha. O silêncio aplica-se a todas as [Audio Source](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/fundamentos-de-conteudo-3d/sounds.md), aos streams de áudio e aos vídeos da cena, bem como aos passos do Avatar, tanto durante a edição como enquanto a cena é executada no canvas. Clique no botão do altifalante, identificado como **Unmute scene audio**, para ouvir a cena. A sua escolha mantém-se enquanto a cena estiver aberta, mesmo que seja recarregada, e o som volta a estar desativado na próxima vez que a abrir. O botão só aparece com o renderizador Bevy, porque o renderizador Babylon não reproduz o áudio da cena.

O editor Bevy também carrega [itens personalizados](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/custom-items.md), apresenta marcadores de posição para assets danificados ou em falta e fornece mensagens de erro claras com ações para os resolver quando as dependências SDK da cena estão desatualizadas. O controlo da câmara na barra de ferramentas mostra **Free** ou **Player**, consoante o modo em que se encontra.

Na câmara **Free** :

* Voe com W, A, S e D e mova-se para cima e para baixo com Space, E e Q. O Avatar fica oculto, por isso estas teclas nunca o fazem andar. O Avatar aparece quando reproduz a cena ou muda para **Jogador** câmara.
* Faça zoom com a roda do rato ou com um trackpad. Um entalhe da roda faz tanto zoom como um clique nos botões de zoom da barra de ferramentas.
* A câmara não pode descer abaixo do chão.

Tal como no renderizador predefinido, mantenha premida a tecla **Shift** enquanto arrasta um gizmo para desativar o ajuste à grelha, ou ativá-lo se **Snap** estiver desativado. Consulte [Posicionar itens](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/primeiros-passos/scene-editor-essentials.md#position-items).

{% hint style="warning" %}
**📔 Nota**: o separador de métricas da cena não está disponível no Bevy. Execute uma pré-visualização da cena no cliente para computador ou dispositivo móvel e consulte as estatísticas aí.
{% endhint %}

{% hint style="warning" %}
**Nota:** O renderizador Bevy é experimental e poderá não suportar todas as funcionalidades de edição disponíveis no renderizador Babylon predefinido.
{% endhint %}

## Definições da cena

Clique no **ícone de lápis** no canto superior direito do ecrã. Isto abre várias propriedades da cena que pode editar, incluindo o nome, a miniatura, o tamanho da cena e muito mais.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-c9ae81ae9e27d05520ae060ebf5f2c74a5ba4663%2Fpencil-icon.webp?alt=media)

Consulte [Definições da cena](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/configurar/scene-settings.md) para obter mais detalhes.

## Publique a sua scene

Quando estiver satisfeito com a sua cena, prima o botão **Publicar** .

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-e4859de1ebc8d3bd6d76b348cfa66fcb4572a029%2Fpublish-options.webp?alt=media)

Consulte [Publicar cena](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/publicar/publish-scene.md) para obter mais detalhes.

## Ver também

* Consulte [Noções essenciais do Scene Editor](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/primeiros-passos/scene-editor-essentials.md) para obter mais detalhes sobre a interface do Scene Editor.
* Consulte [Itens inteligentes](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/smart-items.md) para saber como adicionar interatividade simples à sua cena.
* Consulte [Combinar com código](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/expandir-com-codigo/overview.md) para saber como editar o código da sua Scene.
* Consulte [Publicar cena](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/publicar/publish-scene.md) para saber como publicar a sua cena na 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/about-editor.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.
