> 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/escenas-sdk7/primeros-pasos/preview-scene.md). # Previsualiza tu scene Una vez que hayas [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 **Preview** 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 los elementos interactivos. ![](/files/b796cc98872223854364138fce8b5a291451351d) Configura diferentes opciones de previsualización desde el menú desplegable junto al **Preview** botón: * **Previsualizar con**: Elige entre **Desktop Client** (el Explorer de Decentraland predeterminado) y **Bevy (Web)**, que abre la vista previa en tu navegador usando el cliente web Bevy. La opción Bevy Web es equivalente al `--web` bandera de CLI. * **Abrir ventana de consola durante la vista previa**: Abre una nueva ventana con la salida de la consola de la escena. Esto es útil para depurar errores en la escena. * **Omitir pantalla de autenticación**: Omite la pantalla de selección de cuenta e inicia sesión automáticamente con la cuenta con la que ya has iniciado sesión. Esto está desactivado de forma predeterminada; actívalo si quieres probar varias cuentas. * **Terreno de paisaje activado**: Activa o desactiva el paisaje alrededor de la escena. Esto está activado de forma predeterminada; desactívalo para reducir el consumo de memoria de la escena. * **Activar servidor MCP**: Inicia el 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 es visible cuando la versión de SDK de tu proyecto lo admite. Consulta [Vibe Coding con IA](/creator/content-creator-es/escenas-sdk7/primeros-pasos/vibe-coding.md#let-the-ai-see-your-scene-in-world) para ver el flujo de trabajo completo. * **Optimizar activos**: Previsualiza la escena con paquetes de activos generados localmente, igualando cómo se renderiza en producción después de la [conversión de paquetes de activos](/creator/content-creator-es/escenas-sdk7/optimizacion/performance-optimization.md#asset-bundle-conversion). La primera ejecución convierte todos los activos, lo que puede llevar varios minutos en escenas grandes. Solo está disponible con el Desktop Client (no con Bevy Web). Consulta [Previsualizar con activos optimizados](#preview-with-optimized-assets). * **Mostrar código QR para móvil**: Muestra un código QR que abre la vista previa de tu escena en la [app móvil de Decentraland](/creator/content-creator-es/desarrollar-para-movil/cliente-movil/overview.md). Escanea el código con un teléfono conectado a la misma red Wi‑Fi que tu computadora. Consulta [Vista previa en móvil](/creator/content-creator-es/desarrollar-para-movil/desarrollar/preview-on-mobile.md) para más detalles. {% hint style="info" %} **Consejo:** También puedes previsualizar tu escena directamente en la app 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 ``` Las dependencias que falten se instalarán y luego la CLI crea un servidor web local en tu sistema e inicia la escena en el cliente de escritorio de Decentraland mediante un `decentraland://` enlace profundo. El cliente de escritorio es el destino de vista previa predeterminado. Para previsualizar en una pestaña del navegador en su lugar, añade `-- --web` (o `-- --bevy-web`) para abrir la escena en el cliente Bevy Web en `decentraland.org/bevy-web/`. Cada vez que haces cambios en la escena, la vista previa se recarga y se actualiza automáticamente, así que no hace falta 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 añadir las siguientes banderas al `npm run start` comando para cambiar su comportamiento: * `-- --web` (alias `-- --bevy-web`) Abre la vista previa en el cliente de navegador Bevy Web en `decentraland.org/bevy-web/` en lugar del 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 local de vista previa — cuando el navegador te pida acceso a apps en tu dispositivo, haz clic en "Permitir". * `-- --mobile` (alias `-- -m`) Muestra un código QR en la terminal que abre tu escena en la [app 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 sirve solo 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 los cambios del sistema de archivos y evitar la recarga en caliente cada vez que cambia 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 paquetes de activos optimizados. El Explorer de escritorio convierte los assets de la escena en paquetes de activos por sí mismo durante la vista previa, igual que cómo se renderiza la escena en producción. Equivalente a la **Optimizar activos** opción en Creator Hub. Solo está disponible con el Desktop Client (no con Bevy Web). Consulta [Previsualizar con activos optimizados](#preview-with-optimized-assets). * `-- --no-client` Suprime cualquier inicio automático (deeplink del Explorer de escritorio, apertura del navegador, QR móvil). El observador de archivos sigue notificando a un Explorer de escritorio si se conecta por su cuenta. Útil cuando una herramienta externa controla el proceso de Explorer. * `-- --mcp` Habilita el servidor MCP en el Explorer (reenviado como parámetro de deep link). * `-- --mcp-port` Puerto para el servidor MCP en el 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 %} ## Previsualizar con activos optimizados Cuando publicas una escena, los servidores de Decentraland convierten todos sus modelos 3D en paquetes de activos, un formato optimizado mucho más ligero de cargar y renderizar. Consulta [Conversión de paquetes de activos](/creator/content-creator-es/escenas-sdk7/optimizacion/performance-optimization.md#asset-bundle-conversion). De forma predeterminada, las vistas previas locales omiten este paso y cargan en su lugar los modelos sin procesar. Activa los activos optimizados para ejecutar esta misma conversión localmente cuando previsualices tu escena. Esto tiene dos ventajas: * La vista previa carga más rápido y funciona con más 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 activos 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**: marca **Optimizar activos** en el menú desplegable junto al **Preview** botón. * **Desde la CLI**: ejecuta `npm run start -- --local-ab`. ![](/files/879adfcec3bd09832ba7a41a179c631b353e62df) Con esta opción activada, el Explorer de Decentraland convierte los modelos 3D de la escena en paquetes de activos en tu máquina antes de cargarlos. La conversión es casi instantánea para la mayoría de las escenas, pero la primera vista previa puede tardar más si la escena tiene activos muy pesados. Los modelos convertidos se almacenan en caché, así que en vistas previas posteriores solo necesitan convertirse los activos nuevos o modificados. {% hint style="info" %} **💡 Consejo**: Si la conversión de un activo 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 contar con permisos otorgados por alguien que sí lo sea. Consulta [publicación](/creator/content-creator-es/escenas-sdk7/publicacion/publishing.md) para ver instrucciones sobre cómo hacerlo. ## Tamaño de la escena en vista previa 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. ![](/files/4af1a7c932e612aad846331c3fa69df9951eb3f0) Usa los menús desplegables y haz clic en **Aplicar diseño** para cambiar las dimensiones de tu escena. También puedes hacer clic en cada parcela individual para desactivarla de tu diseño. ![](/files/fa794278bb0105866e888649fcd46b3ee09127ce) También puedes editar el *scene.json* archivo para enumerar varias parcelas en el campo "parcels". Consulta [configurar parcelas mediante la línea de comandos](/creator/content-creator-es/escenas-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 usará realmente tu escena, siempre que sean adyacentes y estén dispuestas en la misma forma. Tendrás que reemplazarlas más adelante 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 ![](/files/5181ddfcf5ca0469e5b3bde5819cd0c448cebc2f) 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, en caso de que necesites ver más texto. ## Prueba una escena multijugador localmente Si inicias una vista previa de la escena y la abres en dos (o más) ventanas diferentes del Explorer, cada ventana abierta se interpretará como un jugador independiente y un servidor de comunicaciones simulado mantendrá sincronizados a estos jugadores. Interactúa con la escena en una ventana y luego cambia a la otra para ver que los efectos de esa interacción también son visibles allí. Usando Creator Hub, haz clic en el botón Preview una segunda vez, y eso 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. ![](/files/b796cc98872223854364138fce8b5a291451351d) 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 activar [activos 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 paquetes ya publicados en los servidores. {% endhint %} En escenas pesadas con muchos modelos 3D, puedes acelerar la carga y la recarga de la escena reutilizando los [asset bundles](/creator/content-creator-es/escenas-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 optimizar. Esto es especialmente útil cuando iteras sobre cambios solo de código. Para activar 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 assets de arte ya estén publicados, con sus paquetes de activos completamente procesados por los servidores de contenido. Si has añadido nuevos assets, no aprovecharás la carga optimizada, ya que se cargarán como archivos gltf sin procesar, tal como ocurre cuando ejecutas una vista previa normal. Pero si modificaste localmente un asset que ya estaba publicado, manteniendo el mismo nombre de archivo, entonces verás la versión publicada antigua de ese asset. En ese caso, vuelve a desplegar primero la escena, espera a que se generen los paquetes de activos (consulta [Conversión de paquetes de activos](/creator/content-creator-es/escenas-sdk7/optimizacion/performance-optimization.md#asset-bundle-conversion)), y luego reanuda el uso de este modo para iterar solo en 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.decentraland.org/creator/content-creator-es/escenas-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 optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.