> 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/otimizacao/scene-limitations.md).

# Limitações da cena

Quantas coisas posso colocar na minha cena?

Para melhorar o desempenho no metaverso, estabelecemos um conjunto de limites que todas as cenas têm de respeitar. Estes limites são definidos por parcela. Assim, quanto maior for a cena, mais elevados serão os limites.

Ao trabalhar com o [Creator Hub](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/primeiros-passos/editor-installation.md), pode ver estatísticas sobre os recursos utilizados pelos modelos 3D na sua cena, juntamente com os limites aplicáveis à cena.

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

Pode expandir este menu para ver os detalhes.

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

{% hint style="info" %}
**💡 Dica**: Para consultar uma tabela de referência com todos os valores específicos por número de parcelas, veja:

[Tabela de referência](https://docs.google.com/spreadsheets/d/1BTm0C20PqdQDAN7vOQ6FpnkVncPecJt-EwTSNHzrsmg/edit#gid=0)
{% endhint %}

## Regras de limitação das cenas

Abaixo encontra-se o número máximo de elementos que uma cena pode renderizar em simultâneo:

> *n* representa o número de parcelas ocupadas por uma cena.

* **Triângulos:** `n x 10000` Número total de triângulos de todos os modelos na cena.
* **Entities:** `n x 200` Número de Entities na cena.
* **Corpos:** `n x 300` Número de Meshes na cena.
* **Materials:** `log2(n+1) x 20` Número de Materials na cena. Inclui os Materials importados como parte dos modelos.
* **Textures:** `log2(n+1) x 10` Número de Textures na cena. Inclui as Textures importadas como parte dos modelos.
* **Altura:** `330 metros` Altura máxima da cena, independentemente do número de parcelas que ocupa.

  > Aviso: as Entities colocadas a mais de 200 metros de altura podem ter problemas de sincronização no modo multijogador. Mantenha abaixo dessa altura qualquer conteúdo com que os jogadores interajam ou que seja sincronizado entre eles.

  > Importante: para estes limites, só são contabilizadas as Entities que estão a ser renderizadas na cena. Se a cena alternar entre modelos 3D, o que conta são os modelos renderizados em cada momento, não a soma total. Os avatares dos jogadores e quaisquer itens trazidos por um jogador de fora da cena também não contam para o cálculo destes limites.
* **Tamanho total dos ficheiros:** Em Genesis City -`15 MB por parcela - máximo de 300 MB`. Para Worlds, consulte [Tamanho do World](#world-size). Tamanho total dos ficheiros enviados para o servidor de conteúdo. Inclui modelos 3D e áudio. Não inclui ficheiros que não são enviados, como pacotes node.js. Antes de confirmar uma implementação, pode ver a lista completa dos ficheiros a publicar e respetivos tamanhos.
* **Número de ficheiros:** `200 ficheiros por parcela` Número total dos ficheiros enviados. Inclui modelos 3D e áudio. Não inclui ficheiros que não são enviados, como pacotes node.js.
* **Tamanho máximo do ficheiro** `50 MB por ficheiro` Nenhum ficheiro individual na cena, seja de que tipo for, pode exceder 50 MB. As cenas pequenas estão sujeitas a limites ainda mais restritivos, porque o ficheiro não pode exceder o limite de tamanho total dos ficheiros (por exemplo, uma cena com uma única parcela está limitada a 15 MB no total).

{% hint style="warning" %}
**📔 Nota**: os limites de tamanho e número de ficheiros são aplicados durante a implementação; excedê-los impede a implementação. Os outros limites (triângulos, Entities, corpos, Materials, Textures e altura) são limites flexíveis: o Creator Hub apresenta avisos quando são excedidos, mas isso resulta sobretudo numa degradação do desempenho, em vez de uma falha impeditiva. Considere-os recomendações importantes.
{% endhint %}

{% hint style="info" %}
**💡 Dica**: nem todos os ficheiros na pasta do projeto da cena contam para o limite de tamanho; apenas os que são enviados para os servidores. Todo o conteúdo da pasta *node\_modules* , que é muito volumoso, consiste em dependências que não são enviadas e, por isso, não conta. O mesmo se aplica a quaisquer ficheiros em `/src` pasta, uma vez que o código-fonte não é carregado.

Pode indicar quaisquer outros ficheiros ou pastas que queira excluir do carregamento no ficheiro `.dclignore` do seu projeto. Tenha em atenção que `.dclignore` também se aplica à pré-visualização local, por isso não indique nada que a sua scene carregue efetivamente. Consulte [O ficheiro dclignore](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/tipos-de-projetos/scene-files.md#the-dclignore-file).
{% endhint %}

## Otimização

Consulte [Otimização do desempenho](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/otimizacao/performance-optimization.md) para obter sugestões sobre como manter a sua scene abaixo destes limites e fazê-la funcionar com maior fluidez para os jogadores.

{% hint style="info" %}
**📱 Dispositivos móveis**: os limites máximos indicados nesta página aplicam-se a todos os clientes, mas os dispositivos móveis têm menos margem do que os computadores. Se o seu objetivo for a [aplicação móvel](https://docs.decentraland.org/creator/content-creator-pt/criar-para-mobile/cliente-movel/overview.md), procure manter-se confortavelmente abaixo destes limites e prefira menos triangles, menos materials e textures mais pequenas.
{% endhint %}

## Limites das Scenes

Ao executar uma pré-visualização, qualquer conteúdo localizado fora dos limites do parcel é realçado a vermelho quando é renderizado. Se houver conteúdo fora destes limites, essa parte não será renderizada quando os jogadores visitarem a sua scene.

Se a ponta de um objeto grande ultrapassar os limites, essa ponta será cortada.

Uma scene de um único parcel mede 16 metros x 16 metros. Se a scene tiver vários parcels, as dimensões variam consoante a disposição dos parcels.

É possível posicionar Entities no subsolo para as ocultar ou deixar que apenas uma parte fique visível. Uma scene não pode ter túneis abaixo da altura predefinida do chão; os jogadores não podem deslocar-se abaixo da altura `y = 0` .

## Limitações dos shaders

Os modelos 3D utilizados no Decentraland têm de usar shaders e materials compatíveis. Consulte [Materiais de modelos 3D](https://docs.decentraland.org/creator/content-creator-pt/modelacao-3d-e-animacoes/materials.md) para ver uma lista dos shaders compatíveis.

## Compressão de Meshes

{% hint style="warning" %}
**📱 Os meshes comprimidos com Draco no** [**cliente móvel**](https://docs.decentraland.org/creator/content-creator-pt/criar-para-mobile/cliente-movel/overview.md) **requerem otimização de assets.** Os modelos glTF/GLB que utilizam compressão de Meshes [Draco](https://google.github.io/draco/) só são carregados na aplicação móvel Decentraland depois de serem processados pelo pipeline de otimização de assets. Se os seus modelos comprimidos com Draco não forem carregados em dispositivos móveis, verifique se foram otimizados — ou exporte os seus modelos **sem** compressão Draco para evitar completamente essa etapa. As outras formas de otimização glTF (quantização, compressão de texturas e redução de Meshes) não são afetadas.
{% endhint %}

## Iluminação

Não é possível alterar as condições de iluminação da scene para todos os jogadores em relação à definição predefinida, embora cada jogador possa alterar as definições do skybox na UI do Explorer.

## Limites do tamanho das texturas

As dimensões das texturas, em píxeis, têm de corresponder aos seguintes valores:

```
1, 2, 4, 8, 16, 32, 64, 128, 256, 512, 1024
```

> Esta sequência é composta por potências de dois: `f(x) = 2 ^ x` . 1024 é o valor máximo permitido para o tamanho de uma textura. As texturas maiores são reduzidas durante o processo de conversão do pacote de assets. Este é um requisito relativamente comum noutros motores de renderização, devido a otimizações internas dos processadores gráficos.

A largura e a altura não precisam de ter o mesmo valor, mas ambas têm de pertencer a esta sequência.

**O tamanho recomendado para as texturas é 1024x1024**, pois concluímos que este é o tamanho ideal para a transferência através de redes domésticas e para proporcionar uma experiência razoável de carregamento e qualidade.

Exemplos de outros tamanhos válidos:

```
32x32
64x32
512x256
512x512
1024x1024
```

{% hint style="warning" %}
**📔 Nota**: Embora por vezes as texturas de tamanhos arbitrários funcionem, também são frequentemente renderizadas com erros e são menos estáveis. Recomendamos vivamente que todas as suas texturas tenham estes tamanhos.
{% endhint %}

## Tamanho do World

Decentraland [Worlds](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/publicacao/publishing-options.md#decentraland-worlds) têm limitações diferentes, uma vez que são carregados como cenas únicas.

* Os Worlds publicados em NAMEs da Decentraland utilizam um orçamento de armazenamento partilhado por todos os Worlds pertencentes à mesma wallet. Cada NAME que possui concede `100 MB`, cada parcela de LAND concede mais `100 MB` e cada 2.000 MANA que possui concedem mais `100 MB`. Pode distribuir este orçamento pelos seus Worlds como preferir.
* Os Worlds publicados em domínios ENS têm um limite de `36 MB` que não pode ser aumentado.

Pode verificar quanto do seu orçamento está a ser utilizado e quanto ainda resta na secção **Gerir** do Creator Hub ou no separador **Worlds** do [Builder](https://decentraland.org/builder/worlds). Se exceder o seu orçamento (por exemplo, após vender ou transferir assets), terá 48 horas para libertar espaço antes de os seus Worlds ficarem inacessíveis.

Consulte [Limite de tamanho dos Worlds](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/tipos-de-projetos/kinds-of-project.md#size-limits) para mais detalhes.

Tamanho total dos ficheiros enviados para o servidor de conteúdo. Inclui modelos 3D e áudio. Não inclui ficheiros que não são enviados, como pacotes node.js. Pode ver a lista completa dos ficheiros a publicar e os respetivos tamanhos antes de confirmar uma implementação.

Todos os outros limites nos Worlds são por parcela, incluindo triângulos, materiais, etc. Como é gratuito adicionar mais parcelas a um World, pode adicionar até 300x300 parcelas (90.000 no total) à sua cena e beneficiar dos limites correspondentes a esse número de parcelas.


---

# 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/otimizacao/scene-limitations.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.
