> 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-pt/scenes-sdk7/tipos-de-projetos/scene-metadata.md).

# Metadados da cena

Saiba como configurar uma cena e os respetivos metadados.

Uma scene é um projeto de Decentraland delimitado espacialmente e associado a uma ou várias parcels. Se uma scene for publicada no mapa de Genesis City de Decentraland, os jogadores poderão vivenciá-la visitando as coordenadas da scene. Se uma scene for publicada em um [World](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/publicacao/publishing-options.md#decentraland-worlds), os jogadores poderão visitá-la por URL.

Consulte [Files in a scene](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/tipos-de-projetos/scene-files.md) para ver a lista dos files usados em um projeto de scene.

## Metadados

Para editar os metadados de uma scene no [Scene Editor no Creator Hub](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/primeiros-passos/about-editor.md), abra uma scene e clique no **ícone de lápis**.

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

Isso abre o menu da scene, onde você pode configurar várias propriedades.

![](https://2402076176-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, você pode editar diretamente o file `scene.json` , onde todos esses valores são armazenados.

{% hint style="warning" %}
**📔 Observação**: não adicione campos personalizados ao file `scene.json` que não sejam mencionados nesta página, pois isso pode causar problemas ao carregar sua scene.
{% endhint %}

## Título, descrição e imagem da scene

É muito importante definir um título, uma descrição e uma imagem em miniatura para sua scene, a fim de atrair jogadores e ajudá-los a saber o que esperar.

Os jogadores verão esses dados em uma janela modal quando selecionarem as parcels da sua scene no mapa. Também os verão em uma tela de confirmação quando forem [teletransportados](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/external-links.md) para lá por outra scene. Configurar dados atraentes aqui pode ajudar significativamente a atrair visitantes para sua scene.

Quando os jogadores navegam pelo World e entram na sua scene, podem ler o título da scene abaixo do minimapa.

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

Adicione esses dados pelo menu da scene no Scene Editor.

Se quiser que outros desenvolvedores possam entrar em contato com você, também é possível adicionar informações de contato à sua scene.

{% hint style="info" %}
**📔 Observação**: os Worlds têm nome, descrição e imagem em miniatura próprios, separados dos metadados da scene. Se um World contiver apenas uma scene, os metadados do World serão atualizados com base nos metadados da scene a cada publicação. Se contiver várias scenes, os metadados do World serão independentes e só poderão ser editados na aba **Manage** do Creator Hub. Consulte [Metadados de World vs. metadados de scene](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/publicar/publish-scene.md#world-metadata-vs-scene-metadata).
{% endhint %}

### Imagem em miniatura da scene

A imagem em miniatura é definida no campo `navmapThumbnail` . Ela deve ser uma imagem *.png* ou *.jpg* com proporção de tela **16:9** . *1920x1080* pixels é a dimensão recomendada. Outros tamanhos também funcionam, desde que mantenham a mesma proporção de 16:9.

Algumas partes da plataforma exibem uma versão quadrada reduzida da imagem em miniatura, recortada a partir do centro, com *1080x1080* pixels. Mantenha tudo o que for essencial, como texto ou logotipos, dentro dessa área segura para que não seja cortado.

{% hint style="warning" %}
**📔 Observação**: o Creator Hub rejeita imagens que não tenham proporção 16:9. Se você definir `navmapThumbnail` manualmente para uma imagem com outro formato, os clients que a exibirem poderão esticá-la ou recortá-la de maneira imprevisível. Consulte [Miniatura da Scene](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/configurar/scene-settings.md#scene-thumbnail).
{% endhint %}

![Área segura da miniatura da Scene: imagem completa de 1920x1080, com o quadrado central de 1080x1080 assinalado como área segura e as faixas à esquerda e à direita assinaladas como cortadas](https://2402076176-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)

A imagem em `navmapThumbnail` deve ser o caminho para um ficheiro de imagem na pasta do projeto. Também pode ser um link URL para uma imagem alojada noutro local.

{% hint style="warning" %}
**📔 Nota**: se alojar uma imagem noutro local, certifique-se de que o site tem políticas CORS permissivas para apresentar conteúdo noutros sites.
{% endhint %}

{% hint style="warning" %}
**📔 Nota**: não aponte este campo para `assets/Images/autogenerated-thumbnail.png` (ou `assets/images/autogenerated-thumbnail.png` em projetos mais antigos). O Creator Hub substitui esse ficheiro específico sempre que captura uma miniatura por si. Consulte [Não dê ao seu ficheiro o nome autogenerated-thumbnail.png](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/configurar/scene-settings.md#dont-name-your-file-autogenerated-thumbnailpng).
{% endhint %}

## Categorias

Pode adicionar categorias à sua Scene para ajudar os jogadores a explorar Decentraland. Estas categorias são utilizadas na [dApp Decentraland Places](https://places.decentraland.org) para categorizar cada local e facilitar aos jogadores encontrar aquilo que lhes interessa.

**Categorias** têm de ser escolhidas de uma lista predefinida de opções:

* 🎨 Arte
* 🕹️ Jogo
* 🃏 Casino
* 👥 Social
* 🎶 Música
* 👠 Moda
* 🪙 Cripto
* 📚 Educação
* 🛍️ Loja
* 🏢 Negócios
* 🏅 Desporto
* 🏃 Parkour

Uma Scene pode pertencer a mais do que uma categoria, até um máximo de 3 categorias listadas.

No ficheiro `scene.json` as categorias são listadas no array `tags` .

Estas são as categorias predefinidas:

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

Por exemplo, uma cena pode ser etiquetada como `game` e `casino` adicionando o seguinte ao ficheiro `scene.json`

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

Depois disso, a cena é apresentada na dApp Places nas categorias `game` e `casino` .

## Classificação etária

O campo **Classificação etária** é utilizado para classificar o conteúdo da sua cena. A Decentraland é uma plataforma para maiores de 18 anos. Está disponível a seguinte opção:

* **🟡 `A` para adultos (18+)**: Esta é a idade mínima exigida, conforme especificado nos [Termos de Utilização](https://decentraland.org/terms). Escolha esta categoria se a sua cena incluir conteúdo adequado para adultos, como linguagem moderada ou intensa, violência, conteúdo explícito, jogos de azar ou substâncias como álcool, tabaco e drogas.

Ao editar a classificação etária através do ficheiro `scene.json`, a classificação é um **código de uma só letra**, escreva **A** para adultos. O campo `rating` deve estar no nível raiz da estrutura JSON.

![](https://2402076176-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"
```

### Conteúdo restrito

Existe uma terceira categoria para cenas: 🔴 `R` para conteúdo restrito. Esta classificação é aplicada manualmente pelos moderadores de conteúdo a cenas que violem a [Política de Conteúdo](https://decentraland.org/content)da Decentraland. As violações podem incluir, entre outras:

* Conteúdo suspeito ou spam
* Conteúdo abusivo ou de ódio
* Conteúdo sexual ou degradante
* Abuso de crianças
* Assédio ou intimidação
* Promoção do terrorismo/violência
* Violação de direitos de propriedade intelectual/direitos de autor

As cenas com esta classificação não serão carregadas e ninguém poderá interagir com elas. Se a sua cena se enquadrar nesta categoria, deve revê-la e atualizá-la para cumprir a [Política de Conteúdo](https://decentraland.org/content).

## Alternadores de funcionalidades

Existem determinadas funcionalidades que podem ser desativadas em cenas específicas para impedir que os jogadores as utilizem de forma abusiva. Configure-as no separador **Definições** das definições da cena.

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

Atualmente, apenas a seguinte funcionalidade é gerida desta forma:

* **Chat de voz**: permite que os jogadores usem os microfones para conversar por chat de voz com outros jogadores nas proximidades.
* **Desativar experiências portáteis**: esta definição determina o comportamento das experiências portáteis dos jogadores enquanto estiverem na sua cena. Isto inclui não só as [experiências portáteis](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/tipos-de-projetos/portable-experiences.md) como também os [wearables inteligentes](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/tipos-de-projetos/smart-wearables.md). Com esta definição, pode optar por manter todas ativadas (predefinição), desativá-las ou ocultar a respetiva UI. Isto é útil em cenas onde as experiências portáteis possam dar uma vantagem injusta a alguns jogadores, por exemplo, ao usar um jetpack num desafio de parkour. Também se recomenda desativá-las em cenas onde ocorram transações na blockchain e onde uma experiência portátil maliciosa possa fazer-se passar pela UI da cena.

No ficheiro `scene.json` estes alternadores são geridos em `featureToggles`. As funcionalidades correspondentes estão ativadas por predefinição, a menos que sejam definidas como *disabled* no ficheiro `scene.json` .

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

Se a propriedade `featureToggles` não existir no seu ficheiro `scene.json` , crie-a no nível raiz da árvore JSON.

### Gorjetas

Pode receber gorjetas dos jogadores que visitam a sua cena. Para ativar as gorjetas, aceda ao separador **Detalhes** nas definições da cena e indique um endereço Ethereum em **Endereço da carteira do criador**.

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

Também pode indicar o endereço para receber gorjetas da sua cena no ficheiro `scene.json` no campo `creator` .

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

Quando um jogador visita a sua cena, vê um ícone de mealheiro no canto superior esquerdo do ecrã. Ao clicar nele, abre-se uma janela modal onde pode enviar-lhe uma gorjeta. Também é possível aceder a este menu abrindo as informações da sua cena no mapa.

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

A janela modal das gorjetas permite ao jogador selecionar a quantidade de MANA que pretende enviar. Para enviar uma gorjeta, o jogador tem de possuir MANA na sua carteira. Se o endereço indicado estiver associado a um NAME da Decentraland, esta janela modal apresentará o nome do proprietário da carteira junto ao endereço Ethereum.

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

Receberá uma notificação no separador de notificações da Decentraland sempre que um jogador lhe enviar uma gorjeta.

## Local de aparecimento

As **definições de aparecimento** no separador **Definições** definem onde os jogadores aparecem quando acedem diretamente à sua cena, seja introduzindo as coordenadas no navegador ou teleportando-se.

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

A sua cena pode ter objetos que impeçam os jogadores de se moverem caso apareçam sobre eles, como árvores ou escadas. A sua cena também pode ter terreno elevado. Para impedir que os jogadores apareçam em locais onde não conseguem mover-se, pode definir várias posições de aparecimento em locais específicos.

A posição consiste em coordenadas dentro da cena. Estes números indicam uma posição dentro do parcel, semelhante à que usaria no código da cena num componente Transform para [posicionar uma Entity](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/fundamentos-de-conteudo-3d/entity-positioning.md).

{% hint style="warning" %}
**📔 Nota**: todos os pontos de spawn têm de estar dentro dos parcels que compõem a cena. Não pode criar o spawn de um jogador fora do espaço destes parcels.
{% endhint %}

Selecione a caixa **Desvio aleatório** para deslocar aleatoriamente os jogadores que entram na cena em torno do ponto de spawn. Isto evita que todos os jogadores apareçam sobrepostos quando entram na cena, o que fica especialmente mal em cenas movimentadas. O valor de **Desvio máximo** é a distância máxima possível em relação ao ponto de spawn original, nos eixos X e Z.

Defina o **Alvo da câmara** para controlar a direção para a qual os jogadores ficam virados quando entram na cena. Assim, pode controlar melhor a primeira impressão e orientá-los numa direção específica. Por predefinição, aponta para `{x: 8, y:1, z:8}`, que corresponde ao centro da cena em cenas com um único parcel ou ao centro do parcel inferior esquerdo em cenas maiores.

Clique em **Adicionar ponto de spawn** para adicionar quantos pontos de spawn quiser. Os jogadores aparecerão aleatoriamente num deles.

### Pontos de spawn em JSON

Também pode configurar os pontos de spawn no campo `scene.json` do ficheiro, através do campo `spawnPoints` .

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

Uma única cena pode ter vários pontos de spawn. Isto é especialmente útil em cenas grandes. Para adicionar vários pontos de spawn, basta listá-los num array.

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

Quando existem vários pontos de spawn, é selecionado o que está mais próximo das coordenadas indicadas pelo jogador.

Se um ponto de spawn estiver marcado como `default`, será sempre usado, independentemente de ser o mais próximo ou não. Se vários pontos de spawn estiverem marcados como `default`, é selecionado o mais próximo.

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

**Regiões de spawn**

Pode definir uma região inteira da cena para funcionar como ponto de spawn. Ao especificar um array de dois números para cada dimensão da posição, os jogadores aparecerão numa localização aleatória dentro desse intervalo. Isto ajuda a evitar que os jogadores que entram na cena apareçam sobrepostos. Tenha em atenção que as três dimensões têm de usar o mesmo formato: ou números individuais em todas, ou arrays de dois números em todas. Para manter uma dimensão fixa, use um array com o mesmo número duas vezes, como em `"y": [1,1]`.

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

No exemplo acima, os jogadores podem aparecer em qualquer ponto do quadrado cujos cantos se encontram em *1,1,2* e *5,1,4*.

Uma cena também pode ter várias regiões de spawn, tal como pode ter vários pontos de spawn.

```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]
      }
    }
  ],
```

**Rotação**

Também pode especificar a rotação dos jogadores quando aparecem, para que fiquem virados numa direção específica.

Basta adicionar um campo `cameraTarget` aos dados do ponto de aparecimento. O valor de `cameraTarget` deve referenciar uma localização no espaço, com coordenadas *x*, *y* e *z* relativas à cena, tal como o campo `position` .

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

Neste exemplo, o jogador aparece em *5, 1, 4* virado para Este, na direção de *10, 1, 4*. Se a posição de aparecimento for um intervalo, a rotação do jogador corresponderá sempre ao alvo indicado. Se houver vários pontos de aparecimento, cada um pode ter o seu próprio alvo.

## Permissões obrigatórias

A propriedade `requiredPermissions` indica quais as funcionalidades restritas que um [smart wearable](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/tipos-de-projetos/smart-wearables.md) utiliza. Aplica-se apenas a smart wearables.

{% hint style="warning" %}
**📔 Nota**: As cenas normais (em parcelas ou em Worlds) e as [experiências portáteis](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/tipos-de-projetos/portable-experiences.md) são executadas com todas as permissões concedidas. Não precisam desta propriedade, e adicioná-la não tem qualquer efeito sobre elas.
{% endhint %}

Um smart wearable só pode utilizar estas funcionalidades se as declarar no seu ficheiro `scene.json`. Se a permissão não estiver declarada, a chamada falha e o Explorer regista um erro de *permissão negada* :

* `USE_FETCH`: Enviar pedidos HTTP para servidores de terceiros com `fetch` ou `signedFetch`
* `USE_WEBSOCKET`: Abrir ligações WebSocket a servidores de terceiros
* `USE_WEB3_API`: Interagir com a carteira do jogador para efetuar transações ou assinar mensagens
* `OPEN_EXTERNAL_LINK`: Pedir ao jogador que abra uma ligação para um site externo

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

Se um `requiredPermissions` a propriedade não existe no seu `scene.json` ficheiro; crie-a no nível raiz da árvore JSON.

Quando um wearable inteligente declara alguma destas permissões, o Explorer pede ao jogador que autorize o wearable quando o equipa. Se o jogador recusar, o código do wearable não é executado. Declare apenas as permissões que realmente utiliza, para que os jogadores não tenham de conceder mais permissões do que as necessárias.

{% hint style="warning" %}
**📔 Nota**: As versões anteriores desta página também listavam `ALLOW_TO_MOVE_PLAYER_INSIDE_SCENE`, `ALLOW_TO_TRIGGER_AVATAR_EMOTE` e `ALLOW_MEDIA_HOSTNAMES`. O Explorer atual ignora estas permissões, por isso pode removê-las. Mover o jogador, reproduzir emotes, aplicar forças físicas e transmitir conteúdo multimédia não requerem uma permissão.
{% endhint %}

## Parcelas da cena

Ao [implementar](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/publicacao/publishing.md) uma cena, o conteúdo é carregado para as coordenadas definidas na configuração da cena. Uma cena pode incluir uma única parcela ou uma lista com até várias dezenas de parcelas.

Edite esta definição no segundo separador do menu da cena no Scene Editor.

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

Utilize os menus pendentes e clique em **Aplicar esquema** para alterar as dimensões da cena. Também pode clicar em cada parcela individual para a desativar no esquema.

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

As coordenadas predefinidas da cena são *0,0*. Não precisa de as alterar enquanto desenvolve uma cena offline, a menos que precise de ocupar várias parcelas. Terá de as alterar antes de implementar a cena em coordenadas para as quais tem permissões de implementação.

Também pode alterar as coordenadas da cena no ficheiro `scene.json` :

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

O campo `base` define qual parcela deve ser considerada a parcela base. Se a sua cena tiver uma única parcela, esta deve ser a parcela base. Se a sua cena tiver várias parcelas, a parcela base deve ser a que fica no canto inferior esquerdo (sudoeste). As posições de todas as entidades são medidas em relação ao canto sudoeste desta parcela.

Para apresentar várias parcelas na pré-visualização da cena, indique tantas parcelas quantas pretende utilizar. Não precisam de ser exatamente as parcelas onde vai implementar a cena, mas devem ser todas adjacentes e estar dispostas nas mesmas posições relativas.

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

{% hint style="warning" %}
**📔 Nota**: O tamanho máximo que pode definir para uma cena é de 300 x 300 parcelas (90 000 parcelas no total).
{% endhint %}

### Definir parcelas através da linha de comandos

Pode definir as parcelas da cena executando o comando `npx update-parcels` na pasta da cena. Isto é especialmente útil para cenas grandes, pois não precisa de indicar todas as parcelas envolvidas.

{% hint style="warning" %}
**📔 Nota**: `update-parcels` é uma ferramenta comunitária de terceiros, não faz parte do SDK oficial da Decentraland e não é mantida pela Decentraland Foundation.
{% endhint %}

**Parcela única**

Indique um único argumento com as coordenadas da cena. Esta coordenada também é definida como parcela base.

`npx update-parcels <parcel>`

Por exemplo:

`npx update-parcels 15,-26`

**Várias parcelas**

Indique dois argumentos: as parcelas sudoeste e nordeste. A parcela sudoeste também é definida como parcela base.

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

{% hint style="info" %}
**💡 Sugestão**: A parcela sudoeste é sempre a que tem os valores mais baixos em ambos os *X* e *Y* coordenadas.
{% endhint %}

Por exemplo:

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

Este comando gera uma cena de 3x3, com o parcel base em `15,-26`.

**Personalizar o parcel base**

Passe três argumentos: os parcels a sudoeste e a nordeste, e o parcel a usar como parcel base.

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

{% hint style="warning" %}
**📔 Nota**: o parcel base tem de ser um dos parcels da cena.
{% endhint %}

**Cenas não quadradas**

Todos os comandos acima geram cenas retangulares. As cenas do Decentraland podem ter formas em L ou outras configurações. Pode gerar um quadrado maior com `npx update-parcels` e, em seguida, remover manualmente os parcels excedentes do `scene.json` ficheiro.

{% hint style="warning" %}
**📔 Nota**: o parcel base tem de ser um dos parcels da cena.
{% endhint %}

## Hora do dia do Skybox

Pode definir uma hora do dia fixa para a sua cena. Todos os jogadores verão a cena com esta hora do dia, e o Skybox não seguirá o ciclo dia/noite.

Abra as definições da cena e clique no separador **Definições** para encontrar a secção **Skybox** . Desmarque a opção **Automático** e defina a hora do dia que pretende.

Também pode definir a hora do dia do Skybox no código da sua cena. Para isso, adicione a seguinte secção ao seu `scene.json` no nível raiz:

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

O número refere-se à quantidade de segundos desde o início do dia, variando entre 0 (que representa *00:00*) e 86400 (que representa *24:00*). Qualquer número superior a 86400 também é interpretado como meia-noite.

Aqui estão mais alguns exemplos 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 da paisagem

As cenas publicadas num [Decentraland World](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/publicacao/publishing-options.md#decentraland-worlds) são rodeadas por uma paisagem gerada automaticamente, com campos relvados, árvores e mar. Se esta paisagem não corresponder à estética da sua cena, por exemplo, no caso de uma cena que flutua em mar aberto ou no espaço, pode desativá-la. Para isso, adicione o seguinte campo ao seu `scene.json` no nível raiz:

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

Com `landscapeTerrain` definido como `false`, nada é renderizado além dos parcels da sua scene, e os jogadores veem apenas o skybox à volta da scene. Remover o terreno circundante também liberta recursos de renderização, o que pode ajudar a sua scene a funcionar com mais fluidez.

Se o campo não estiver definido, o valor predefinido é `true` e a paisagem é apresentada normalmente.

{% hint style="warning" %}
**📔 Nota**: Este campo só se aplica a Worlds que contenham uma única scene. É ignorado em Genesis City, onde a área circundante é sempre determinada pelos parcels vizinhos. Também pode utilizá-lo ao executar uma pré-visualização local da sua scene, para verificar o aspeto da scene sem a paisagem.
{% endhint %}

## Configuração do World

Ao publicar num [Decentraland World](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/publicacao/publishing-options.md#decentraland-worlds), pode configurar várias definições específicas do World no ficheiro `scene.json` utilizando o objeto `worldConfiguration` .

### Configuração básica do World

Para publicar num World, tem de especificar o domínio NAME ou ENS no seu `scene.json`:

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

O **name** especificado pode ser um NAME da Decentraland ou um domínio ENS e tem de pertencer à wallet que assina a implementação (ou a qualquer wallet à qual tenha sido concedida permissão através de Access Control Lists).

### Configuração do serviço de comunicação

A propriedade `fixedAdapter` indica qual o serviço de comunicação que deve ser utilizado pela scene. Por enquanto, só é permitido o valor `offline:offline` . Quando definido, a scene não terá qualquer serviço de comunicação e cada utilizador que entrar nesse World estará sempre sozinho. Se não estiver definido, o servidor de conteúdo de Worlds irá gerar um valor adequado com base na respetiva configuração.

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

{% hint style="warning" %}
**📔 Nota**: Definir `fixedAdapter` como `"offline:offline"` (ou ativar **Single Player** no separador [Settings](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/publicar/manage-lands-and-worlds.md#settings) do World no Creator Hub) desativa a transmissão em direto. A funcionalidade de transmissão depende da camada de comunicação para enviar vídeo aos espectadores. Se precisar de transmissão em direto no seu World, não utilize esta opção.
{% endhint %}

### Configuração da listagem em Places

Todos os Worlds são automaticamente listados na página Places, a menos que opte por não participar. Se não quiser que os seus Worlds sejam indexados em Places, pode adicionar o seguinte:

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

### Exemplo completo

Segue-se um exemplo completo com todas as opções de configuração do World:

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

Consulte [Publicar em Worlds](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/publicacao/publishing.md#publishing-to-worlds) para obter mais informações sobre a implementação em Worlds.

## Obter metadados a partir do código da scene

[Referência da API da Scene](https://js-sdk-toolchain.pages.dev/modules/js_runtime_apis.__system_Scene_)

O código da sua scene poderá precisar de aceder a campos dos metadados da scene, como os parcels em que a scene está implementada ou as posições dos pontos de spawn. Isto é especialmente útil para scenes destinadas a ser replicadas ou para código que se pretende reutilizar noutras scenes. Também é muito útil para bibliotecas que precisam de saber onde se encontram os limites da scene.

Para aceder a estes dados, primeiro importe `getSceneInformation` função:

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

Em seguida, pode chamar a `getSceneInformation()` função, que devolve um objeto JSON que inclui a maior parte do conteúdo do ficheiro scene.json. O exemplo abaixo mostra como aceder a alguns dos campos mais comuns da resposta desta função:

```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()` tem de ser executada como uma [async function](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/padroes-de-programacao/async-functions.md), uma vez que a resposta pode demorar uma fração de segundo ou mais a devolver os dados. Não utilize a função obsoleta `getSceneInfo()` .
{% endhint %}

O objeto devolvido por `getSceneInformation()` inclui o seguinte:

* `baseUrl`: O URL base onde o conteúdo da cena está alojado
* `content`: Um array com todos os ficheiros da cena, incluindo os respetivos hashes, que pode ser usado em conjunto com o URL base para os obter.
* `metadataJson`: O conteúdo completo do scene.json da cena, sob a forma de uma string. Tem de o analisar para obter valores específicos.
* `urn`: O URN exclusivo da cena como um todo.

O exemplo abaixo analisa o conteúdo de `metadataJson` para obter valores das propriedades do ficheiro 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-pt/scenes-sdk7/tipos-de-projetos/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.
