> 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/depuracion/troubleshooting.md).

# Solución de problemas

## Depura con un asistente de IA

Antes de profundizar en los problemas de abajo, considera pasarle el problema a un asistente de IA, como el chat de Cursor, GitHub Copilot o Claude Code. Pega el mensaje de error de la consola, o describe qué no está funcionando como se espera, y normalmente puede encontrar el problema en el código de tu scene y corregirlo por ti.

Para obtener buenos resultados, asegúrate de que la IA tenga instaladas las skills de Decentraland SDK. Las skills le enseñan los patrones y restricciones del SDK, para que no adivine basándose en información genérica o desactualizada. Instálalas ejecutando este comando en el proyecto de tu scene:

```bash
npx skills add decentraland/sdk-skills
```

Ver [Vibe Coding con IA](/creator/content-creator-es/escenas-sdk7/primeros-pasos/vibe-coding.md) para más detalles sobre cómo configurar y dar indicaciones a asistentes de IA.

## Problemas al ejecutar la preview

#### Problema: No puedo ejecutar ninguna preview de la scene, el mensaje de error menciona **Permisos denegados** o **EACCES**

Tu sistema operativo no te permite editar los permisos de la carpeta donde quieres ejecutar el proyecto. Al ejecutar la scene, hay que instalar algunas dependencias, pero está prohibido. Necesitas configurar los permisos de la carpeta para permitir que tu cuenta de usuario de Windows/Mac/Linux pueda editar los archivos que contiene.

Recursos útiles:

