> 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-es/scenes-sdk7/primeros-pasos/preview-scene.md). # Vista previa de tu escena Lo que puedes ver en la vista previa de una escena Una vez que tengas [creado una nueva escena](#create-your-first-scene) o descargado un [ejemplo de escena](https://studios.decentraland.org/resources?sdk_version=SDK7) puedes previsualizarla localmente. ## Usando el Scene Editor en Creator Hub Asegúrate de haber [instalado Creator Hub](https://github.com/decentraland/docs/tree/main/creator/sdk7/get-started/editor-installation.md). 1. Abre tu proyecto de escena. 2. Haz clic en el **Play** botón en la esquina superior derecha. Esto abrirá una nueva ventana con el Decentraland Desktop Explorer, ejecutando solo tu escena. Allí podrás moverte por la escena e interactuar con elementos interactivos. ![](https://1216664193-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) ### Elige dónde previsualizar Haz clic en la flecha junto al **Play** botón para abrir el **Opciones de reproducción** menú. El panel principal es donde eliges qué ejecuta tu escena: * **Cliente de escritorio**: Abre la vista previa en el Decentraland Desktop Explorer. Esta es la opción predeterminada. * **Web (Bevy)**: Abre la vista previa en tu navegador, usando el cliente Web de Bevy. Equivalente a la `--web` opción de CLI. * **Mostrar código QR para móvil**: Muestra un código QR que abre la vista previa de tu escena en la [aplicación móvil de Decentraland](/creator/content-creator-es/desarrollar-para-movil/cliente-movil/overview.md). Escanea el código con un teléfono en la misma red Wi‑Fi que tu computadora. Haz clic en el área oscura alrededor de la ventana emergente para cerrarla. Consulta [Vista previa en móvil](/creator/content-creator-es/desarrollar-para-movil/desarrollar/preview-on-mobile.md) para más detalles. ### Opciones del cliente de escritorio Selecciona **Cliente de escritorio** en el **Opciones de reproducción** menú, luego pasa el cursor sobre él para abrir un submenú con los ajustes que solo afectan al cliente de escritorio: * **Habilitar terrenos del paisaje**: Activa o desactiva el paisaje alrededor de la escena. Está habilitado de forma predeterminada; desactívalo para reducir el uso de memoria de la escena. Aparece atenuado cuando la configuración de la propia escena ya oculta el terreno. * **Vista previa con múltiples instancias**: Permite que varias ventanas de Explorer se ejecuten al mismo tiempo, para que puedas [probar una escena multijugador localmente](#test-a-multiplayer-scene-locally). Con esto activado, cada ventana te pedirá iniciar sesión, para que puedas conectarte como un jugador distinto en cada una. Solo visible cuando tu proyecto usa SDK 7.20.4 o posterior. * **Habilitar servidor MCP**: Inicia Explorer con el servidor de automatización MCP habilitado, para que los agentes de IA puedan ver y controlar la vista previa en ejecución. Solo visible cuando tu proyecto usa SDK 7.25.0 o posterior. Consulta [Vibe Coding con IA](/creator/content-creator-es/scenes-sdk7/primeros-pasos/vibe-coding.md#let-the-ai-see-your-scene-in-world) para ver el flujo completo. * **Comprimir assets**: Previsualiza la escena con asset bundles generados localmente, coincidiendo con cómo se renderiza en producción después de [la conversión de asset bundles](/creator/content-creator-es/scenes-sdk7/optimizacion/performance-optimization.md#asset-bundle-conversion). La primera ejecución convierte todos los assets, lo que puede tardar varios minutos en escenas grandes. Solo visible cuando tu plataforma y la versión de SDK de tu proyecto lo admiten. Consulta [Vista previa con assets optimizados](#preview-with-optimized-assets). La salida de consola de la escena no necesita una opción de menú. Creator Hub la abre por ti cada vez que ejecutas una vista previa. Consulta [La consola de Creator Hub](#the-creator-hub-console). {% hint style="info" %} **Consejo:** También puedes previsualizar tu escena directamente en la aplicación móvil de Decentraland. Usa la **Mostrar código QR para móvil** opción en Creator Hub, o ejecuta `npm run start -- --mobile` desde la CLI. Consulta [Vista previa en móvil](/creator/content-creator-es/desarrollar-para-movil/desarrollar/preview-on-mobile.md) para más detalles. {% endhint %} ## Uso de la CLI Para previsualizar una escena, ejecuta el siguiente comando en la carpeta principal de la escena: ```bash npm run start ``` Cualquier dependencia faltante se instala y luego la CLI crea un servidor web local en tu sistema e inicia la escena en el cliente de escritorio de Decentraland a través de un `decentraland://` deeplink. El cliente de escritorio es el destino predeterminado de la vista previa. Para previsualizar en una pestaña del navegador en su lugar, añade `-- --web` (o `-- --bevy-web`) para abrir la escena en el cliente Web de Bevy en `decentraland.org/bevy-web/`. Cada vez que hagas cambios en la escena, la vista previa se recarga y se actualiza automáticamente, así que no es necesario volver a ejecutar el comando. {% hint style="warning" %} **📔 Nota**: Algunas escenas dependen de comunicarse con un servidor externo para realizar lógica personalizada o almacenar y recuperar datos. Al previsualizar una de estas escenas, probablemente también tendrás que ejecutar el servidor localmente en otro puerto. Revisa el readme de la escena para obtener instrucciones sobre cómo iniciar tanto el servidor como la escena. {% endhint %} ### Parámetros del comando de vista previa Puedes agregar las siguientes banderas al `npm run start` comando para cambiar su comportamiento: * `-- --web` (alias `-- --bevy-web`) Abre la vista previa en el cliente Web de Bevy del navegador en `decentraland.org/bevy-web/` en lugar de Desktop Explorer. Los navegadores basados en Chromium (Chrome 142+) requieren el permiso de acceso a la red local para que la página alojada alcance tu servidor de vista previa local: cuando el navegador pida acceder a apps en tu dispositivo, haz clic en "Allow". * `-- --mobile` (alias `-- -m`) Muestra un código QR en la terminal que abre tu escena en la [aplicación móvil de Decentraland](/creator/content-creator-es/desarrollar-para-movil/cliente-movil/overview.md) en un teléfono conectado a la misma red Wi‑Fi. Consulta [Vista previa en móvil](/creator/content-creator-es/desarrollar-para-movil/desarrollar/preview-on-mobile.md). * `-- --skip-build` Omite la compilación y solo sirve los archivos en modo de vista previa. * `-- --port` (alias `-- -p`) para asignar un puerto específico para ejecutar la escena. De lo contrario, usará cualquier puerto disponible. * `-- --no-browser` (alias `-- -b`) para evitar que la vista previa abra una nueva pestaña del navegador. * `-- -w` o `-- --no-watch` para no vigilar cambios en el sistema de archivos y evitar la recarga en caliente cada vez que cambie el código de la escena. * `-- --ci` Para ejecutar el previsualizador de parcel en un servidor Unix remoto. * `-- --multi-instance` Permite ejecutar varias instancias de Explorer simultáneamente. * `-- --local-ab` Previsualiza con asset bundles optimizados. El Desktop Explorer convierte los assets de la escena en asset bundles por sí mismo durante la vista previa, coincidiendo con cómo se renderiza la escena en producción. Equivalente a la **Comprimir assets** opción en Creator Hub. Solo disponible con el Cliente de escritorio (no con el cliente Web de Bevy). Consulta [Vista previa con assets optimizados](#preview-with-optimized-assets). * `-- --no-client` Suprime cualquier inicio automático (deeplink del Desktop Explorer, apertura del navegador, QR móvil). El vigilante de archivos sigue notificando a Desktop Explorer si se conecta por su cuenta. Útil cuando una herramienta externa controla el proceso de Explorer. * `-- --mcp` Habilita el servidor MCP en Explorer (reenviado como parámetro de deep link). * `-- --mcp-port` Puerto para el servidor MCP en Explorer (reenviado como parámetro de deep link). Por ejemplo: `npm run start -- --mcp --mcp-port 3001`. {% hint style="warning" %} **📔 Nota**: Los parámetros deben añadirse con dos series de guiones, por ejemplo `npm run start -- --web3`. {% endhint %} ## Vista previa con assets optimizados Cuando publicas una escena, los servidores de Decentraland convierten todos sus modelos 3D en asset bundles, un formato optimizado que es mucho más ligero de cargar y renderizar. Consulta [Conversión de asset bundles](/creator/content-creator-es/scenes-sdk7/optimizacion/performance-optimization.md#asset-bundle-conversion). De forma predeterminada, las vistas previas locales omiten este paso y cargan los modelos sin procesar en su lugar. Activa los assets optimizados para ejecutar esta misma conversión localmente cuando previsualices tu escena. Esto tiene dos beneficios: * La vista previa carga más rápido y funciona con mayor fluidez, especialmente en escenas con modelos 3D pesados. * Ves los modelos exactamente como los verán los jugadores después de publicar, así puedes detectar cualquier problema con la compresión de assets antes de publicar. Esta opción solo afecta a tu vista previa local. La escena publicada siempre se convierte en los servidores, uses o no esta opción. Para activarla: * **En Creator Hub**: abre **Opciones de reproducción** junto al **Play** botón, pasa el cursor sobre **Cliente de escritorio**, y marca **Comprimir assets**. * **Desde la CLI**: ejecuta `npm run start -- --local-ab`. ![](https://1216664193-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) Con esta opción activada, el explorer de Decentraland convierte los modelos 3D de la escena en asset bundles en tu máquina antes de cargarlos. La conversión es casi instantánea en la mayoría de las escenas, pero la primera vista previa puede tardar más si la escena tiene assets muy pesados. Los modelos convertidos se almacenan en caché, así que en vistas previas posteriores solo es necesario convertir los assets nuevos o modificados. {% hint style="info" %} **💡 Consejo**: Si la conversión de un asset falla por cualquier motivo, la vista previa vuelve a cargar los modelos 3D sin procesar, igual que una vista previa normal. {% endhint %} ## Sube una escena a Decentraland Una vez que estés satisfecho con tu escena, puedes subirla y publicarla en Decentraland. Para ello debes ser propietario de LAND, de un NAME de Decentraland o de un nombre ENS de ETH, o tener permisos otorgados por alguien que sí lo sea. Consulta [publicación](/creator/content-creator-es/scenes-sdk7/publicacion/publishing.md) para ver las instrucciones sobre cómo hacerlo. ## Previsualizar el tamaño de la escena El tamaño de la escena que se muestra en la vista previa se basa en la configuración de la escena. Edita esto en la segunda pestaña del menú de la escena en el Scene Editor. ![](https://1216664193-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) Usa los menús desplegables y haz clic en **Apply Layout** para cambiar las dimensiones de tu escena. También puedes hacer clic en cada parcela individual para quitarla de tu diseño. ![](https://1216664193-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) También puedes editar el *scene.json* archivo para listar varias parcelas en el campo "parcels". Consulta [configurar parcelas desde la línea de comandos](/creator/content-creator-es/scenes-sdk7/tipos-de-proyectos/scene-metadata.md#scene-parcels) para más detalles. {% hint style="info" %} **💡 Consejo**: Mientras se ejecuta la vista previa, las coordenadas de las parcelas no necesitan coincidir con las que realmente usará tu escena, siempre que sean adyacentes y estén organizadas en la misma forma. Tendrás que reemplazarlas más tarde por las coordenadas reales cuando [despliegues la escena](#upload-a-scene-to-decentraland). {% endhint %} ## Ver la consola de la escena Abre la consola haciendo clic en el ![](https://1216664193-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) icono de la esquina superior derecha. Aquí puedes ver cualquier mensaje de error, y también cualquier texto que tu escena imprima en la consola mediante `console.log()`. También puedes abrirla pulsando la **\`** tecla de tu teclado. También puedes pulsar Shift + **\`** para abrir la consola aún más ancha, por si necesitas ver más texto. ## La consola de Creator Hub Creator Hub muestra la misma salida sin salir del editor, y lo hace de forma predeterminada. Ejecuta una vista previa y aparece una pestaña **CONSOLE** aparece junto a **FILE SYSTEM** y **ASSET PACKS** en el panel de la parte inferior del editor. Para evitar que se abra la consola, desmarca **Abrir consola de depuración** en **Opciones de reproducción** en la **EDITOR** pestaña de configuración de Creator Hub. Para sacar la consola de en medio, haz clic en el icono emergente de su encabezado, etiquetado **Abrir la consola en una ventana separada**. La consola se abre como su propia ventana titulada **Console**, que puedes mover a un segundo monitor y mantener visible mientras editas. La ventana separada tiene un botón **Borrar consola** y un botón **Volver a acoplar en el editor** que devuelve la consola al panel inferior. Mientras tanto, la **CONSOLE** pestaña del editor muestra **Consola abierta en una ventana separada** y ofrece un botón **Volver a acoplar aquí** que hace lo mismo. {% hint style="info" %} **💡 Consejo**: La consola sigue recopilando salida mientras está desacoplada, así que volver a acoplarla no pierde nada. Cuando no hay ninguna vista previa en ejecución muestra **Ejecuta una escena para ver la salida de depuración**. {% endhint %} ## Prueba una escena multijugador localmente Si inicias una vista previa de la escena y la abres en dos (o más) ventanas diferentes de Explorer, cada ventana abierta se interpretará como un jugador separado, y un servidor simulado de comunicaciones mantendrá sincronizados a estos jugadores. Interactúa con la escena en una ventana, luego cambia a la otra para ver que los efectos de esa interacción también son visibles allí. Usando Creator Hub, activa **Vista previa con múltiples instancias** en el **Cliente de escritorio** el submenú de **Opciones de reproducción**, luego haz clic en el **Play** botón una segunda vez para abrir una segunda ventana del explorer de Decentraland. Debes conectarte en ambas ventanas con direcciones diferentes. Las mismas sesiones permanecerán abiertas mientras la escena se recarga. ![](https://1216664193-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, puedes abrir una segunda ventana del explorer de Decentraland escribiendo lo siguiente en la URL de un navegador: > `decentraland://realm=http://127.0.0.1:8000&local-scene=true&debug=true&multi-instance=true` ### Avanzado: iteración rápida con asset bundles remotos {% hint style="info" %} **💡 Consejo**: Para la mayoría de las escenas, la forma más sencilla de previsualizar con asset bundles es habilitar [assets optimizados](#preview-with-optimized-assets), lo que convierte tus modelos localmente y refleja siempre su versión más reciente. El modo de abajo es una alternativa que reutiliza los bundles ya publicados en los servidores. {% endhint %} Para escenas pesadas con muchos modelos 3D, puedes acelerar la carga y recarga de la escena reutilizando los [asset bundles](/creator/content-creator-es/scenes-sdk7/optimizacion/performance-optimization.md#asset-bundle-conversion) que ya están publicados en los servidores de Decentraland, en lugar de cargar los modelos 3D sin procesar y sin optimizar. Esto es especialmente útil al iterar sobre cambios solo de código. Para habilitar este modo, inicia el cliente de escritorio de Decentraland con los siguientes 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 ``` El `` argumento cambia según dónde esté publicada ya la escena: * **En Genesis City**: `--lsd-remote-ab-server Genesis` * **En un World**: `--lsd-remote-ab-world .dcl.eth` Por ejemplo, para previsualizar una copia local de una escena que ya está desplegada en un 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 ``` En ambos casos, `--realm http://127.0.0.1:8000/` apunta al cliente a tu servidor local de vista previa (ejecútalo `npm run start` primero para iniciarlo), y `--local-scene true` le indica al cliente que cargue desde allí el código de la escena. {% hint style="warning" %} **📔 Importante**: Al usar este modo, se recomienda que **todo** su arte ya esté publicado, con sus asset bundles completamente procesados por los content servers. Si has añadido nuevos assets, no disfrutarás de la carga optimizada, ya que se cargarán como archivos gltf sin procesar, tal como ocurre cuando ejecutas una vista previa normalmente. Pero si modificaste localmente un asset que ya estaba publicado, manteniendo el mismo nombre de archivo, entonces estarás viendo la versión publicada anterior de ese asset. En ese caso, vuelve a desplegar la escena primero, espera unos minutos a que se generen los asset bundles (consulta [Conversión de asset bundles](/creator/content-creator-es/scenes-sdk7/optimizacion/performance-optimization.md#asset-bundle-conversion)), y luego reanuda el uso de este modo para iterar solo sobre el 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-es/scenes-sdk7/primeros-pasos/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.