> 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/tipos-de-proyectos/scene-metadata.md).

# Metadatos de la escena

Aprende a configurar una escena y sus metadatos.

Una escena es un proyecto de Decentraland delimitado espacialmente y asignado a uno o varios parcels. Si se publica una escena en el mapa de Genesis City de Decentraland, los jugadores pueden experimentarla visitando las coordenadas de la escena. Si se publica en un [World](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/publicacion/publishing-options.md#decentraland-worlds), los jugadores pueden visitarla mediante una URL.

Consulta [Archivos de una escena](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/tipos-de-proyectos/scene-files.md) para ver una lista de los archivos que se usan en un proyecto de escena.

## Metadatos

Para editar los metadatos de una escena en el [Scene Editor de Creator Hub](https://docs.decentraland.org/creator/content-creator-es/scene-editor/primeros-pasos/about-editor.md), abre una escena y haz clic en el **icono del lápiz**.

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

Se abrirá el menú de la escena, donde puedes configurar varias propiedades.

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

Como alternativa, puedes editar directamente el archivo `scene.json` , donde se almacenan todos estos valores.

{% hint style="warning" %}
**📔 Nota**: No añadas campos personalizados al archivo `scene.json` que no se mencionen en esta página, ya que podrían causar problemas al cargar la escena.
{% endhint %}

## Título, descripción e imagen de la escena

Es muy importante asignar a la escena un título, una descripción y una imagen en miniatura para atraer a los jugadores y ayudarles a saber qué esperar.

Los jugadores los verán en una ventana modal cuando seleccionen en el mapa los parcels de tu escena. También los verán en una pantalla de confirmación cuando otra escena los [teletransporte](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/interactividad/external-links.md) allí. Configurar datos atractivos puede ayudar considerablemente a atraer visitas a tu escena.

Cuando los jugadores recorran el mundo y entren en tu escena, podrán leer el título de la escena debajo del minimapa.

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

Añade estos datos desde el menú de la escena en Scene Editor.

Si quieres que otros desarrolladores puedan ponerse en contacto contigo, también puedes añadir información de contacto a tu escena.

{% hint style="info" %}
**📔 Nota**: Los Worlds tienen su propio nombre, descripción e imagen en miniatura, independientes de los metadatos de la escena. Si un World contiene una sola escena, los metadatos del World se actualizan a partir de los metadatos de la escena cada vez que se publica. Si contiene varias escenas, los metadatos del World son independientes y solo se pueden editar en la pestaña **Manage** de Creator Hub. Consulta [Metadatos del World frente a los metadatos de la escena](https://docs.decentraland.org/creator/content-creator-es/scene-editor/publicar/publish-scene.md#world-metadata-vs-scene-metadata).
{% endhint %}

### Imagen en miniatura de la escena

La imagen en miniatura se configura en el campo `navmapThumbnail` . Debe ser una imagen *.png* o *.jpg* con una relación de aspecto de **16:9** . *1920x1080* píxeles es el tamaño recomendado. También sirven otros tamaños, siempre que mantengan las mismas proporciones de 16:9.

Algunas partes de la plataforma muestran una versión cuadrada reducida de la imagen en miniatura, recortada al centro, de *1080x1080* píxeles. Mantén todo lo esencial, como el texto o los logotipos, dentro de esa zona segura para que no se recorte.

{% hint style="warning" %}
**📔 Nota**: Creator Hub rechaza las imágenes que no tengan una relación de aspecto de 16:9. Si asignas manualmente a `navmapThumbnail` una imagen con otra proporción, los clientes que la muestren podrían estirarla o recortarla de forma impredecible. Consulta [Miniatura de la escena](https://docs.decentraland.org/creator/content-creator-es/scene-editor/configurar/scene-settings.md#scene-thumbnail).
{% endhint %}

![Área segura de la miniatura de la escena: imagen completa de 1920x1080, con el cuadrado central de 1080x1080 marcado como área segura y las franjas izquierda y derecha marcadas como recortadas](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-16b056fbe6b140419900fa4e47cdb080320ca8b1%2Fscene-thumbnail-safe-area.webp?alt=media)

La imagen en `navmapThumbnail` debe ser la ruta a un archivo de imagen en la carpeta del proyecto. También puede ser un enlace URL a una imagen alojada en otro lugar.

{% hint style="warning" %}
**📔 Nota**: Si alojas una imagen en otro lugar, asegúrate de que esté en un sitio con políticas CORS permisivas para mostrar contenido en otros sitios.
{% endhint %}

{% hint style="warning" %}
**📔 Nota**: No asignes a este campo la ruta `assets/Images/autogenerated-thumbnail.png` (ni `assets/images/autogenerated-thumbnail.png` en proyectos antiguos). Creator Hub sobrescribe ese archivo específico cada vez que captura una miniatura por ti. Consulta [No llames a tu archivo autogenerated-thumbnail.png](https://docs.decentraland.org/creator/content-creator-es/scene-editor/configurar/scene-settings.md#dont-name-your-file-autogenerated-thumbnailpng).
{% endhint %}

## Categorías

Puedes añadir categorías a tu escena para ayudar a los jugadores a explorar Decentraland. Estas se usan en [la dApp Decentraland Places](https://places.decentraland.org) para categorizar cada lugar y facilitar que los jugadores encuentren lo que les interesa.

**Las categorías** deben elegirse de una lista predefinida de opciones:

* 🎨 Arte
* 🕹️ Juego
* 🃏 Casino
* 👥 Social
* 🎶 Música
* 👠 Moda
* 🪙 Cripto
* 📚 Educación
* 🛍️ Tienda
* 🏢 Negocios
* 🏅 Deportes
* 🏃 Parkour

Una escena puede pertenecer a más de una categoría, con un máximo de 3 categorías enumeradas.

En el archivo `scene.json` las categorías se enumeran en la matriz `tags` .

Estas son las categorías predefinidas:

* `art`
* `game`
* `casino`
* `social`
* `music`
* `fashion`
* `crypto`
* `education`
* `shop`
* `business`
* `sports`
* `parkour`

Por ejemplo, se podría etiquetar una escena como `game` y `casino` al añadir lo siguiente a `scene.json`

```json
  "tags": [
    "game",
    "casino",
  ],
```

Después, la escena aparecerá en la dApp Places dentro de las categorías `game` y `casino` .

## Clasificación por edad

El campo **Clasificación por edad** se usa para clasificar el contenido de tu escena. Decentraland es una plataforma para mayores de 18 años. Está disponible la siguiente opción:

* **🟡 `A` para adultos (18+)**: Este es el requisito de edad mínima especificado en las [Condiciones de uso](https://decentraland.org/terms). Elige esta categoría si tu escena incluye contenido apropiado para adultos, como lenguaje moderado o intenso, violencia, contenido explícito, apuestas o sustancias como alcohol, tabaco y drogas.

Al editar la clasificación por edad en `scene.json`, la clasificación es un **código de una sola letra**, escribe **A** para adultos. El campo `rating` se coloca en el nivel raíz del árbol JSON.

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

```json
 "rating": "A"
```

### Contenido restringido

Hay una tercera categoría para las escenas: 🔴 `R` para contenido restringido. Esta clasificación la aplican manualmente los moderadores de contenido a las escenas que infringen la [Política de contenido](https://decentraland.org/content). Las infracciones pueden incluir, entre otras:

* Contenido sospechoso o spam
* Contenido abusivo o que incita al odio
* Contenido sexual o degradante
* Maltrato infantil
* Acoso o intimidación
* Promoción del terrorismo o la violencia
* Infracción de derechos de propiedad intelectual o de autor

Las escenas con esta clasificación no se cargarán y nadie podrá interactuar con ellas. Si tu escena pertenece a esta categoría, debes revisarla y actualizarla para que cumpla con la [Política de contenido](https://decentraland.org/content).

## Alternar funciones

Hay ciertas funciones que se pueden desactivar en escenas específicas para evitar que los jugadores hagan un uso abusivo de ellas. Configúralas en la pestaña **Settings** de la configuración de la escena.

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

Actualmente, solo se gestiona de esta manera la siguiente función:

* **Chat de voz**: permite que los jugadores usen sus micrófonos para conversar por chat de voz con otros jugadores cercanos.
* **Desactivar Portable Experiences**: esta configuración determina cómo se comportan las Portable Experiences de los jugadores mientras están dentro de tu escena. Esto incluye no solo las [Portable Experiences](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/tipos-de-proyectos/portable-experiences.md) sino también los [Smart Wearables](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/tipos-de-proyectos/smart-wearables.md). Con esta configuración, puedes optar por mantenerlas todas habilitadas (opción predeterminada), deshabilitarlas u ocultar su UI. Esto resulta útil en escenas donde las Portable Experiences podrían dar una ventaja injusta a algunos jugadores, por ejemplo, si usan un jetpack en un desafío de parkour. También se recomienda deshabilitarlas en escenas donde se realizan transacciones en la blockchain, ya que una Portable Experience maliciosa podría suplantar la UI de la escena.

En el archivo `scene.json` , estos alternadores se configuran en `featureToggles`. Las funciones correspondientes están habilitadas de forma predeterminada, a menos que se especifiquen como *deshabilitadas* en el `scene.json` archivo.

```json
"featureToggles": {
    "voiceChat": "disabled",
    "portableExperiences": "enabled" | "disabled" | "hideUi"
},
```

Si no existe la propiedad `featureToggles` en tu archivo `scene.json` , créala en el nivel raíz del árbol JSON.

### Propinas

Puedes recibir propinas de los jugadores que visiten tu escena. Para habilitar las propinas, ve a la pestaña **Details** de la configuración de la escena e introduce una dirección de Ethereum en **Dirección de la Wallet del creador**.

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

También puedes indicar la dirección para recibir propinas de tu escena en el archivo `scene.json` , en el campo `creator` .

```json
  "creator": "0x1234567890123456789012345678901234567890"
```

Cuando un jugador visite tu escena, verá un ícono de alcancía en la esquina superior izquierda de la pantalla. Al hacer clic en él, se abrirá una ventana modal donde podrá enviarte una propina. También se puede acceder a este menú abriendo la información de tu escena en el mapa.

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

La ventana modal de propinas permite al jugador seleccionar la cantidad de MANA que quiere enviarte. Para enviar una propina, debe tener MANA en su Wallet. Si la dirección que proporcionaste está vinculada a un NAME de Decentraland, la ventana modal mostrará el nombre del propietario de la Wallet junto a la dirección de Ethereum.

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

Recibirás una notificación en la pestaña de notificaciones de Decentraland cada vez que un jugador te envíe una propina.

## Ubicación de aparición

La configuración de **Spawn Settings** en la pestaña **Settings** define dónde aparecen los jugadores cuando acceden directamente a tu escena, ya sea escribiendo las coordenadas en el navegador o teletransportándose.

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

Tu escena puede tener objetos que impidan que los jugadores se muevan si aparecen encima de ellos, como árboles o escaleras. También puede tener terreno elevado. Para evitar que aparezcan en lugares donde no puedan moverse, puedes establecer varias posiciones de aparición en ubicaciones específicas.

La posición consta de coordenadas dentro de la escena. Estos números indican una posición dentro de la parcela, similar a la que usarías en el código de la escena en un componente Transform para [posicionar una Entity](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/fundamentos-del-contenido-3d/entity-positioning.md).

{% hint style="warning" %}
**📔 Nota**: Todos los puntos de aparición deben estar dentro de las parcelas que componen la escena. No puedes hacer aparecer a un jugador fuera del espacio de estas parcelas.
{% endhint %}

Marca la casilla **Random Offset** para desplazar aleatoriamente a los jugadores que aparecen alrededor del punto de aparición. Esto evita que todos los jugadores aparezcan superpuestos al entrar, algo que se ve especialmente mal en escenas concurridas. El valor de **Max Offset** es la distancia máxima posible desde el punto de aparición original, tanto en el eje X como en el Z.

Configura **Camera Target** para controlar la dirección hacia la que miran los jugadores al entrar en tu escena. Esto te da un mayor control sobre su primera impresión y puede ayudar a guiarlos en una dirección específica. De forma predeterminada, apunta a `{x: 8, y:1, z:8}`, que es el centro de la escena en escenas de una sola parcela, o el centro de la parcela inferior izquierda en escenas más grandes.

Haz clic en **Add Spawn Point** para añadir tantos puntos de aparición como quieras. Los jugadores aparecerán aleatoriamente en uno de ellos.

### Puntos de aparición en JSON

También puedes configurar los puntos de aparición mediante el archivo `scene.json` , en el campo `spawnPoints` .

```json
  "spawnPoints": [
    {
      "name": "spawn1",
      "position": {
        "x": 5,
        "y": 1,
        "z": 4
      }
    }
  ],
```

Una escena puede tener varios puntos de aparición. Esto es especialmente útil en escenas grandes. Para añadir muchos puntos de aparición, solo tienes que enumerarlos en un array.

```json
  "spawnPoints": [
    {
      "name": "spawn1",
      "position": {
        "x": 5,
        "y": 1,
        "z": 4
      }
	},
	{
      "name": "spawn2",
      "position": {
        "x": 3,
        "y": 1,
        "z": 1
      }
    }
  ],
```

Si hay varios puntos de aparición, se selecciona el más cercano a las coordenadas indicadas por el jugador.

Si un punto de aparición está marcado como `default`, siempre se utilizará, independientemente de si es el más cercano. Si varios puntos de aparición están marcados como `default`, se seleccionará el más cercano.

```json
  "spawnPoints": [
    {
      "name": "spawn1",
      "default": true,
      "position": {
        "x": 5,
        "y": 1,
        "z": 4
      }
	},
	{
      "name": "not-used",
      "position": {
        "x": 3,
        "y": 1,
        "z": 1
      }
    }
  ],
```

**Regiones de aparición**

Puedes hacer que una región completa de la escena funcione como punto de aparición. Si especificas un array de dos números para cada dimensión de la posición, los jugadores aparecerán en una ubicación aleatoria dentro de ese rango. Esto ayuda a evitar que los jugadores que entran aparezcan superpuestos. Ten en cuenta que las tres dimensiones deben usar el mismo formato: o bien todas son números individuales, o bien todas son arrays de dos números. Para mantener fija una dimensión, usa un array con el mismo número dos veces, como `"y": [1,1]`.

```json
  "spawnPoints": [
    {
      "name": "region",
      "position": {
        "x": [1,5],
        "y": [1,1],
        "z": [2,4]
      }
    }
  ],
```

En el ejemplo anterior, los jugadores pueden aparecer en cualquier lugar del cuadrado cuyas esquinas están en *1,1,2* y *5,1,4*.

Una escena también puede tener varias regiones de aparición, igual que puede tener varios puntos de aparición.

```json
  "spawnPoints": [
    {
      "name": "region1",
      "position": {
        "x": [1,5],
        "y": [1,1],
        "z": [2,4]
      }
    },
      {
      "name": "region2",
      "position": {
        "x": [1,5],
        "y": [1,1],
        "z": [6,8]
      }
    }
  ],
```

**Rotación**

También puedes especificar la rotación de los jugadores cuando aparecen, para que miren en una dirección específica.

Solo tienes que añadir un campo `cameraTarget` a los datos del punto de aparición. El valor de `cameraTarget` debe hacer referencia a una ubicación en el espacio, con las coordenadas *x*, *y* y *z* relativas a la escena, igual que el campo `position` .

```json
  "spawnPoints": [
    {
      "name": "spawn1",
      "position": {
        "x": 5,
        "y": 1,
        "z": 4
      },
      "cameraTarget": {
        "x": 10,
        "y": 1,
        "z": 4
      }
    }
  ],
```

Este ejemplo hace aparecer a un jugador en *5, 1, 4* mirando hacia el este, en dirección a *10, 1, 4*. Si la posición de aparición es un rango, la rotación del jugador siempre coincidirá con el objetivo indicado. Si hay varios puntos de aparición, cada uno puede tener su propio objetivo.

## Permisos requeridos

La propiedad `requiredPermissions` enumera las funciones restringidas que usa un [smart wearable](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/tipos-de-proyectos/smart-wearables.md) . Solo se aplica a los smart wearables.

{% hint style="warning" %}
**📔 Nota**: Las escenas normales (en parcelas o en Worlds) y las [experiencias portátiles](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/tipos-de-proyectos/portable-experiences.md) se ejecutan con todos los permisos concedidos. No necesitan esta propiedad, y añadirla no tiene ningún efecto en ellas.
{% endhint %}

Un smart wearable solo puede usar estas funciones si las declara en su `scene.json`. Si el permiso no está declarado, la llamada falla y Explorer registra un error de *permiso denegado* :

* `USE_FETCH`: Enviar solicitudes HTTP a servidores de terceros con `fetch` o `signedFetch`
* `USE_WEBSOCKET`: Abrir conexiones WebSocket con servidores de terceros
* `USE_WEB3_API`: Interactuar con la Wallet del jugador para realizar transacciones o firmar mensajes
* `OPEN_EXTERNAL_LINK`: Solicitar al jugador que abra un enlace a un sitio externo

```json
"requiredPermissions": [
    "USE_FETCH",
    "OPEN_EXTERNAL_LINK"
  ],
```

Si un `requiredPermissions` la propiedad no existe en tu archivo `scene.json` ; créala en el nivel raíz del árbol JSON.

Cuando un wearable inteligente declara cualquiera de estos permisos, Explorer pide al jugador que lo autorice al equipárselo. Si el jugador lo rechaza, el código del wearable no se ejecuta. Declara solo los permisos que realmente uses para que no se les pida a los jugadores conceder más permisos de los necesarios.

{% hint style="warning" %}
**📔 Nota**: En versiones anteriores de esta página también se incluían `ALLOW_TO_MOVE_PLAYER_INSIDE_SCENE`, `ALLOW_TO_TRIGGER_AVATAR_EMOTE` y `ALLOW_MEDIA_HOSTNAMES`. El Explorer actual ignora estos permisos, así que puedes eliminarlos. Mover al jugador, reproducir emotes, aplicar fuerzas físicas y transmitir contenido multimedia no requieren ningún permiso.
{% endhint %}

## Parcelas de la escena

Al [hacer deploy](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/publicacion/publishing.md) de una escena, el contenido se carga en las coordenadas asignadas en la configuración de la escena. Una escena puede incluir una sola parcela o una lista de hasta varias docenas.

Edita esto en la segunda pestaña del menú de la escena en Scene Editor.

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

Usa los menús desplegables y haz clic en **Apply Layout** para cambiar las dimensiones de la escena. También puedes hacer clic en cada parcela para desactivarla en el diseño.

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

Las coordenadas de la escena predeterminada están configuradas como *0,0*. No hace falta que las cambies mientras desarrollas una escena sin conexión, a menos que necesites ocupar varias parcelas. Tendrás que cambiarlas antes de hacer deploy en coordenadas para las que tengas permisos de deploy.

También puedes cambiar las coordenadas de la escena en el archivo `scene.json` :

```json
 "scene": {
    "parcels": [
      "54,-14"
    ],
    "base": "54,-14"
  }
```

El campo `base` define qué parcela se considera la parcela base. Si tu escena tiene una sola parcela, esa debe ser la parcela base. Si tiene varias, la parcela base debe ser la parcela inferior izquierda (suroeste). Las posiciones de todas las entidades se miden desde la esquina suroeste de esta parcela.

Para mostrar varias parcelas en la vista previa de la escena, enumera todas las parcelas que quieras usar. No tienen que ser exactamente las parcelas en las que harás deploy, pero deben ser contiguas y estar dispuestas en las mismas posiciones relativas.

```json
 "scene": {
    "parcels": [
      "54,-14",  "55,-14"
    ],
    "base": "54,-14"
  }
```

{% hint style="warning" %}
**📔 Nota**: El tamaño máximo que puedes configurar para una escena es de 300 x 300 parcelas (90 000 parcelas en total).
{% endhint %}

### Configurar parcelas mediante la línea de comandos

Puedes configurar las parcelas de la escena ejecutando el comando `npx update-parcels` en la carpeta de la escena. Esto es especialmente útil para escenas grandes, ya que no necesitas enumerar todas las parcelas que incluye.

{% hint style="warning" %}
**📔 Nota**: `update-parcels` es una herramienta comunitaria de terceros; no forma parte del SDK oficial de Decentraland y la Decentraland Foundation no la mantiene.
{% endhint %}

**Una sola parcela**

Pasa un solo argumento con las coordenadas de la escena. Esta coordenada también se establece como parcela base.

`npx update-parcels <parcel>`

Por ejemplo:

`npx update-parcels 15,-26`

**Varias parcelas**

Pasa dos argumentos: las parcelas suroeste y noreste. La parcela suroeste también se establece como parcela base.

`npx update-parcels <parcel> <parcel>`

{% hint style="info" %}
**💡 Consejo**: La parcela suroeste siempre es la que tiene los números más bajos en ambos *X* y *Y* coordenadas.
{% endhint %}

Por ejemplo:

`npx update-parcels 15,-26 17,-24`

Este comando genera una escena de 3×3, con su parcela base en `15,-26`.

**Personalizar la parcela base**

Pasa tres argumentos: las parcelas del suroeste y del noreste, y la parcela que se usará como parcela base.

`npx update-parcels <parcel> <parcel> <parcel>`

{% hint style="warning" %}
**📔 Nota**: La parcela base debe ser una de las parcelas de la escena.
{% endhint %}

**Escenas no cuadradas**

Los comandos anteriores generan escenas rectangulares. Las escenas de Decentraland pueden tener forma de L u otras configuraciones. Puedes generar un cuadrado más grande con `npx update-parcels` y luego eliminar manualmente las parcelas sobrantes del `scene.json` archivo.

{% hint style="warning" %}
**📔 Nota**: La parcela base debe ser una de las parcelas de la escena.
{% endhint %}

## Hora del día del skybox

Puedes establecer una hora del día fija para tu escena. Todos los jugadores verán la escena con esa hora del día y el skybox no seguirá el ciclo de día y noche.

Abre los ajustes de la escena y haz clic en la pestaña **Settings** para encontrar la sección **Skybox** . Desmarca la opción **Auto** y establece la hora del día que quieras.

También puedes establecer la hora del día del skybox en el código de la escena. Para ello, añade la siguiente sección a tu archivo `scene.json` en el nivel raíz:

```json
 "skyboxConfig": {
    "fixedTime": 36000
  }
```

El número hace referencia a la cantidad de segundos transcurridos desde el inicio del día, y puede ir de 0 (que representa *00:00*) a 86400 (que representa *24:00*). Cualquier número superior a 86400 también se interpreta como medianoche.

Aquí tienes algunos ejemplos más de valores válidos:

* 0 segundos => *00:00*
* 21600 segundos => *06:00*
* 43200 segundos => *12:00*
* 64800 segundos => *18:00*
* 86400 segundos => *24:00*

## Terreno del paisaje

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, compuesto por praderas, árboles y mar. Si este paisaje no coincide con la estética de tu escena, por ejemplo, si es una escena que flota en mar abierto o en el espacio, puedes desactivarlo. Para ello, añade el siguiente campo a tu archivo `scene.json` en el nivel raíz:

```json
{
	"landscapeTerrain": false
}
```

Con `landscapeTerrain` establecido en `false`, no se renderiza nada más allá de las parcelas de tu escena y los jugadores solo ven el skybox que la rodea. Al eliminar el terreno circundante también se liberan recursos de renderizado, lo que puede ayudar a que tu escena funcione con mayor fluidez.

Si el campo no está configurado, su valor predeterminado es `true` y el paisaje se muestra como de costumbre.

{% hint style="warning" %}
**📔 Nota**: este campo solo se aplica a los Worlds que contienen una única escena. Se ignora en Genesis City, donde el entorno siempre depende de las parcelas vecinas. También puedes usarlo al ejecutar una vista previa local de tu escena para comprobar cómo se ve sin el paisaje.
{% endhint %}

## Configuración de World

Al publicar en un [Decentraland World](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/publicacion/publishing-options.md#decentraland-worlds), puedes configurar varios ajustes específicos de World en el archivo `scene.json` mediante el objeto `worldConfiguration` .

### Configuración básica de World

Para publicar en un World, debes especificar el dominio NAME o ENS en tu archivo `scene.json`:

```json
{
	"worldConfiguration": {
		"name": "my-name.dcl.eth"
	}
}
```

El **name** especificado puede ser un NAME de Decentraland o un dominio ENS y debe pertenecer a la Wallet que firma el despliegue (o a cualquier Wallet a la que se le haya concedido permiso mediante listas de control de acceso).

### Configuración del servicio de comunicación

La propiedad `fixedAdapter` indica qué servicio de comunicación debe usar la escena. Por ahora, solo se permite el valor `offline:offline` . Al configurarlo, la escena no tendrá ningún servicio de comunicación y cada usuario que se una a ese World estará siempre solo. Si no se configura, el servidor de contenido de Worlds generará un valor adecuado según su configuración.

```json
{
	"worldConfiguration": {
		"name": "my-name.dcl.eth",
		"fixedAdapter": "offline:offline"
	}
}
```

{% hint style="warning" %}
**📔 Nota**: configurar `fixedAdapter` como `"offline:offline"` (o activar **Single Player** en la pestaña [Settings](https://docs.decentraland.org/creator/content-creator-es/scene-editor/publicar/manage-lands-and-worlds.md#settings) de World en Creator Hub) desactiva la transmisión en directo. La función de transmisión depende de la capa de comunicaciones para enviar vídeo a los espectadores. Si necesitas transmitir en directo en tu World, no uses esta opción.
{% endhint %}

### Configuración de la inclusión en Places

Todos los Worlds aparecen automáticamente en la página Places, a menos que desactives esta opción. Si quieres que tus Worlds no se indexen en Places, puedes añadir lo siguiente:

```json
{
	"worldConfiguration": {
		"name": "my-name.dcl.eth",
		"placesConfig": {
			"optOut": true
		}
	}
}
```

### Ejemplo completo

Aquí tienes un ejemplo completo con todas las opciones de configuración de World:

```json
{
	"worldConfiguration": {
		"name": "my-name.dcl.eth",
		"fixedAdapter": "offline:offline",
		"placesConfig": {
			"optOut": true
		}
	}
}
```

Consulta [Publicar en Worlds](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/publicacion/publishing.md#publishing-to-worlds) para obtener más información sobre cómo desplegar en Worlds.

## Obtener metadatos desde el código de la escena

[Referencia de la API de escenas](https://js-sdk-toolchain.pages.dev/modules/js_runtime_apis.__system_Scene_)

Es posible que el código de tu escena necesite acceder a campos de los metadatos de la escena, como las parcelas en las que está desplegada o las posiciones de los puntos de aparición. Esto resulta especialmente útil para las escenas que se van a replicar o para el código que se quiere reutilizar en otras escenas. También es muy útil para las bibliotecas que necesitan conocer los límites de la escena.

Para acceder a estos datos, primero importa `getSceneInformation` función:

```ts
import { getSceneInformation } from '~system/Runtime'
```

Luego puedes llamar a la `getSceneInformation()` función, que devuelve un objeto JSON que incluye la mayor parte del contenido del archivo scene.json. En el ejemplo siguiente se muestra cómo acceder a varios de los campos más comunes de la respuesta de esta función:

```ts
import { getSceneInformation } from '~system/Runtime'

executeTask(async () => {
  const sceneInfo = await getSceneInformation({})

  if (!sceneInfo) return
  console.log("SCENE INFO: ", sceneInfo)
})
```

{% hint style="warning" %}
**📔 Nota**: `getSceneInformation()` debe ejecutarse como una [función async](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/patrones-de-programacion/async-functions.md), ya que la respuesta puede tardar una fracción de segundo o más en devolver los datos. No uses la función obsoleta `getSceneInfo()` .
{% endhint %}

El objeto que devuelve `getSceneInformation()` incluye lo siguiente:

* `baseUrl`: La URL base donde se aloja el contenido de la escena
* `content`: Una matriz con todos los archivos de la escena, incluidos sus hashes, que se pueden usar junto con baseUrl para recuperarlos.
* `metadataJson`: El contenido completo de scene.json de la escena, en forma de cadena. Debes analizarlo para obtener valores específicos.
* `urn`: La URN única de la escena en su conjunto.

En el ejemplo siguiente se analiza el contenido de `metadataJson` para obtener valores de las propiedades del archivo scene.json

```ts
import { getSceneInformation } from '~system/Runtime'

executeTask(async () => {
	const sceneInfo = await getSceneInformation({})

	if (!sceneInfo) return

	const sceneJson = JSON.parse(sceneInfo.metadataJson)
	const spawnPoints = sceneJson.spawnPoints
	const parcels = sceneJson.scene.parcels
	console.log({ parcels, spawnPoints })
})
```


---

# 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/tipos-de-proyectos/scene-metadata.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.