* [docs.npmjs](https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally)
* [letscodepare](https://letscodepare.com/blog/npm-resolving-eacces-permissions-denied)

#### Problema: No puedo ejecutar la preview de una scene concreta, el error dice **Error: Error al compilar el proyecto**

Si estás ejecutando una scene que compartieron contigo, asegúrate de que esta scene no se haya compartido incluyendo una carpeta `node_modules` o `bin` o un `package-lock.json` archivo. Estos archivos contienen dependencias que usan versiones específicas para tu sistema operativo y tu máquina; deberían generarse al ejecutar la scene por primera vez. Elimina estas carpetas y el archivo manualmente, luego ejecuta `npm run start` de nuevo.

#### Problema: Al ejecutar `npm run start` se ejecuta, no aparece ningún mensaje de error, pero no se abre ninguna ventana del navegador ni aparece ninguna URL en la salida para abrir la preview

Asegúrate de que tu versión de Node esté actualizada. Debe ser 20 o superior.

#### Problema: Al ejecutar `npm run start` abre una pestaña del navegador, pero la pantalla de carga nunca termina de cargar, o veo un banner de error rojo que dice "critical error".

* Asegúrate de tener instalada en tu proyecto la última versión de Decentraland SDK. Ejecuta:

  `npm i @dcl/sdk@latest`

#### Problema: La scene se ejecuta, en la consola veo `dependencias cíclicas` advertencias.

Estas se refieren a archivos de tu scene que se referencian mutuamente. Esto no es necesariamente un problema, pero no es un patrón recomendable para escribir software, ya que puede provocar condiciones de carrera difíciles de depurar y otros problemas. Es probable que tu scene funcione bien a pesar de estas advertencias.

Idealmente, la carga del código en tu scene debería seguir un orden secuencial claro. El código que tiene dependencias cíclicas puede sufrir un problema de gallina y huevo, donde el compilador no sabe cuál iniciar primero. A menudo esto se resuelve sin problemas, pero es una buena práctica evitarlo.

Para corregir estas dependencias, a menudo debes recurrir a llamar funciones o constructores de objetos pasando referencias a entidades/objetos ya instanciados en los argumentos de la función; en lugar de codificar de forma fija referencias a estas entidades/objetos en la función, que pueden o no estar ya instanciados.

## Problemas al desplegar

#### Problema: No tienes permisos para desplegar en estos parcels

* Asegúrate de que el `scene.json` archivo de tu scene enumere correctamente las coordenadas donde quieres desplegar.
* Asegúrate de que Metamask esté configurado correctamente para usar el wallet adecuado para firmar la transacción. Este puede ser el wallet que posee los tokens LAND, o puede tener permisos de operador concedidos por el propietario.

#### Problema: Al ejecutar `npm run deploy` falla

* Revisa los spawn points de tu scene; las tres coordenadas x,y,z de un spawn point deben ser un número o un rango. O bien las tres son números o bien las tres son rangos. No se admite tener rangos para algunas y números para otras.

  Por ejemplo, esto no se admite:

  `"position": {"x": [1,4], "y": 0, "z": [1,4]}`

  Esto sí se admite:

  `"position": {"x": [1,4], "y": [0,0], "z": [1,4]}`
* Es posible que el servidor catalyst predeterminado al que se te asignó desplegar esté caído o tenga problemas. Puedes forzar el `npm run deploy` comando para desplegar en un servidor catalyst específico en su lugar. Para desplegar en un servidor específico en el Decentraland Editor:

  1. Abre tu scene y haz clic en **Publish**
  2. Selecciona la opción **Publish to a different server** en la parte inferior.
  3. En el dropdown, selecciona **Custom Server**
  4. Introduce la dirección del servidor, por ejemplo `peer-testing.decentraland.org`
  5. Haz clic en **Publish to custom server**
  6. Aprueba la transacción como en un despliegue normal.

  Para hacerlo mediante la CLI:

  `npm run deploy -- --target-content <server-name>`

  Por ejemplo:

  `npm run deploy -- --target-content peer-ec1.decentraland.org`

  Ver [catalyst-monitor](https://decentraland.github.io/catalyst-monitor/) para comprobar el estado de todos los servidores de la red catalyst. También puedes copiar las direcciones de cada uno desde la parte superior de cada tarjeta.
* Revisa el `package.json`. Un problema común es que haya una sección `bundleDependencies` y también una `bundledDependencies` (con una d extra). Esto a veces puede deberse a ejecutar distintas versiones de Node en el mismo proyecto en momentos diferentes, o a compartir el proyecto entre personas que lo ejecutaron con distintas versiones de Node instaladas. Elimina `bundleDependencies`, que se relaciona con versiones anteriores de Node.

Asegúrate también de tener tu versión de Node actualizada, al menos la versión 20.

#### Problema: Al ejecutar `npm run deploy` o `npm run build` informa de errores de tipo

Tu scene podría tener errores de tipo reportados por TypeScript, por ejemplo indicando que una determinada variable podría ser de tipo `any` o que `undefined` o `null` no están permitidos. Al ejecutar `npm run deploy`también se ejecuta `npm run build`TypeScript `npm run start`.

, que es un poco más estricto con estas comprobaciones que `undefined`. A diferencia de JavaScript, TypeScript aplica tipado estricto a todas las variables. Aunque tu scene esté escrita de tal manera que, por ejemplo, un cierto valor nunca vaya a ser

Como alternativa, puedes ejecutar `npm run deploy -- --skip-build` para omitir la ejecución de `npm run build`y evitar que se ejecuten estas comprobaciones.

#### Problema: Desplegué mi scene pero no veo los cambios cuando entro a Decentraland

* Ten en cuenta que puede tardar unos minutos en propagarse el contenido nuevo a través de todos los servidores de la red catalyst; dale un poco de tiempo.

#### Problema: Una vez desplegada, faltan algunos modelos 3D

* Asegúrate de que todos los modelos 3D estén dentro de los límites de la scene, incluidas sus cajas delimitadoras. Si alguna parte de tus modelos se extiende más allá de estos límites al ejecutar una preview, esas partes que sobresalgan se recortarán y no se renderizarán, tanto al ejecutar una preview como en la scene publicada.

#### Problema: Una vez desplegados, mis modelos 3D se ven diferentes

* Si las texturas se ven diferentes, ten en cuenta que las texturas de los modelos 3D tienen un tamaño máximo de 512x512 píxeles. Esta conversión se realiza para garantizar que Decentraland funcione sin problemas para todos.
* Si los modelos se ven diferentes, podría haber un problema con la conversión de los modelos a asset bundles. Lee más sobre la compresión de asset bundles [aquí](/creator/content-creator-es/escenas-sdk7/optimizacion/performance-optimization.md#asset-bundle-conversion).

  Para validar esto, prueba a ejecutar la scene con el parámetro de URL `&DISABLE_ASSET_BUNDLES`. Si los modelos se ven bien con esta bandera, el problema debe estar relacionado con un error en la conversión del modelo.

  Ten en cuenta que la generación de versiones comprimidas de asset-bundle de tus modelos es un proceso que requiere tiempo en los servidores (aproximadamente una hora). Puedes comprobar si los modelos se están cargando como asset bundles comprimidos o no escribiendo el siguiente comando en la ventana del chat `/detectabs`. Los modelos comprimidos se tiñen de verde, los no comprimidos se tiñen de rojo.

#### Problema: Mi scene tiene un FPS bajo en producción, aunque funciona sin problemas en la preview.

El rendimiento de tu scene podría verse afectado por scenes vecinas que siguen malas prácticas, ya que también se ejecutan en paralelo. Puedes comprobar si ese es el caso abriendo la configuración y estableciendo la línea de visión al mínimo, de modo que solo se cargue 1 parcel alrededor de tu scene actual.

Puedes reducir aún más la línea de visión ejecutando tu scene con el parámetro `&LOS=0`, para no cargar ninguna scene circundante en absoluto.

Si acabas de desplegar tu scene, la carga al ejecutar la scene también podría reducirse una vez que los servidores conviertan los modelos 3D de la scene en asset bundles comprimidos. Puedes comprobar si los modelos se están cargando como asset bundles comprimidos o no escribiendo el siguiente comando en la ventana del chat `/detectabs`. Los modelos comprimidos se tiñen de verde, los no comprimidos se tiñen de rojo.

### Reportar un error

Si encuentras un problema que no está en tu scene, sino en el Decentraland SDK en general, por favor consulta [Reportar un error](/creator/content-creator-es/escenas-sdk7/depuracion/report-bug.md).


---

# 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/depuracion/troubleshooting.md?ask=<question>&goal=<endgoal>
```

`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.