> 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 para ayudarte 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 sobre él. Si esto ocurre, hay varios lugares donde puedes buscar mensajes de error para ayudarte a entender qué salió mal:

1. Revisa tu editor de código para asegurarte de que no haya marcado ningún error de sintaxis o de lógica.
2. Revisa la consola en 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 en la esquina superior derecha.
3. Si ejecutaste la escena usando Creator Hub, revisa la ventana con la salida de la consola de la escena. Si ejecutaste la escena usando 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](/creator/content-creator-es/scenes-sdk7/publicacion/publishing-options.md#decentraland-worlds) para probarla en un contexto mucho más cercano a producción.
{% endhint %}

## Usa 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 en la esquina superior derecha.

También puedes alternarla pulsando la tecla de acento grave en tu teclado: **`**. Esta tecla está a la izquierda de la tecla 1 en la mayoría de los teclados en inglés. O, de lo contrario, pulsa Shift + **\`** para abrir una vista más amplia de la consola, en caso de que necesites ver más texto.

Envía mensajes a la consola (usando `console.log()`). Luego puedes ver estos mensajes a medida que se generan abriendo la consola de la escena.

La consola también muestra mensajes de error; estos se marcan 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-92fe4dd70621a496d0da083ae9b5f9b2ef84d2dd%2Fdebug-icon.png?alt=media\&token=42a33cd5-b516-43ea-a6b3-8c33c21e4359) icono en la esquina superior derecha.

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

![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-ccb91c00f390553253215ec2c18eef6d50f22c5c%2Fdebug-panel.png?alt=media\&token=9ed3d1ce-b3de-48ab-9cca-df617ebc0ff9)

### Escena actual

La **ESCENA ACTUAL** pestaña incluye información sobre la escena en la que te encuentras actualmente. Esto incluye:

* El número de parcelas en la escena
* La altura máxima a la que se te permite construir (330 metros para cada escena)

También puedes comprobar la opción **Mostrar límites de la escena** para ver paredes rojas alrededor de la escena, que marcan los límites de la escena.

### Memoria

La **MEMORIA** sección muestra la memoria usada por Decentraland. Intenta mantener siempre este valor por debajo de los **umbrales del presupuesto de memoria**. Si este valor crece demasiado, corre el riesgo de que la aplicación se cierre para los jugadores que visiten tu escena. Ten en cuenta que en producción, la escena podría cargarse junto con otras escenas y jugadores cercanos, lo que puede contribuir a aumentar el consumo de memoria por encima de lo que ves en la vista previa.

### Rendimiento

La **RENDIMIENTO** pestaña incluye varios campos relacionados con *FPS* (Frames Per Second). Este valor tenderá a ser menor a medida que la escena gane complejidad; asegúrate de mantener siempre este valor por encima de 25 FPS para garantizar una buena experiencia para tus jugadores. El FPS variará según la máquina en la que lo ejecutes.

El valor más importante aquí es el **FPS medio**, que redondea el 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-5476d0417a1f29680ff83a9352543acb34dc1ce6%2Ffps-debug-panel.png?alt=media\&token=e913e876-f4ba-4288-a1d1-7bb3657634b9)

{% hint style="warning" %}
**📔 Nota**: El FPS del renderizador no es el mismo que las actualizaciones por segundo del bucle del juego de la escena. La lógica de la escena está limitada a 30 FPS; el FPS del renderizador puede llegar a 60 o más.
{% endhint %}

Los tirones se refieren a pausas momentáneas en la tasa de fotogramas, que pueden tener poco impacto en el número total de FPS pero resultar muy notorias para el jugador. Normalmente pueden ocurrir cuando se cargan assets pesados o 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 realizadas por la escena y su contenido. Esto es útil para saber si la escena está haciendo demasiadas solicitudes a servidores, lo que puede afectar al rendimiento de la escena.

Si tu escena interactúa con un servidor 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](/creator/content-creator-es/scene-editor/primeros-pasos/editor-installation.md), ya que las dependencias necesarias vienen incluidas con esa instalación.

No necesitas tener Creator Hub abierto ni ejecutar la vista previa de tu escena a través de Creator Hub para usar esta función; también puede usarse si estás usando la CLI para ejecutar la vista previa de tu escena.
{% endhint %}

Como alternativa, hay varias herramientas gratuitas que puedes ejecutar en tu máquina y que informan de 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 hagas cambios en la escena, la vista previa se recarga y se actualiza automáticamente, así que no hay necesidad de abrir y cerrar la ventana de vista previa.

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

![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-aee1c0d965e8eb0be4dce2269a40c7bd34e3a867%2Freload-button.png?alt=media\&token=1c3606d7-cfb0-4588-9371-74003b685655)

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

`/reload`

## Informar de un error

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

## Versiones de las dependencias

Asegúrate de usar siempre las últimas versiones de todas las dependencias de tu escena, ya que cualquier problema que estés experimentando podría ya estar solucionado en versiones más nuevas. Creator Hub te notificará cuando haya actualizaciones 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-dfb7f58f6d4c56c78eb70530feed95cf300b0876%2Fnew-dependencies.png?alt=media\&token=c4781a34-65b5-4b90-bec1-74696f2c64eb)

También puedes actualizar manualmente las dependencias mediante la línea de comandos. Ejecutar una escena de Decentraland localmente depende de dos bibliotecas principales: `@dcl/sdk` y `@dcl/js-runtime`, que se instala en cada carpeta del proyecto. Asegúrate de que ambas estén actualizadas. Puedes ejecutar los siguientes comandos para actualizar manualmente ambas 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 estar usando la biblioteca `@dcl/asset-packs` que puedes actualizar mediante:

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

Si estás usando 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 pueden no ser compatibles con versiones más nuevas de `@dcl/sdk`.

## Condiciones de iluminación

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

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

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

Los materiales de tu modelo 3D pueden no verse igual que en la herramienta de modelado con la que lo creaste. Esto es de esperar, ya que todos los motores de renderizado 3D tienen diferencias sutiles en cómo manejan la luz y los materiales.

También puedes configurar tu escena para que la hora del día sea fija y la iluminación no cambie. Consulta [Control de skybox](/creator/content-creator-es/scenes-sdk7/interactividad/skybox-control.md) para más detalles.

## Pruebas multijugador

Si inicias una vista previa de la escena y la abres en dos ventanas de Explorer diferentes, cada ventana abierta se interpretará como un jugador distinto, y un servidor ficticio de comunicaciones mantendrá a estos jugadores sincronizados.

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, activa **Multi-Instance Preview** en el submenú **Desktop Client** de **Play Options**, luego haz clic en el **Play** por segunda vez para abrir una segunda ventana de Explorer de Decentraland. Debes conectarte en ambas ventanas con direcciones diferentes. Las mismas sesiones permanecerán abiertas mientras la escena se recarga. Puede que necesites cerrar sesión y volver a iniciarla en la segunda ventana para seleccionar una cuenta diferente.

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

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

Como alternativa, puedes abrir una segunda ventana de Explorer de Decentraland escribiendo la siguiente URL en un navegador:

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

## Usando la red de pruebas de Ethereum

Mientras pruebas tu escena, para evitar transferir MANA real u otras divisas, puedes usar la red de pruebas Sepolia de Ethereum y transferir en su lugar MANA falsa de testnet.

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

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

Cualquier transacción que aceptes mientras ves la escena en este modo solo ocurrirá en la red de pruebas y no afectará al saldo de MANA en tu wallet real.

Para previsualizar tu escena usando la red de pruebas, 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 a las coordenadas de tu escena para cargar directamente en tu escena. Cualquier transacción que aceptes mientras ves la escena en este modo solo ocurrirá en la red de pruebas y no afectará al saldo de MANA en tu wallet real.
{% endhint %}

Si necesitas probar transacciones en la Testnet de Polygon y necesitas tener MANA en esa testnet, tendrás que intercambiar MANA a esa red después de obtenerlo en Sepolia. Para puentear MANA de Sepolia a la Testnet de Polygon, visita la página de tu cuenta de Decentraland en Sepolia y haz clic en ‘swap’ 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.
