> 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/depuracion/debug-in-preview.md).

# Depurar en la vista previa

Cómo puedes depurar tu escena mientras la ejecutas localmente en la vista previa

Ejecutar una vista previa proporciona información y herramientas útiles de depuración que te ayudan a entender cómo se renderiza la escena.

Si la escena no se puede compilar, solo verás el suelo vacío, sin nada renderizado. Si esto ocurre, hay varios lugares donde puedes buscar mensajes de error que te ayuden a entender qué salió mal:

1. Revisa tu editor de código para asegurarte de que no haya marcado errores de sintaxis o de lógica.
2. Revisa la consola de la ventana de vista previa para ver si hay mensajes de error. 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.
3. Si ejecutaste la escena con Creator Hub, revisa la ventana con la salida de la consola de la escena. Si ejecutaste la escena con la CLI, revisa la salida de la línea de comandos donde ejecutaste `npm run start`

{% hint style="info" %}
**💡 Consejo**: Antes de publicar tu escena en el entorno de producción, puedes publicarla en un [Decentraland World](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/publicacion/publishing-options.md#decentraland-worlds) para probarla en un contexto mucho más parecido al de producción.
{% endhint %}

## Usar la consola

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.

También puedes mostrarla u ocultarla presionando la tecla de acento grave () del teclado: **`**. Esta tecla está a la izquierda de la tecla 1 en la mayoría de los teclados en inglés. También puedes presionar Shift + **\`** para abrir una vista más amplia de la consola, por si necesitas ver más texto.

Envía mensajes a la consola (con `console.log()`). Después puedes ver estos mensajes a medida que se generan, abriendo la consola de la escena.

La consola también muestra mensajes de error, que aparecen en rojo.

## El panel de depuración

Abre la consola de depuración haciendo clic en el ![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-9af92d7a9edeb4111484adc136865c46bf27e9e1%2Fdebug-icon.webp?alt=media) icono de la esquina superior derecha.

Esto abre un panel en la esquina inferior derecha con información sobre el motor de renderizado, que se actualiza en tiempo real a medida que cambian las cosas.

![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a66a852a3c9f55e2dd178b31e52601c8d79746d8%2Fdebug-panel.webp?alt=media)

### Escena actual

La pestaña **CURRENT SCENE** incluye información sobre la escena en la que te encuentras. Incluye lo siguiente:

* La cantidad de parcelas de la escena
* La altura máxima a la que puedes construir (330 metros en cada escena)

También puedes activar la opción **Show Scene Bounds** para ver paredes rojas alrededor de la escena, que marcan sus límites.

### Memoria

La sección **MEMORY** muestra la memoria que utiliza Decentraland. Procura mantener este valor por debajo de los **umbrales del presupuesto de memoria**. Si este valor aumenta demasiado, la aplicación podría fallar para los jugadores que visiten tu escena. Ten en cuenta que, en producción, la escena podría cargarse junto con otras escenas cercanas y con otros jugadores, lo que puede aumentar el consumo de memoria por encima de lo que ves en la vista previa.

### Rendimiento

La pestaña **PERFORMANCE** incluye varios campos relacionados con los *FPS* (fotogramas por segundo). Este valor tenderá a disminuir a medida que aumente la complejidad de la escena. Procura mantenerlo siempre por encima de 25 FPS para garantizar una buena experiencia a los jugadores. Los FPS variarán según la máquina en la que ejecutes la escena.

El valor más importante aquí es **Average FPS**, que calcula el promedio de FPS de los últimos 1000 fotogramas.

![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-27c0293cff82265d4eb7d6b6506e23e210d2b016%2Ffps-debug-panel.webp?alt=media)

{% hint style="warning" %}
**📔 Nota**: El bucle de juego de la escena se ejecuta al mismo ritmo que el renderizador. Tus Systems se ejecutan una vez por cada frame renderizado, por lo que los FPS que se muestran aquí también indican cuántas veces por segundo se actualiza la lógica de tu escena.
{% endhint %}

Los pequeños tirones son pausas momentáneas en la tasa de fotogramas que quizá apenas afecten al número total de FPS, pero que pueden resultar muy evidentes para el jugador. Suelen producirse cuando se cargan Assets pesados o en situaciones similares.

### Solicitudes web

La **SOLICITUDES WEB** sección te permite abrir la pestaña Network de Chrome DevTools, que muestra el número de solicitudes web que realiza la escena y su contenido. Esto resulta útil para saber si la escena hace demasiadas solicitudes a los Servers, lo que puede afectar a su rendimiento.

Si tu escena interactúa con un Server de terceros, suele ser útil ver qué datos entran y salen. Haz clic en **Abrir Chrome DevTools** para abrir una nueva ventana de Chrome con la pestaña Network abierta.

{% hint style="warning" %}
**📔 Nota**: Para usar esta función, primero debes instalar [Creator Hub](https://docs.decentraland.org/creator/content-creator-es/scene-editor/primeros-pasos/editor-installation.md), ya que las dependencias necesarias vienen incluidas en esa instalación.

No es necesario que tengas Creator Hub abierto ni que ejecutes la Preview de tu escena desde Creator Hub para usar esta función. También puedes usarla si ejecutas la Preview de tu escena con la CLI.
{% endhint %}

Como alternativa, hay varias herramientas gratuitas que puedes ejecutar en tu equipo para mostrar todos los datos que entran y salen de la aplicación Decentraland. Por ejemplo, [Charles](https://www.charlesproxy.com/) o [Wireshark](https://www.wireshark.org/).

## Recarga rápida

Cada vez que haces cambios en la escena, la Preview se recarga y se actualiza automáticamente, así que no hace falta cerrar y volver a abrir la ventana de Preview.

Si necesitas recargar la escena en la que estás, haz clic en el botón **Recargar escena** en la esquina superior izquierda de la ventana de Preview.

![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-1ff6d67c0b7a28f78caa13019a9ccabeb3afe662%2Freload-button.webp?alt=media)

También puedes recargar la escena escribiendo lo siguiente en el chat y pulsando Intro:

`/reload`

## Informar de un error

Si encuentras un problema que no está relacionado con tu escena, sino con el SDK de Decentraland en general, consulta [Informar de un error](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/depuracion/report-bug.md).

## Versiones de las dependencias

Asegúrate de usar siempre las versiones más recientes de todas las dependencias de tu escena, ya que es posible que los problemas que tengas ya se hayan resuelto en versiones más recientes. Creator Hub te avisará cuando haya actualizaciones disponibles para instalar en tu escena de Decentraland.

![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-0ba6896aebac94a5ec9cc2365864a36e0e11e7dc%2Fnew-dependencies.webp?alt=media)

También puedes actualizar manualmente las dependencias desde la línea de comandos. Para ejecutar una escena de Decentraland localmente se necesitan dos bibliotecas principales: `@dcl/sdk` y `@dcl/js-runtime`, que se instala en la carpeta de cada proyecto. Asegúrate de que ambas estén actualizadas. Puedes ejecutar los siguientes comandos para actualizar manualmente estas dos bibliotecas a la última versión estable:

```
npm i @dcl/js-runtime@latest
npm i @dcl/sdk@latest
```

Si tu escena usa Smart items, también puede que use la biblioteca `@dcl/asset-packs` , que puedes actualizar con el siguiente comando:

```
npm i @dcl/asset-packs@latest
```

Si usas alguna de las [bibliotecas utils](https://studios.decentraland.org/resources?sdk_version=SDK7\&resource_type=Library) asegúrate de que también estén actualizadas, ya que las versiones anteriores de estas bibliotecas podrían no ser compatibles con las versiones más recientes de `@dcl/sdk`.

## Condiciones de iluminación

La hora del día en el mundo tiene un gran impacto en el aspecto de los modelos 3D. El color de la fuente de luz cambia sutilmente: adquiere un tono azulado por la noche y rojizo durante el amanecer y el atardecer. La dirección de la luz también cambia a medida que se desplaza por el cielo, proyectando sombras en distintas direcciones.

Comprueba que tu escena se vea bien a cualquier hora del día cambiando el reloj del juego a distintos valores. Haz clic en **hora del skybox** el ícono del panel izquierdo de la pantalla para establecer la hora que prefieras. Si este control deslizante aparece en gris, asegúrate de que la opción **Auto** esté desactivada.

<figure><img src="https://github.com/decentraland/docs/blob/main/creator/images/daylight-settings.webp" alt="Dynamic skybox" width="300"><figcaption><p>Instrucciones dentro del mundo</p></figcaption></figure>

Es posible que los materiales de tu modelo 3D no se vean igual que en la herramienta de modelado con la que lo creaste. Es de esperar, ya que todos los motores de renderizado 3D presentan diferencias sutiles en la forma de procesar la luz y los materiales.

También puedes configurar tu escena para fijar la hora del día y evitar que cambie la iluminación. Consulta [Control del Skybox](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/interactividad/skybox-control.md) para obtener más información.

## Pruebas multijugador

Si inicias la vista previa de una escena y la abres en dos (o más) ventanas distintas del Explorer, cada ventana abierta se interpretará como un jugador independiente y un servidor de comunicaciones simulado mantendrá a estos jugadores sincronizados.

Interactúa con la escena en una ventana y luego cambia a la otra para comprobar que los efectos de esa interacción también sean visibles allí.

En Creator Hub, activa **Vista previa de varias instancias** en el submenú **Cliente de escritorio** de **Opciones de juego**, luego haz clic en el botón **Jugar** una segunda vez para abrir una segunda ventana de Decentraland Explorer. Debes conectarte en ambas ventanas con direcciones distintas. Las mismas sesiones permanecerán abiertas mientras se vuelve a cargar la escena. Es posible que tengas que cerrar sesión y volver a iniciarla en la segunda ventana para seleccionar otra cuenta.

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

Ambos jugadores se verán y podrán interactuar entre sí. Si la escena incluye lógica multijugador, funcionará como se espera y se sincronizará entre los dos jugadores.

Como alternativa, puedes abrir una segunda ventana de Decentraland Explorer escribiendo lo siguiente en la barra de direcciones del navegador:

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

## Usar la red de prueba de Ethereum

Al probar tu escena, para evitar transferir MANA real u otras monedas, puedes usar la red de prueba Ethereum Sepolia y transferir MANA de prueba ficticio.

Para usar la red de prueba, debes configurar la extensión de Chrome Metamask para que utilice la *red de prueba Sepolia* en lugar de la *red principal*. También debes tener MANA en la blockchain Sepolia, que puedes obtener gratis en Decentraland.

{% hint style="info" %}
**💡 Consejo**: Para realizar la transacción de transferencia de MANA de Sepolia a tu wallet, tendrás que pagar una comisión de gas en Ether de Sepolia.
{% endhint %}

Las transacciones que aceptes mientras ves la escena en este modo solo se realizarán en la red de prueba y no afectarán el saldo de MANA de tu wallet real.

Para obtener una vista previa de tu escena usando la red de prueba, pega la siguiente URL en una pestaña del navegador. Esto abrirá la escena en el cliente de escritorio de Decentraland:

> decentraland://realm=<http://127.0.0.1:8000\\&local-scene=true\\&debug=true\\&dclenv=zone\\&position=0,0>

{% hint style="info" %}
**💡 Consejo**: Cambia el parámetro position por las coordenadas de tu escena para cargarla directamente. Cualquier transacción que aceptes mientras ves la escena en este modo solo se realizará en la red de prueba y no afectará el saldo de MANA de tu wallet real.
{% endhint %}

Si necesitas probar transacciones en la red de prueba de Polygon y tener MANA en esa red, tendrás que intercambiar MANA a esa red después de obtenerlo en Sepolia. Para transferir MANA de Sepolia a la red de prueba de Polygon, visita la página de tu cuenta de Decentraland en Sepolia y haz clic en «intercambiar», en el lado de MANA de Ethereum.


---

# 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/depuracion/debug-in-preview.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.
