> 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 ter [criado uma nova cena](#create-your-first-scene) ou descarregado um [exemplo de cena](https://studios.decentraland.org/resources?sdk_version=SDK7) pode pré-visualizá-la localmente. ## Usando o Scene Editor no Creator Hub Certifique-se de que já [instalou o Creator Hub](https://github.com/decentraland/docs/tree/main/creator/sdk7/get-started/editor-installation.md). 1. Abra o seu projeto de cena. 2. Clique no **Play** botão no canto superior direito. Isto abrirá uma nova janela com o Decentraland Desktop Explorer, a executar apenas a sua cena. Aí pode deslocar-se pela cena e interagir com itens interativos. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-30317b50bc4b4e646a1b28effe1ff76939ab0f28%2Fpreview-button.png?alt=media\&token=fbed0f2f-8063-4283-9b07-2d964c9c0e68) ### Escolha onde pré-visualizar Clique na seta junto ao **Play** botão para abrir o **Opções de Play** menu. O painel principal é onde escolhe o que executa a sua cena: * **Cliente Desktop**: Abre a pré-visualização no Decentraland Desktop Explorer. Esta é a predefinição. * **Web (Bevy)**: Abre a pré-visualização no seu navegador, usando o cliente Bevy Web. Equivalente ao sinalizador `--web` da CLI. * **Mostrar código QR para Mobile**: Exibe um código QR que abre a pré-visualização da sua cena na [app móvel da Decentraland](/creator/content-creator-pt/criar-para-mobile/cliente-movel/overview.md). Leia o código com um telemóvel na mesma rede Wi‑Fi que o seu computador. Clique na área escura à volta do pop-up para o fechar. Veja [Pré-visualização no mobile](/creator/content-creator-pt/criar-para-mobile/desenvolver/preview-on-mobile.md) para mais detalhes. ### Opções do Cliente Desktop Selecione **Cliente Desktop** no **Opções de Play** menu e depois passe o rato sobre ele para abrir um submenu com as definições que afetam apenas o cliente desktop: * **Ativar terrenos paisagísticos**: Ativa e desativa a paisagem à volta da cena. Isto está ativado por predefinição; desative-o para reduzir a utilização de memória da cena. Fica esbatido quando as próprias definições da cena já ocultam o terreno. * **Pré-visualização com várias instâncias**: Permite executar várias janelas do Explorer ao mesmo tempo, para que possa [testar localmente uma cena multijogador](#test-a-multiplayer-scene-locally). Com isto ativado, cada janela pede-lhe que inicie sessão, para que se possa ligar como um jogador diferente em cada uma. Só fica visível quando o seu projeto usa SDK 7.20.4 ou posterior. * **Ativar servidor MCP**: Inicia o Explorer com o servidor de automação MCP ativado, para que agentes de IA possam ver e controlar a pré-visualização em execução. Só fica visível quando o seu projeto usa SDK 7.25.0 ou posterior. Veja [Vibe Coding com IA](/creator/content-creator-pt/scenes-sdk7/primeiros-passos/vibe-coding.md#let-the-ai-see-your-scene-in-world) para o fluxo de trabalho completo. * **Comprimir ativos**: Pré-visualiza a cena com asset bundles gerados localmente, correspondendo à forma como é renderizada em produção após [conversão para asset bundles](/creator/content-creator-pt/scenes-sdk7/otimizacao/performance-optimization.md#asset-bundle-conversion). A primeira execução converte todos os ativos, o que pode demorar vários minutos em cenas grandes. Só fica visível quando a sua plataforma e a versão do SDK do seu projeto o suportam. Veja [Pré-visualizar com ativos otimizados](#preview-with-optimized-assets). A saída da consola da cena não precisa de uma opção de menu. O Creator Hub abre-a para si sempre que executa uma pré-visualização. Veja [a consola do Creator Hub](#the-creator-hub-console). {% hint style="info" %} **Dica:** Também pode pré-visualizar a sua cena diretamente na app móvel da Decentraland. Use a **Mostrar código QR para Mobile** opção no Creator Hub, ou execute `npm run start -- --mobile` a partir da CLI. Veja [Pré-visualização no mobile](/creator/content-creator-pt/criar-para-mobile/desenvolver/preview-on-mobile.md) para mais detalhes. {% endhint %} ## Usando a CLI Para pré-visualizar uma cena, execute o seguinte comando na pasta principal da cena: ```bash npm run start ``` Quaisquer dependências em falta são instaladas e depois a CLI cria um servidor web local no seu sistema e inicia a cena no Decentraland Desktop client através de um `decentraland://` deeplink. O Desktop client é o destino de pré-visualização predefinido. Para pré-visualizar num separador do navegador, 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 recarrega e atualiza automaticamente, por isso não há necessidade de voltar a executar o comando. {% hint style="warning" %} **📔 Nota**: Algumas cenas dependem de comunicar com um servidor externo para executar lógica personalizada ou guardar e recuperar dados. Ao pré-visualizar uma destas cenas, provavelmente também terá de executar o servidor localmente noutro porto. Consulte o ficheiro 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 os seguintes flags ao `npm run start` comando para alterar o seu comportamento: * `-- --web` (alias `-- --bevy-web`) Abre a pré-visualização no cliente de navegador Bevy Web em `decentraland.org/bevy-web/` em vez do Desktop Explorer. Os navegadores baseados em Chromium (Chrome 142+) requerem a permissão Local Network Access para que a página alojada possa aceder ao seu servidor local de pré-visualização — quando o navegador pedir acesso às apps no seu dispositivo, clique em "Allow". * `-- --mobile` (alias `-- -m`) Mostra um código QR no terminal que abre a sua cena no [app móvel da Decentraland](/creator/content-creator-pt/criar-para-mobile/cliente-movel/overview.md) num telemóvel ligado à mesma rede Wi‑Fi. Veja [Pré-visualização no mobile](/creator/content-creator-pt/criar-para-mobile/desenvolver/preview-on-mobile.md). * `-- --skip-build` Ignore a build e sirva apenas os ficheiros em modo de pré-visualização. * `-- --port` (alias `-- -p`) para atribuir um porto específico para executar a cena. Caso contrário, usará qualquer porto disponível. * `-- --no-browser` (alias `-- -b`) para impedir que a pré-visualização abra um novo separador do navegador. * `-- -w` ou `-- --no-watch` para não monitorizar alterações no sistema de ficheiros e evitar hot-reload sempre que o código da cena mudar. * `-- --ci` Para executar o visualizador do parcel num servidor Unix remoto. * `-- --multi-instance` Permite executar várias instâncias do Explorer em simultâneo. * `-- --local-ab` Pré-visualize com asset bundles otimizados. O Decentraland Desktop Explorer converte os ativos da cena em asset bundles por si durante a pré-visualização, correspondendo à forma como a cena é renderizada em produção. Equivalente à **Comprimir ativos** opção no Creator Hub. Apenas disponível com o Cliente Desktop (não com o cliente Bevy Web). Veja [Pré-visualizar com ativos otimizados](#preview-with-optimized-assets). * `-- --no-client` Suprime todos os lançamentos automáticos (deeplink do Desktop Explorer, abertura do navegador, QR mobile). O monitorizador de ficheiros ainda notifica um Desktop Explorer se ele se ligar por conta própria. Útil quando uma ferramenta externa controla o processo do Explorer. * `-- --mcp` Ativa o servidor MCP no Explorer (encaminhado como parâmetro de deep link). * `-- --mcp-port` Porto para o servidor MCP no Explorer (encaminhado como parâmetro de deep link). Por exemplo: `npm run start -- --mcp --mcp-port 3001`. {% hint style="warning" %} **📔 Nota**: Os parâmetros precisam de ser adicionados com dois conjuntos de travessões, por exemplo `npm run start -- --web3`. {% endhint %} ## Pré-visualizar com ativos otimizados Quando publica uma cena, os servidores da Decentraland convertem todos os seus modelos 3D em asset bundles, um formato otimizado que é muito mais leve para carregar e renderizar. Veja [Conversão de asset bundle](/creator/content-creator-pt/scenes-sdk7/otimizacao/performance-optimization.md#asset-bundle-conversion). Por predefinição, as pré-visualizações locais ignoram esta etapa e carregam os modelos brutos em vez disso. Ative os ativos otimizados para executar esta mesma conversão localmente quando pré-visualiza a sua cena. Isto tem duas vantagens: * A pré-visualização carrega mais depressa e corre de forma mais fluida, especialmente em cenas com modelos 3D pesados. * Vê os modelos exatamente como os jogadores os verão depois de publicar, para que possa detetar quaisquer problemas com a compressão de ativos antes de publicar. Esta opção só afeta a sua pré-visualização local. A cena publicada é sempre convertida nos servidores, quer use esta opção ou não. Para a ativar: * **No Creator Hub**: abra **Opções de Play** junto ao **Play** botão, passe o rato sobre **Cliente Desktop**, e marque **Comprimir ativos**. * **A partir da CLI**: execute `npm run start -- --local-ab`. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-e8a9e4c2c58d07f6493df205efe569837d4701f8%2Foptimize-assets-checkbox.png?alt=media\&token=eb756c70-de8f-4843-bed7-5424a600baa0) Com esta opção ativada, o Decentraland explorer converte os modelos 3D da cena em asset bundles na sua máquina antes de os carregar. A conversão é quase instantânea para a maioria das cenas, mas a primeira pré-visualização pode demorar mais se a cena tiver ativos muito pesados. Os modelos convertidos ficam em cache, por isso, em pré-visualizações posteriores, só os ativos novos ou modificados precisam de ser convertidos. {% hint style="info" %} **💡 Dica**: Se a conversão de um ativo falhar por qualquer motivo, a pré-visualização recorre ao carregamento dos modelos 3D brutos, tal como numa pré-visualização normal. {% endhint %} ## Carregar uma cena para a Decentraland Depois de estar satisfeito com a sua cena, pode carregá-la e publicá-la na Decentraland. Para isso, tem de possuir LAND, um Decentraland NAME, ou um nome ETH ENS, ou ter permissões dadas por alguém que os possua. Veja [publicação](/creator/content-creator-pt/scenes-sdk7/publicacao/publishing.md) para instruções sobre como o fazer. ## Tamanho da cena na pré-visualização O tamanho da cena mostrado na pré-visualização baseia-se na configuração da cena. Edite isto 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-54a1901635efda3371172e647c03614733baca17%2Fscene-parcels-3x3.png?alt=media\&token=e7133392-8474-4127-b075-5a3f4e7a4e8d) Use os menus suspensos e clique em **Aplicar Layout** para alterar as dimensões da sua cena. Também pode clicar em cada parcela individual para a desativar no seu layout. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-bbc2ecb567600843892a8c8873aaa70107e66839%2Fscene-parcels-toggled.png?alt=media\&token=aa4c4612-48ac-458d-afec-453d5168d1e8) Também pode editar o *scene.json* ficheiro para listar várias parcelas no campo "parcels". Veja [definir parcelas pela linha de comandos](/creator/content-creator-pt/scenes-sdk7/tipos-de-projetos/scene-metadata.md#scene-parcels) para mais detalhes. {% hint style="info" %} **💡 Dica**: Enquanto a pré-visualização estiver a correr, as coordenadas das parcelas não precisam de coincidir com as que a sua cena vai realmente usar, desde que sejam adjacentes e estejam organizadas na mesma forma. Terá de substituí-las pelas coordenadas reais mais tarde, quando fizer o deploy da cena [fazer o deploy da cena](#upload-a-scene-to-decentraland). {% endhint %} ## Ver a consola da cena Abra a consola clicando no ![](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) ícone no canto superior direito. Aqui pode ver quaisquer mensagens de erro, e também qualquer texto que a sua cena imprima na consola através de `console.log()`. Também pode abri-la premindo a **\`** tecla no seu teclado. Também pode premir Shift + **\`** para abrir a consola ainda maior, caso precise de ver mais texto. ## a consola do Creator Hub O Creator Hub mostra a mesma saída sem sair do editor, e fá-lo por predefinição. Execute uma pré-visualização e um **CONSOLE** separador aparece junto a **FILE SYSTEM** e **ASSET PACKS** no painel na parte inferior do editor. Para impedir que a consola abra, desmarque **Open Debug Console** em **Opções de Play** no **EDITOR** separador das definições do Creator Hub. Para tirar a consola do caminho, clique no ícone de destacamento no seu cabeçalho, rotulado **Open console in a separate window**. A consola abre numa janela própria intitulada **Consola**, que pode mover para um segundo monitor e manter visível enquanto edita. A janela separada tem um **Limpar consola** botão, e um **Ancorar de volta no editor** botão que devolve a consola ao painel inferior. Entretanto, o **CONSOLE** separador no editor mostra **Consola aberta numa janela separada** e oferece um **Ancorar de volta aqui** botão que faz o mesmo. {% hint style="info" %} **💡 Dica**: A consola continua a recolher saída enquanto estiver destacada, por isso voltar a ancorá-la não perde nada. Quando não está a correr nenhuma pré-visualização, mostra **Execute uma cena para ver a saída de depuração**. {% endhint %} ## Teste localmente uma cena multijogador Se iniciar uma pré-visualização de cena 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ções simulado manterá estes jogadores sincronizados. Interaja com a cena numa janela e depois mude para a outra para ver que os efeitos dessa interação também estão visíveis aí. No Creator Hub, ative **Pré-visualização com várias instâncias** no **Cliente Desktop** o submenu de **Opções de Play**, depois clique no **Play** botão uma segunda vez para abrir uma segunda janela do Decentraland explorer. Tem de se ligar em ambas as janelas com endereços diferentes. As mesmas sessões permanecerão abertas à medida que a cena recarrega. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-30317b50bc4b4e646a1b28effe1ff76939ab0f28%2Fpreview-button.png?alt=media\&token=fbed0f2f-8063-4283-9b07-2d964c9c0e68) Como alternativa, pode abrir uma segunda janela do Decentraland explorer escrevendo o seguinte num URL do navegador: > `decentraland://realm=http://127.0.0.1:8000&local-scene=true&debug=true&multi-instance=true` ### Avançado: iteração rápida com asset bundles remotos {% hint style="info" %} **💡 Dica**: Para a maioria das cenas, a forma mais simples de pré-visualizar com asset bundles é ativar [ativos otimizados](#preview-with-optimized-assets), o que converte os seus modelos localmente e reflete sempre a sua versão mais recente. O modo abaixo é uma alternativa que reutiliza os bundles já publicados nos servidores. {% endhint %} Para cenas pesadas com muitos modelos 3D, pode acelerar o carregamento e o recarregamento da cena reutilizando os [asset bundles](/creator/content-creator-pt/scenes-sdk7/otimizacao/performance-optimization.md#asset-bundle-conversion) já publicados nos servidores da Decentraland, em vez de carregar os modelos 3D brutos e não otimizados. Isto é especialmente útil quando itera em alterações apenas de código. Para ativar este modo, inicie o Decentraland Desktop client 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 ``` O `` argumento muda consoante onde a cena já está publicada: * **Em Genesis City**: `--lsd-remote-ab-server Genesis` * **Num World**: `--lsd-remote-ab-world .dcl.eth` Por exemplo, para pré-visualizar uma cópia local de uma cena que já está 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/` aponta o cliente para o seu servidor local de pré-visualização (execute `npm run start` primeiro para o iniciar), e `--local-scene true` diz ao cliente para carregar o código da cena a partir daí. {% hint style="warning" %} **📔 Importante**: Ao usar este modo, é recomendado que **todos** os seus elementos artísticos já estejam publicados, com os respetivos asset bundles totalmente processados pelos servidores de conteúdo. Se tiver adicionado novos ativos, perderá o carregamento otimizado, porque estes serão carregados como ficheiros glTF brutos, tal como acontece quando executa normalmente uma pré-visualização. Mas se tiver modificado localmente um ativo que já estava publicado, mantendo o mesmo nome de ficheiro, então verá a versão publicada antiga desse ativo. Nesse caso, volte a implementar a cena primeiro, aguarde alguns minutos para que os asset bundles sejam gerados (veja [Conversão de asset bundle](/creator/content-creator-pt/scenes-sdk7/otimizacao/performance-optimization.md#asset-bundle-conversion)), e depois retome a utilização deste modo para iteração apenas de 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=&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.