> 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/optimizacion/performance-optimization.md).

# Optimización del rendimiento

Optimiza tu escena para que cargue rápido y funcione sin problemas para todos los jugadores.

Hay varios aspectos que puedes optimizar en tus escenas para ofrecer la mejor experiencia posible a quienes las visitan. Este documento incluye algunas prácticas recomendadas que pueden marcar una gran diferencia en la velocidad de carga de tu escena y en la fluidez con la que funciona para los jugadores que están en ella o en escenas vecinas.

Ten en cuenta que muchos jugadores pueden visitar Decentraland con hardware que no está diseñado para jugar, a través del navegador o desde la [aplicación móvil](https://docs.decentraland.org/creator/content-creator-es/desarrollar-para-movil/cliente-movil/overview.md) en un teléfono; todo esto limita la capacidad de procesamiento disponible para tu escena. La experiencia al visitar tu escena debería ser fluida para todos.

{% embed url="<https://www.youtube.com/watch?v=tc1PwYKW1Kc>" %}

Consulta [Recursos útiles](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/primeros-pasos/useful-resources.md) para encontrar herramientas que puedan ayudarte, como Decentraland Scene Optimizer, que extrae, deduplica y comprime las texturas de los modelos 3D de tu escena.

{% hint style="info" %}
**📱 Móvil**: los dispositivos móviles suelen ser los clientes con recursos más limitados. Si tu escena está dirigida a jugadores móviles, consulta también [Desarrollar para móviles](https://docs.decentraland.org/creator/content-creator-es/desarrollar-para-movil/cliente-movil/overview.md) para obtener recomendaciones específicas para móviles.
{% endhint %}

El Explorer de Decentraland aplica muchas optimizaciones a nivel del Engine. Estas optimizaciones marcan una gran diferencia, pero es todo un reto renderizar simultáneamente en un navegador varias experiencias creadas por los usuarios. Necesitamos tu ayuda para que todo funcione sin problemas.

## Temporización

### Reproducción de videos

La reproducción de videos es una de las tareas que más recursos exige al Engine. Si tu escena incluye videos, asegúrate de que solo haya *UNA* VideoTexture en uso a la vez. Puedes tener decenas de planos que compartan la misma VideoTexture sin que el rendimiento se vea afectado de forma significativa, pero al añadir una segunda VideoTexture, sus efectos en la frecuencia de fotogramas se vuelven muy perceptibles.

También deberías evitar reproducir videos en zonas donde no se puedan ver. Por ejemplo, si tienes una pantalla en interiores, activa y desactiva el video mediante un TriggerArea según si el jugador entra o sale.

{% hint style="info" %}
**💡 Consejo**: un truco que han usado varias escenas consiste en transmitir un solo video con varias regiones asignadas de forma distinta a diferentes planos. Cada pantalla de video usa [el mapeado UV](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/fundamentos-del-contenido-3d/materials.md#using-textures) para mostrar solo una parte distinta de la VideoTexture. Así, puede parecer que se reproducen videos independientes, sin el costo de usar varias VideoTexture.
{% endhint %}

{% hint style="info" %}
**💡 Consejo**: cuando los jugadores están fuera de tu escena, las VideoTexture no se actualizan en cada fotograma. Esto ayuda a reducir el impacto en las escenas circundantes. Aun así, lo ideal es iniciar la reproducción de los videos solo cuando los jugadores [entren en tu escena](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/interactividad/event-listeners.md#player-enters-or-leaves-scene) .
{% endhint %}

### Carga diferida

Si tu escena es grande o tiene zonas interiores que no siempre están a la vista, puedes optar por no cargar desde el principio todas las Entities. En su lugar, carga el contenido por región a medida que el jugador visita distintas partes de la escena. Esto puede reducir considerablemente el tiempo de carga de la escena y también la cantidad de texturas y contenido 3D que el Engine debe procesar en cada fotograma.

Por ejemplo, el edificio principal de un museo podría cargarse desde el principio, mientras que las pinturas de cada piso se cargarían para cada jugador a medida que visita ese piso.

Consulta [esta escena de ejemplo](https://github.com/decentraland-scenes/lazy-loading) para ver cómo podría funcionar.

Para obtener el mejor resultado y evitar interrupciones, oculta las Entities cambiando la propiedad `visible` de su Shape a false. Con este enfoque, las añades al Engine al crearlas, pero simplemente no haces visibles sus modelos.

Otra opción es no añadir las Entities al Engine hasta que sean necesarias. Esto puede causar algunas interrupciones cuando aparecen por primera vez, y también podrían tardar un par de segundos en hacerse visibles. La ventaja de este enfoque es que permite sortear las [limitaciones de la escena](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/optimizacion/scene-limitations.md). Ten en cuenta que el recuento de las limitaciones de la escena corresponde al contenido que se está renderizando en ella en un momento dado, no a todo el contenido que podría renderizarse. Cargar y descargar partes de la escena debería permitirte sortear esas limitaciones.

{% hint style="warning" %}
**📔 Nota**: las Entities que no son visibles, pero que se añaden al Engine, cuentan para las limitaciones de la escena.
{% endhint %}

También puedes activar o desactivar las animaciones de las Entities que estén lejos o tapadas. Por ejemplo, si un NPC reproduce una animación de reposo muy sutil, puedes hacer que solo la reproduzca cuando el jugador esté a menos de 20 metros. Usa un TriggerArea alrededor del NPC y activa o desactiva sus animaciones según corresponda.

{% hint style="info" %}
**💡 Consejo**: cuando una Entity está lo bastante lejos y es lo bastante pequeña, el Engine la descarta. Este descarte ayuda a nivel de draw calls, pero siempre es mejor quitar las Entities del Engine. Además, este descarte no tiene en cuenta la oclusión por parte de otras Entities, por lo que las Entities que no son tan pequeñas pero están ocultas detrás de una pared siguen renderizándose.
{% endhint %}

### Bloques asíncronos

Los bloques de [código asíncrono](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/patrones-de-programacion/async-functions.md) no bloquean el avance de todo lo demás mientras esperan: la escena sigue ejecutándose y el bloque asíncrono se reanuda cuando llega la respuesta esperada. Ten en cuenta que las escenas se ejecutan en un solo hilo, así que esto no es procesamiento paralelo; simplemente evita que la escena se detenga mientras espera respuestas externas.

Cualquier proceso que dependa de respuestas de servicios asíncronos, como `getPlayerData()` o `getRealm()` siempre debe ejecutarse en bloques async, ya que, de lo contrario, bloquea la carga del resto de la Scene mientras espera una respuesta. Lo mismo se aplica a cualquier llamada a servidores de terceros.

Ten en cuenta que la Scene se considerará completamente cargada cuando haya terminado todo lo que no sea async. Es posible que los procesos async sigan ejecutándose cuando el jugador entre en la Scene. Evita situaciones en las que un proceso async provoque la carga de una Entity que pueda dejar al jugador atrapado dentro de su geometría.

### Usa Events

Procura que la lógica de la Scene dependa lo más posible de escuchar [Events](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/interactividad/event-listeners.md) en lugar de ejecutar comprobaciones en cada frame.

La `update()` Function de un [System](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/arquitectura/systems.md) se ejecuta en cada frame, tantas veces por segundo como el Engine renderiza frames (a menudo 60 o más). Evita realizar comprobaciones recurrentes si puedes suscribirte a un Event.

Por ejemplo, en lugar de comprobar constantemente los Wearables del jugador, puedes suscribirte al Event `onProfileChanged` y comprobar los Wearables del jugador solo cuando cambien.

Si debes usar un System, evita hacer comprobaciones o ajustes en cada frame. Puedes incluir un temporizador en la Function de actualización y ejecutar la comprobación solo una vez por segundo, o con la frecuencia que tenga sentido.

## Optimiza los modelos 3D

Hay varias formas de reducir el peso de tus modelos 3D.

Al trabajar con [Creator Hub](https://docs.decentraland.org/creator/content-creator-es/scene-editor/primeros-pasos/editor-installation.md), puedes consultar estadísticas sobre los recursos que usan los modelos 3D de tu Scene y ver si superan alguna de las [limitaciones de la Scene](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/optimizacion/scene-limitations.md).

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

Puedes expandir este menú para ver los detalles.

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

Aquí tienes algunos consejos para mejorar estas métricas:

* Siempre que sea posible, comparte las texturas entre los modelos 3D. Una buena práctica es usar una sola textura como mapa atlas, compartida por todos los modelos de la Scene. Es mejor tener una textura compartida grande de 1024x1024 píxeles que varias pequeñas.

  > Nota: Evita usar el mismo archivo de imagen para la textura de albedo y el mapa de normales o el mapa emisivo de un Material. Usa archivos separados, aunque sean idénticos. Asignar el mismo archivo de imagen a distintos tipos de propiedades de textura puede introducir artefactos visuales no deseados al comprimirlos en paquetes de Assets.
* *.glb* es un formato comprimido, por lo que siempre ocupará menos que un *.gltf*. Por otro lado, con *.gltf* es fácil compartir imágenes de texturas exportándolas como archivos separados. Puedes obtener lo mejor de ambos formatos con el [siguiente flujo de trabajo](https://github.com/AnalyticalGraphicsInc/gltf-pipeline), que permite tener *.glb* modelos con archivos de textura externos.
* Evita usar transparencias con mezcla. Estas deben omitir bastantes optimizaciones de renderizado. Si es posible, prioriza la geometría opaca o con alpha test.
* Evita usar Meshes con skinning. Pueden reducir considerablemente el rendimiento.

{% hint style="info" %}
**💡 Consejo**: Lee más sobre las prácticas recomendadas para modelos 3D en la \[sección de modelado 3D]\(/creator/3d-modeling/3d-models
{% endhint %}

### Cómo rescatar un modelo pesado en Blender

Cuando las estadísticas señalan un modelo concreto, suele ser más rápido corregirlo que buscar una solución alternativa en el código. Estas son las ediciones más útiles en Blender o en cualquier herramienta similar:

* **Reduce el número de triángulos** con el modificador Decimate. Es una herramienta para rescatar modelos que ya tienes. Para los modelos nuevos, es mejor crear desde el principio una geometría low-poly.
* **Reduce el tamaño de las texturas** a una potencia de dos, de 1024x1024 o menos, y vuelve a empaquetarlas en el archivo *.glb*.
* **Elimina las caras que el jugador nunca ve**, como la parte inferior y la parte trasera de los objetos. Activa el [back-face culling](#backface-culling) en lugar de duplicar la geometría.
* **Combina los Materials** en uno solo, utilizando una única Texture atlas en lugar de una Texture por pieza.
* **Elimina las luces, cámaras y Materials de las `_collider` Meshes.** El Engine los ignora, por lo que solo añaden peso.

Comprueba el número de Triangles y Materials antes y después y, a continuación, exporta el resultado sobre el mismo File. Si hay una Preview en ejecución, se volverá a cargar con los cambios.

### Reutilizar el mismo modelo muchas veces

Las Scenes suelen estar llenas de contenido repetido: farolas a lo largo de una calle, sillas en una habitación, árboles en un parque. La mejor forma de construirlos es la más sencilla:  **asigna a cada copia su propia Entity y haz que todas apunten al mismo File &#x20;*****.glb*****&#x20;.**

```ts
// BIEN: un File, muchas Entities
for (const position of lampPostPositions) {
  const lampPost = engine.addEntity()
  Transform.create(lampPost, { position })
  GltfContainer.create(lampPost, { src: 'assets/scene/lampPost.glb' })
}
```

El Engine reconoce que estas Entities comparten un mismo origen. El File se descarga una sola vez, se convierte una sola vez en un asset bundle y sus Meshes y Textures se almacenan una sola vez en memoria. La vigésima farola no tiene prácticamente ningún coste adicional, aparte de su propia posición en el World. Esto también funciona entre Scenes: si una Scene vecina utiliza el mismo File, este ya está en memoria. En cambio, exportar veinte Files  *.glb*  casi idénticos supone veinte descargas y veinte copias en memoria.

Lo que esto  **no**  reduce son las llamadas de Render. Veinte farolas son veinte objetos que hay que Render, tanto si proceden de veinte Entities como de un único File  *.glb*  que contiene veinte farolas modeladas. La única forma de reducir esa cantidad es unir las Meshes en tu herramienta de modelado, lo que supone un compromiso importante. Consulta  [Instanciación frente a duplicación y combinación](https://docs.decentraland.org/creator/content-creator-es/modelado-y-animaciones-3d/meshes.md#instancing-objects-vs-duplicating-objects)  para saber cuándo merece la pena.

Algunos consejos relacionados:

* **Agrupa en conjuntos en lugar de crear un modelo gigante.** Si tienes muchos objetos dispersos, una buena solución intermedia es utilizar un File  *.glb*  por grupo —una manzana de una calle o los muebles de una habitación— en lugar de un modelo por objeto o un solo modelo para toda la Scene. Así reduces el número de objetos y mantienes cada grupo lo bastante pequeño para que el culling siga siendo útil.
* **¿Vas a hacer Spawn de muchas copias a la vez?** Precarga primero el modelo con  [`AssetLoad` , un Component](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/optimizacion/pre-load-resources.md). Las copias se crean entonces a partir de un modelo que ya está en memoria, en lugar de que cada una espere a la misma descarga. Crear cada copia sigue requiriendo trabajo, por lo que una gran cantidad de copias de golpe puede costarte un fotograma en cualquier caso. La precarga elimina la espera del File, no el coste de crear las copias.
* **Un modelo muy grande exige más al Engine que muchos modelos pequeños.** El Engine distribuye el trabajo de construir la Scene entre varios fotogramas para evitar tirones, pero no puede dividir un único modelo enorme: todo el trabajo recae en un solo fotograma. Muchas piezas más pequeñas se cargan de forma fluida; una sola pieza monolítica tiene más probabilidades de provocar un tirón visible.
* **Repetir un modelo no introduce nuevas Textures ni geometría.** Veinte farolas construidas a partir de un solo modelo comparten las Meshes y Textures de ese modelo, en lugar de añadir otras nuevas. La vigésima no tiene ningún coste en memoria de Textures. Los Materials son la excepción: el Engine crea una instancia de Material por cada objeto Render para aplicar el Clipping en los límites de la Scene, de modo que el número de Materials depende del número de objetos que se Render, no del número de modelos que utilizas. Esas instancias siguen compartiendo las mismas Textures y variantes de Shader, por lo que consumen algo de memoria, pero no afectan al tiempo de fotograma. Lo que acerca a una Scene al  [límite](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/optimizacion/scene-limitations.md)  de Textures es tener muchos modelos  *diferentes* , cada uno con su propio conjunto específico. Por eso, ayuda organizar la Scene en torno a una Library más pequeña de modelos reutilizados.

### Backface Culling

Para optimizar el rendimiento, Backface Culling se establecerá en  **Activado**  para  **todos**  los Materials del modelo cuando se Render en el Engine, independientemente de sus Settings.

Si esperas ver la parte trasera o el interior de tus modelos, duplica las caras e invierte las normales.

#### Solución de problemas

Para comprobar si una escena tiene problemas con Backface Culling en los materiales, sigue estos pasos:

1. Abre el panel `debug` de la escena.

* Si la escena está publicada, escribe el comando `/debug` en el chat.
* Si estás en el modo Preview de la escena, haz clic en el icono del error (

  <img src="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" alt="icono de depuración" width="32">

  ) situado en la esquina superior derecha de la pantalla.

2. El panel de depuración aparecerá en la esquina inferior derecha de la pantalla.
3. En **Escena actual**, haz clic en el botón **Depurador de Backface** .

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

4. Activa o desactiva **Forzar Backface Culling**: muestra los materiales renderizados con Backface Culling activado. Así es como se renderiza realmente cuando la optimización está en producción. Actívalo y desactívalo para detectar los materiales que deban corregirse.
5. Activa **el Depurador de Backface** para detectar fácilmente los materiales que tienen Backface Culling desactivado. Resalta:

* **Rojo**: materiales que no tienen Backface Culling configurado como **Activado**.
* **Verde**: materiales con Backface Culling **activado**.

<p align="center"><img src="https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-df9d2632e0b6e45eca4752b96f953c2a5dabf537%2Fbackface-culling-off.webp?alt=media" alt=""> <img src="https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-b813c38a64fdb27724399817f98f353fb2764891%2Fbackface-culling-on.webp?alt=media" alt=""><br><em>Material con Backface Culling desactivado (izquierda) frente a Backface Culling activado (derecha)</em></p>

### Conversión a formato Asset Bundle

Cada vez que publicas una escena, los servidores de contenido de Decentraland comprimen todos los modelos *.gltf* y *.glb* que contiene y los convierten al formato asset bundle. Este formato es *considerablemente* más ligero, por lo que las escenas se cargan mucho más rápido y funcionan con mayor fluidez. La conversión comienza inmediatamente después de cada implementación. Por lo general, solo tarda unos segundos, aunque puede tardar más en escenas muy grandes o cuando los servidores están ocupados, ya que la conversión se ejecuta por separado para cada plataforma y puede quedar en cola detrás de otras escenas. Puedes [consultar directamente el estado de conversión](https://docs.decentraland.org/creator/content-creator-es/scene-editor/publicar/publish-scene.md#check-the-conversion-status) de tu escena.

Desktop Explorer realiza esta misma conversión localmente cuando previsualizas tu escena. Esto hace que la vista previa sea más fluida y te permite comprobar si hay algún problema con los modelos comprimidos antes de publicar. Consulta [Previsualizar con recursos optimizados](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/primeros-pasos/preview-scene.md#preview-with-optimized-assets).

{% hint style="info" %}
**💡 Consejo**: Si estás organizando un evento en Decentraland, publica la versión final con al menos una hora de antelación para que todos los modelos se hayan convertido a asset bundles para entonces y tengas tiempo de solucionar cualquier imprevisto. Si no quieres arruinar la sorpresa antes del evento, puedes implementar una versión de la escena que incluya todos los modelos 3D finales en la carpeta del proyecto, pero que no los muestre o tenga su tamaño establecido en 0.
{% endhint %}

{% hint style="warning" %}
**📔 Nota**: Si haces *cualquier* cambio en un archivo de modelo 3D, aunque solo cambies el nombre, se considerará un archivo nuevo y deberá volver a convertirse al formato asset bundle.
{% endhint %}

## Conectividad

Si tu escena se conecta a servidores de terceros o usa [messagebus](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/networking/serverless-multiplayer.md#send-explicit-messagebus-messages) para enviar mensajes entre jugadores, también hay algunas cosas que conviene tener en cuenta.

* Tu escena solo debería tener una conexión WebSockets activa a la vez.
* El motor canaliza las llamadas HTTP para gestionar solo una a la vez. Las solicitudes adicionales se ponen en cola internamente y deben esperar a que se completen las demás. Este proceso de cola se gestiona automáticamente; no tienes que hacer nada.
* Al usar [messagebus](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/networking/serverless-multiplayer.md#send-explicit-messagebus-messages) para enviar mensajes entre jugadores, ten en cuenta que todos los mensajes se envían a los demás jugadores de la isla del servidor. Evita situaciones en las que un mensaje entrante provoque directamente el envío de otro, ya que la cantidad de mensajes puede crecer rápidamente de forma exponencial cuando hay mucha gente en la escena.

## UI de la escena

Las UI de las escenas pueden resultar costosas de renderizar cuando están formadas por muchos elementos individuales. Ten en cuenta que cada elemento de UI requiere una llamada de dibujo independiente del motor.

{% hint style="info" %}
**💡 Consejo**: Intenta combinar varios elementos en una sola imagen. Por ejemplo, si tienes un menú con varios elementos de texto, lo ideal es integrar el texto de los mosaicos y cualquier imagen adicional en la imagen de fondo. Así, el motor no tendrá que hacer una llamada de dibujo adicional por fotograma para cada elemento de texto.
{% endhint %}

Evita hacer ajustes a la UI en cada fotograma; son especialmente costosos y pueden acabar poniéndose en cola. Por ejemplo, si la UI incluye una barra de salud que debería reducirse con el tiempo, es probable que los jugadores no noten la diferencia entre actualizarla a 10 FPS y hacerlo en cada fotograma. El sistema que actualiza esta barra puede usar un temporizador breve de 100 milisegundos y modificar la UI solo cuando el temporizador llegue a 0.

Evita tener muchos elementos de UI ocultos, ya que también afectan al rendimiento aunque no se rendericen. Cuando sea posible, intenta crear componentes de UI bajo demanda.

## Terreno del paisaje en Worlds

Las escenas publicadas en un [Decentraland World](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/publicacion/publishing-options.md#decentraland-worlds) están rodeadas de un paisaje generado automáticamente con praderas, árboles y mar. Renderizar este paisaje consume parte del presupuesto de renderizado del jugador. Si tu escena no lo necesita, puedes [desactivar el terreno del paisaje](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/tipos-de-proyectos/scene-metadata.md#landscape-terrain) en tu `scene.json` para liberar esos recursos y destinarlos al contenido de tu escena.

## Supervisar el rendimiento

La mejor métrica para saber qué tan bien funciona una escena son los FPS (fotogramas por segundo). En Preview, puedes ver los FPS actuales de la escena en el panel de depuración. Procura mantener siempre 30 FPS o más.

En la escena desplegada, puedes mostrar u ocultar el panel que presenta estas métricas escribiendo `/showfps` en la ventana del chat.

### Panel de estadísticas de la escena

Al ejecutar una escena en Preview en el cliente de escritorio, puedes abrir un panel que muestra estadísticas en tiempo real del contenido de la escena. Haz clic en el icono de estadísticas, en la esquina superior derecha de la pantalla, junto a los iconos de la consola y la depuración.

<img src="https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-1d11b231fdf0e0dd15b31d301f8d120aeb9435b6%2Fscene-stats-panel.webp?alt=media" alt="Panel de estadísticas de la escena" width="400">

El panel compara la cantidad de triángulos, Entities, cuerpos y Textures de la escena con sus respectivos límites y muestra qué porcentaje de cada presupuesto se está utilizando. Un valor se vuelve naranja al alcanzar el 80 % de su límite. También muestra el recuento total de Materials, geometrías, Colliders y videos o audios externos. Pasa el cursor sobre el icono de información junto a cada métrica para ver una explicación de lo que cuenta y por qué es importante.

Las cifras se actualizan en tiempo real a medida que el contenido se carga y descarga, por lo que el panel resulta útil para comprobar cómo estrategias como [la carga diferida](#lazy-loading) afectan a lo que el motor está procesando en cada momento. Consulta [las limitaciones de las escenas](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/optimizacion/scene-limitations.md) para ver los detalles de cada límite. Ten en cuenta que estos son límites flexibles: superarlos no bloqueará tu escena, pero puede reducir el rendimiento para los jugadores.

### Mensajes entre la escena y el motor

Uno de los principales cuellos de botella en el rendimiento de una escena suele ser el envío de mensajes entre el código de la escena y el motor.

Al ejecutar una escena en Preview, fíjate en el texto de la esquina superior derecha: “Y = Toggle Panel”. Pulsa Y en el teclado para abrir un panel con información útil que se actualiza en tiempo real.

Al interactuar con elementos que implican el intercambio de mensajes entre el SDK y el motor, verás que aumenta el número de “Processed Messages”. Vigila de cerca el valor de “Pending on Queue”: debería mantenerse siempre en 0 o cerca de 0. Este valor indica cuántos de esos mensajes no se pudieron procesar y se pusieron en cola. Si el valor de “Pending on Queue” empieza a aumentar, habrás entrado en una zona de riesgo y deberías plantearte optimizar más la escena.

{% hint style="warning" %}
**📔 Nota**: No dejes el panel abierto cuando no lo estés usando, ya que afecta negativamente al rendimiento.
{% endhint %}

Ten en cuenta que el rendimiento que experimentas en Preview puede diferir del que se obtiene en producción:

* Las escenas vecinas del entorno pueden afectar negativamente al rendimiento
* La compresión de los modelos 3D de las escenas en paquetes de recursos puede tener un efecto positivo
* Algunos jugadores que visiten tu escena podrían usar hardware menos potente

Siempre es recomendable intentar desplegar primero tu escena en un [Decentraland World](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/publicacion/publishing-options.md#decentraland-worlds) para realizar pruebas más exhaustivas.

Pide siempre comentarios a los jugadores. No des por sentado que los demás experimentan la escena igual que tú.

## Ayuda a los jugadores a ajustar su configuración

Incluso una escena bien optimizada puede funcionar mal en hardware de gama baja, o cuando el jugador tiene los ajustes gráficos demasiado altos para su máquina. Puedes ayudar a estos jugadores detectando una baja tasa de fotogramas en el código de tu escena y mostrando un aviso de UI que recomiende bajar los ajustes gráficos, con un botón que abra directamente el panel de ajustes del Explorer mediante [`openExplorerUi()`](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/interactividad/event-listeners.md#open-explorer-panels).

Tu escena puede medir la tasa de fotogramas del Explorer con el componente [`EngineInfo`](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/interactividad/runtime-data.md#the-engineinfo-component) : `frameNumber` cuenta los fotogramas que renderiza el Explorer, y `totalRuntime` cuenta los segundos. En el ejemplo siguiente, si el promedio es inferior a 20 FPS durante un período de 5 segundos, la escena muestra un aviso de UI. Al hacer clic en el botón del aviso, se abre el panel de ajustes. Ese clic es la [acción del jugador](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/interactividad/event-listeners.md#only-a-player-action-can-open-a-panel) que `openExplorerUi()` requiere, por lo que la llamada debe realizarse directamente dentro del controlador del botón.

No cuentes cuántas veces se ejecuta tu propio sistema. El Explorer ejecuta las escenas en las que el jugador no está presente a una tasa reducida, por lo que un contador de ticks indicará una baja tasa de fotogramas en cualquier máquina. `frameNumber` no se ve afectado por eso, porque cuenta los fotogramas del Explorer, no los ticks de tu escena. Aun así, considera el resultado como una señal aproximada de que algo va mal, no como una medición precisa.

El ejemplo también se reinicia mientras la escena está oculta, por ejemplo, detrás de la pantalla de carga. Omite la primera ventana de 5 segundos después de cada pantalla de carga, que todavía puede incluir la carga de Assets, y muestra el aviso solo una vez por sesión.

```tsx
import { engine, EngineInfo, ExplorerUi } from '@dcl/sdk/ecs'
import { openExplorerUi } from '~system/RestrictedActions'
import ReactEcs, { Button, Label, ReactEcsRenderer, UiEntity } from '@dcl/sdk/react-ecs'

let showSettingsTip = false
let tipAlreadyShown = false

// Mide los FPS promedio del Explorer en ventanas de 5 segundos
let windowStartFrame = -1
let windowStartTime = 0
let firstWindow = true

engine.addSystem(() => {
  const info = EngineInfo.getOrNull(engine.RootEntity)
  if (!info || tipAlreadyShown) return
  // Reinicia el contador mientras la escena está oculta, por ejemplo, detrás de la pantalla de carga
  if (info.sceneHidden) {
    windowStartFrame = -1
    // Omite la primera ventana después de cada pantalla de carga, no solo de la primera
    firstWindow = true
    return
  }
  if (windowStartFrame < 0) {
    windowStartFrame = info.frameNumber
    windowStartTime = info.totalRuntime
    return
  }
  const elapsed = info.totalRuntime - windowStartTime
  if (elapsed > 0 && elapsed < 5) return
  // Una ventana mucho más larga que 5 s (escena pausada, cambio de reloj) no aporta información: descártala
  const valid = elapsed >= 5 && elapsed < 10
  // Omite la primera ventana: puede incluir la carga de la escena, que es lenta en cualquier máquina
  if (valid && !firstWindow && (info.frameNumber - windowStartFrame) / elapsed < 20) {
    showSettingsTip = true
    tipAlreadyShown = true
  }
  if (valid) firstWindow = false
  windowStartFrame = info.frameNumber
  windowStartTime = info.totalRuntime
})

ReactEcsRenderer.setUiRenderer(() => (
  <UiEntity
    uiTransform={{
      display: showSettingsTip ? 'flex' : 'none',
      flexDirection: 'column',
      positionType: 'absolute',
      position: { top: 40, right: 40 },
      padding: 10,
    }}
    uiBackground={{ color: { r: 0, g: 0, b: 0, a: 0.8 } }}
  >
    <Label value="¿Va lento? Prueba a bajar la configuración gráfica." fontSize={16} />
    <UiEntity uiTransform={{ flexDirection: 'row', margin: { top: 8 } }}>
      <Button
        value="Abrir configuración"
        fontSize={16}
        uiTransform={{ height: 36 }}
        onMouseDown={() => {
          // Llámalo primero, antes que cualquier otra cosa en el controlador
          void openExplorerUi({ ui: ExplorerUi.EU_SETTINGS })
          showSettingsTip = false
        }}
      />
      <Button
        value="Descartar"
        fontSize={16}
        uiTransform={{ height: 36, margin: { left: 8 } }}
        onMouseDown={() => {
          showSettingsTip = false
        }}
      />
    </UiEntity>
  </UiEntity>
))
```

{% hint style="info" %}
**💡 Consejo**: Muestra este tipo de aviso solo una vez y permite que los jugadores lo descarten. Una ventana emergente recurrente en una máquina que ya tiene dificultades solo empeora la experiencia.
{% endhint %}

## Optimizar con IA

Un agente de IA puede encargarse de gran parte de las mediciones y correcciones descritas en esta página. Decentraland ofrece [AI skills](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/primeros-pasos/vibe-coding.md#install-skills-for-any-ai-agent) que enseñan a los agentes de programación (como Claude Code o Cursor) a optimizar escenas, y el cliente de escritorio incluye un [MCP server](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/primeros-pasos/vibe-coding.md#let-the-ai-see-your-scene-in-world) que permite al agente inspeccionar y medir directamente la escena en ejecución.

Con las `optimize-scene` y `unity-explorer-mcp` skills instaladas y el MCP server conectado, un agente puede:

* **Comprobar la escena según sus presupuestos de contenido**: lee las mismas estadísticas en tiempo real que el panel Scene Stats y las compara con las [limitaciones de la escena](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/optimizacion/scene-limitations.md), para indicarte qué presupuesto está cerca de agotarse.
* **Encontrar los assets responsables**: clasifica los modelos 3D de la escena según la cantidad de triángulos, materiales y llamadas de dibujo que aporta cada uno, incluidos los elementos visibles desde un punto de vista específico, para saber exactamente qué modelos optimizar primero.
* **Medir la tasa de fotogramas real**: coloca al jugador en cualquier punto de la escena y mide los FPS que realmente experimenta allí, incluidos los tirones momentáneos.
* **Verificar su propio trabajo**: después de cada cambio puede volver a medir, de modo que sus recomendaciones y correcciones se basan en cifras reales, no en suposiciones.

Así, optimizar se convierte en algo que puedes pedir con toda sencillez:

> «Comprueba si mi escena está dentro de los límites, encuentra lo que reduce la tasa de fotogramas cerca del punto de aparición, corrígelo y muéstrame las cifras de antes y después».

### Combinar con el MCP server de Blender

Las herramientas de Decentraland indican al agente cuáles son los modelos más pesados, pero no permiten editarlos. Para ir más allá, puedes probar a combinarlas con el [MCP server de Blender](https://www.blender.org/lab/mcp-server/), que da al agente acceso a las herramientas de edición de Blender. Así, el agente puede abrir un modelo pesado en Blender, reducir su cantidad de triángulos, combinar sus materiales o reducir el tamaño de sus texturas, y exportar el resultado de vuelta a la escena como un archivo `.glb` , donde podrá volver a medir la tasa de fotogramas dentro del mundo.

Ten en cuenta que las modificaciones automatizadas de la malla pueden cambiar visiblemente el aspecto de un modelo, así que revisa siempre los resultados y conserva copias de seguridad de los archivos originales.


---

# 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/optimizacion/performance-optimization.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.
