> 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/scenes-sdk7/primeiros-passos/preview-scene.md).

# Pré-visualize a sua cena

O que pode ver na pré-visualização de uma cena

Depois de [criar uma nova scene](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/sdk-101.md#create-your-first-scene) ou transferir um [exemplo de scene](https://docs.decentraland.org/creator/content-creator-pt/tutoriais-e-exemplos/examples.md) pode pré-visualizá-la localmente.

## Utilizar o Scene Editor no Creator Hub

Certifique-se de que [instalou o Creator Hub](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/primeiros-passos/editor-installation.md).

1. Abra o seu projeto de scene.
2. Clique no botão **Play** no canto superior direito. Será aberta uma nova janela com o Decentraland Desktop Explorer, a executar apenas a sua scene. Aí, pode percorrer a scene e interagir com os Smart items.

![](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)

### Escolher onde pré-visualizar

Clique na seta junto ao botão **Play** para abrir o menu **Play Options** . No painel principal, escolha o que executa a sua scene:

* **Desktop Client**: abre a pré-visualização no Decentraland Desktop Explorer. Esta é a opção predefinida.
* **Web (Bevy)**: abre a pré-visualização no seu browser, utilizando o cliente Bevy Web. Equivale à `--web` flag da CLI.
* **Show QR Code for Mobile**: apresenta um código QR que abre a pré-visualização da sua scene na [aplicação móvel Decentraland](https://docs.decentraland.org/creator/content-creator-pt/criar-para-mobile/cliente-movel/overview.md). Leia o código com um telemóvel ligado à mesma rede Wi-Fi que o computador. Clique na área escura à volta da janela pop-up para a fechar. Consulte [Pré-visualizar em dispositivos móveis](https://docs.decentraland.org/creator/content-creator-pt/criar-para-mobile/desenvolver/preview-on-mobile.md) para obter mais informações.

### Opções do Desktop Client

Selecione **Desktop Client** no menu **Play Options** e, em seguida, passe o cursor sobre essa opção para abrir um submenu com as definições que afetam apenas o cliente de desktop:

* **Enable Landscape Terrains**: ativa ou desativa o terreno em redor da scene. Esta opção está ativada por predefinição; desative-a para reduzir a utilização de memória da scene. Fica indisponível quando as próprias definições da scene já ocultam o terreno.
* **Multi-Instance Preview**: permite executar várias janelas do Explorer em simultâneo, para poder [testar uma scene multijogador localmente](#test-a-multiplayer-scene-locally). Com esta opção ativada, cada janela pede-lhe que inicie sessão, para que possa ligar-se como um jogador diferente em cada uma. Só é apresentada quando o projeto utiliza o SDK 7.20.4 ou posterior.
* **Enable MCP Server**: inicia o Explorer com o servidor de automatização MCP ativado, para que os agentes de IA possam ver e controlar a pré-visualização em execução. Só é apresentada quando o projeto utiliza o SDK 7.25.0 ou posterior. Consulte [Programação Vibe com IA](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/vibe-coding.md#let-the-ai-see-your-scene-in-world) para ver o fluxo de trabalho completo.

A saída da consola da scene não requer uma opção de menu. O Creator Hub abre-a sempre que executa uma pré-visualização. Consulte [A consola do Creator Hub](#the-creator-hub-console).

{% hint style="info" %}
**Sugestão:** Também pode pré-visualizar a sua scene diretamente na aplicação móvel Decentraland. Utilize o **Mostrar código QR para dispositivos móveis** no Creator Hub ou execute `npm run start -- --mobile` a partir da CLI. Consulte [Pré-visualizar em dispositivos móveis](https://docs.decentraland.org/creator/content-creator-pt/criar-para-mobile/desenvolver/preview-on-mobile.md) para obter mais informações.
{% endhint %}

## Utilizar a CLI

Para pré-visualizar uma cena, execute o seguinte comando na pasta principal da cena:

```bash
npm run start
```

Todas as dependências em falta são instaladas e, em seguida, a CLI cria um servidor Web local no seu sistema e inicia a cena no cliente Decentraland Desktop através de um `decentraland://` deep link. O cliente Desktop é o destino de pré-visualização predefinido.

Para pré-visualizar numa janela do browser, em vez disso, adicione `-- --web` (ou `-- --bevy-web`) para abrir a cena no cliente Bevy Web em `decentraland.org/bevy-web/`.

Sempre que fizer alterações à cena, a pré-visualização é recarregada e atualizada automaticamente, pelo que não é necessário executar novamente o comando.

{% hint style="warning" %}
**📔 Nota**: Algumas cenas dependem da comunicação com um servidor externo para executar lógica personalizada ou armazenar e obter dados. Ao pré-visualizar uma destas cenas, é provável que também tenha de executar o servidor localmente noutra porta. Consulte o readme da cena para obter instruções sobre como iniciar o servidor e a cena.
{% endhint %}

### Parâmetros do comando de pré-visualização

Pode adicionar as seguintes flags ao comando `npm run start` para alterar o seu comportamento:

* `-- --web` (alias `-- --bevy-web`) Abre a pré-visualização no cliente de browser Bevy Web em `decentraland.org/bevy-web/` em vez do Explorer Desktop. Os browsers baseados em Chromium (Chrome 142+) requerem a permissão de acesso à rede local para que a página alojada possa aceder ao servidor de pré-visualização local — quando o browser pedir autorização para aceder a aplicações no seu dispositivo, clique em «Permitir».
* `-- --mobile` (alias `-- -m`) Mostra um código QR no terminal que abre a sua cena na [aplicação móvel Decentraland](https://docs.decentraland.org/creator/content-creator-pt/criar-para-mobile/cliente-movel/overview.md) num telemóvel ligado à mesma rede Wi-Fi. Consulte [Pré-visualizar em dispositivos móveis](https://docs.decentraland.org/creator/content-creator-pt/criar-para-mobile/desenvolver/preview-on-mobile.md).
* `-- --skip-build` Ignora a compilação e disponibiliza apenas os ficheiros no modo de pré-visualização.
* `-- --port` (alias `-- -p`) para atribuir uma porta específica à execução da cena. Caso contrário, será utilizada uma porta disponível.
* `-- --no-browser` (alias `-- -b`) para impedir que a pré-visualização abra uma nova janela do browser.
* `-- -w` ou `-- --no-watch` para não monitorizar alterações no sistema de ficheiros e evitar o recarregamento automático sempre que o código da cena muda.
* `-- --ci` Para executar o pré-visualizador de parcelas num servidor Unix remoto.
* `-- --multi-instance` Permite executar várias instâncias do Explorer em simultâneo.
* `-- --no-client` Desativa todos os arranques automáticos (ligação direta para o Explorer de ambiente de trabalho, abertura do browser e QR para dispositivos móveis). O monitor de ficheiros continua a notificar o Explorer de ambiente de trabalho se este se ligar por iniciativa própria. Útil quando uma ferramenta externa controla o processo do Explorer.
* `-- --mcp` Ativa o servidor MCP no Explorer (transmitido como parâmetro de ligação direta).
* `-- --mcp-port` Porta do servidor MCP no Explorer (transmitida como parâmetro de ligação direta). Por exemplo: `npm run start -- --mcp --mcp-port 3001`.

{% hint style="warning" %}
**📔 Nota**: os parâmetros têm de ser adicionados com dois conjuntos de traços, por exemplo `npm run start -- --web3`.
{% endhint %}

## Pré-visualizar com assets otimizados

Quando publica uma cena, os servidores da Decentraland convertem todos os modelos 3D desta em pacotes de assets, um formato otimizado que é muito mais leve de carregar e renderizar. Consulte [Conversão de pacotes de assets](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/otimizacao/performance-optimization.md#asset-bundle-conversion).

O Desktop Explorer executa esta mesma conversão no seu computador quando pré-visualiza a cena, por isso não precisa de ativar nada. Isto tem duas vantagens:

* A pré-visualização carrega mais rapidamente e funciona com maior fluidez, sobretudo em cenas com modelos 3D pesados.
* Vê os modelos exatamente como os jogadores os verão após a publicação, podendo detetar problemas com a compressão dos assets antes de publicar.

Isto afeta apenas a pré-visualização local. A cena publicada é sempre convertida nos servidores.

A conversão é quase instantânea na maioria das cenas, mas a primeira pré-visualização pode demorar mais se a cena tiver assets muito pesados. Os modelos convertidos ficam em cache, por isso, nas pré-visualizações seguintes, só é necessário converter os assets novos ou modificados.

{% hint style="info" %}
**💡 Sugestão**: se a conversão de um asset falhar por qualquer motivo, a pré-visualização recorre ao carregamento do modelo 3D original.
{% endhint %}

### Pré-visualizar os modelos originais

Para ignorar a conversão e carregar os ficheiros originais `.glb` e `.gltf` por exemplo, para verificar se um problema é causado pela conversão:

* **No Creator Hub**: clique no logótipo do Creator Hub, selecione **Definições**, abra o separador **EDITOR** e marque **Carregar GLTFs originais** em **Opções de reprodução**. Esta opção está desativada por predefinição. Se já estiver a executar uma pré-visualização, esta será reiniciada com a nova definição na próxima vez que clicar em **Reproduzir**.
* **Na CLI**: adicione `--lsd-raw-gltf` após um comando autónomo `--`, por exemplo `npx sdk-commands start -- --lsd-raw-gltf`. Isto requer `@dcl/sdk` 7.26.0 ou posterior no seu projeto.

Esta definição afeta apenas o Explorer para desktop. A aplicação móvel e o cliente Bevy Web ignoram-na.

## Carregar uma cena para a Decentraland

Quando estiver satisfeito com a sua cena, pode carregá-la e publicá-la na Decentraland. Para isso, tem de possuir LAND, um NAME da Decentraland ou um nome ETH ENS, ou ter autorização de alguém que possua um destes. Consulte [publicação](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/publicacao/publishing.md) para saber como fazê-lo.

## Pré-visualizar o tamanho da cena

O tamanho da cena apresentado na pré-visualização baseia-se na configuração da cena.

Edite esta configuração no segundo separador do menu da cena no Scene Editor.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a5dcb2c0e22a2e3e4a4798791490f40793abdac0%2Fscene-parcels-3x3.webp?alt=media)

Utilize os menus pendentes e clique em **Aplicar layout** para alterar as dimensões da cena. Também pode clicar em cada parcela individual para desativá-la no layout.

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

Também pode editar o ficheiro *scene.json* para listar várias parcelas no campo "parcels". Consulte [definir parcelas através da linha de comandos](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/tipos-de-projetos/scene-metadata.md#scene-parcels) para obter mais detalhes.

{% hint style="info" %}
**💡 Sugestão**: Durante a execução da pré-visualização, as coordenadas das parcelas não precisam de corresponder às que a sua cena irá utilizar, desde que sejam adjacentes e estejam organizadas com a mesma forma. Mais tarde, terá de as substituir pelas coordenadas reais quando [implementar a cena](#upload-a-scene-to-decentraland).
{% endhint %}

## Ver a consola da cena

Abra a consola clicando no ícone ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a673f6b987216e9e471fdac882879c44fcf94652%2Fconsole-icon.png?alt=media\&token=1965a51b-d4b0-4caa-b9d5-d24d738c1fb8) no canto superior direito. Aqui pode ver mensagens de erro e também qualquer texto que a sua cena apresente na consola através de `console.log()`.

Também pode abri-la premindo a tecla **\`** no teclado. Também pode premir Shift + **\`** para abrir a consola numa janela ainda maior, caso precise de ver mais texto.

## A consola do Creator Hub

O Creator Hub apresenta os mesmos resultados sem sair do editor e fá-lo por predefinição. Execute uma pré-visualização e será apresentado um separador **CONSOLE** junto a **LOCAL ASSETS**, **CUSTOM ITEMS** e **ASSET PACKS** no painel na parte inferior do editor.

Para impedir que a consola se abra, desmarque **Abrir consola de depuração** em **Opções de reprodução** no separador **EDITOR** das definições do Creator Hub. Na mesma secção, encontra **Ativar terrenos de paisagem** e [Carregar GLTFs em bruto](#preview-the-raw-models-instead).

Para afastar a consola, clique no ícone de janela separada no cabeçalho, com a etiqueta **Abrir consola numa janela separada**. A consola abre numa janela própria com o título **Consola**, que pode mover para um segundo monitor e manter visível enquanto edita.

A janela separada tem um botão **Limpar consola** e um botão **Voltar a encaixar no editor** que devolve a consola ao painel inferior. Entretanto, o separador **CONSOLE** no editor apresenta a mensagem **Consola aberta numa janela separada** e oferece um botão **Voltar a encaixar aqui** que faz o mesmo.

{% hint style="info" %}
**💡 Dica**: a consola continua a recolher a saída enquanto está separada, por isso, ao voltar a encaixá-la, não perde nada. Quando não há nenhuma pré-visualização em execução, apresenta **Execute uma cena para ver a saída de depuração**.
{% endhint %}

## Testar uma cena multijogador localmente

Se iniciar uma pré-visualização da Scene e a abrir em duas (ou mais) janelas diferentes do Explorer, cada janela aberta será interpretada como um jogador separado, e um servidor de comunicação simulado manterá estes jogadores sincronizados.

Interaja com a Scene numa janela e, em seguida, mude para a outra para ver que os efeitos dessa interação também são visíveis aí.

No Creator Hub, ative **Multi-Instance Preview** no submenu **Desktop Client** de **Play Options**, depois clique novamente no botão **Play** para abrir uma segunda janela do Explorer do Decentraland. Tem de iniciar sessão nas duas janelas com endereços diferentes. As mesmas sessões permanecerão abertas quando a cena for recarregada.

![](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)

Em alternativa, pode abrir uma segunda janela do Explorer da Decentraland escrevendo o seguinte num URL do browser:

> `decentraland://realm=http://127.0.0.1:8000&local-scene=true&debug=true&multi-instance=true`

### Avançado: iteração rápida com pacotes de recursos remotos

{% hint style="info" %}
**💡 Dica**: para a maioria das cenas, a pré-visualização predefinida é tudo de que precisa: ela [converte os seus modelos localmente](#preview-with-optimized-assets) e reflete sempre a versão mais recente. O modo abaixo é uma alternativa que reutiliza os pacotes já publicados nos servidores.
{% endhint %}

Em cenas pesadas, com muitos modelos 3D, pode acelerar o carregamento e o recarregamento da cena reutilizando os [pacotes de recursos](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/otimizacao/performance-optimization.md#asset-bundle-conversion) já publicados nos servidores do Decentraland, em vez de carregar os modelos 3D brutos e não otimizados. Isto é especialmente útil ao fazer iterações apenas no código.

Para ativar este modo, inicie o cliente Desktop do Decentraland com os seguintes argumentos:

```bash
npm run start -- --realm http://127.0.0.1:8000/ --position 0,0 --local-scene true --debug --skip-version-check true --lsd-use-remote-ab <ab-source>
```

O argumento `<ab-source>` varia consoante o local onde a cena já está publicada:

* **Em Genesis City**: `--lsd-remote-ab-server Genesis`
* **Num World**: `--lsd-remote-ab-world <world-name>.dcl.eth`

Por exemplo, para pré-visualizar uma cópia local de uma cena que já foi implementada num World:

```bash
npm run start -- --realm http://127.0.0.1:8000/ --position 0,0 --local-scene true --debug --skip-version-check true --lsd-use-remote-ab --lsd-remote-ab-world myworld.dcl.eth
```

Em ambos os casos, `--realm http://127.0.0.1:8000/` direciona o cliente para o seu servidor de pré-visualização local (execute `npm run start` primeiro para o iniciar), e `--local-scene true` indica ao cliente que carregue o código da cena a partir daí.

{% hint style="warning" %}
**📔 Importante**: ao utilizar este modo, recomenda-se que **todos** os seus elementos gráficos já estejam publicados, com os respetivos pacotes de recursos totalmente processados pelos servidores de conteúdo. Se tiver adicionado novos recursos, não beneficiará do carregamento otimizado, pois serão carregados como ficheiros glTF em bruto, tal como acontece quando executa uma pré-visualização normalmente. No entanto, se tiver modificado localmente um recurso que já estava publicado, mantendo o mesmo nome de ficheiro, verá a versão antiga publicada desse recurso.

Nesse caso, volte a publicar a cena primeiro, aguarde alguns minutos até os pacotes de recursos serem gerados (consulte [Conversão de pacotes de recursos](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/otimizacao/performance-optimization.md#asset-bundle-conversion)) e, em seguida, retome a utilização deste modo para iterar apenas no código.
{% endhint %}


---

# 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/scenes-sdk7/primeiros-passos/preview-scene.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.
