> 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-zh/chang-jing-sdk7/you-hua/scene-limitations.md).

# 场景限制

我能在场景中放多少东西？

为了提升元宇宙中的性能，我们制定了一套每个场景都必须遵守的限制。这些限制按地块计算。因此，场景越大，这些限制值就越高。

在使用 [创作者中心](/creator/content-creator-zh/chang-jing-bian-ji-qi/kai-shi-shi-yong/editor-installation.md)时，你可以查看场景中 3D 模型所使用资源的统计信息，以及你的场景限制。

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

你可以展开此菜单查看详细信息。

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

{% hint style="info" %}
**💡 提示**：如需查看按地块数量划分的所有具体数值参考表，请参见：

[参考表](https://docs.google.com/spreadsheets/d/1BTm0C20PqdQDAN7vOQ6FpnkVncPecJt-EwTSNHzrsmg/edit#gid=0)
{% endhint %}

## 场景限制规则

以下是场景可同时渲染的元素最大数量：

> *n* 表示场景占用的地块数量。

* **三角形：** `n x 10000` 场景中所有模型的三角形总数。
* **实体：** `n x 200` 场景中的实体数量。
* **网格体：** `n x 300` 场景中的网格数量。
* **材质：** `log2(n+1) x 20` 场景中的材质数量。包括作为模型一部分导入的材质。
* **纹理：** `log2(n+1) x 10` 场景中的纹理数量。包括作为模型一部分导入的纹理。
* **高度：** `log2(n+1) x 20` 以米为单位的高度。

  > 重要：这些限制只会统计当前正在场景中渲染的实体。如果你的场景在不同 3D 模型之间切换，关键是任一时刻正在渲染的模型，而不是总和。玩家头像以及玩家从场景外带入的任何物品，也不计入这些限制的计算。
* **总文件大小：** 在 Genesis City 中 -`每个地块 15 MB - 最大 300 MB`。对于 Worlds，请参见 [世界大小](#world-size)。上传到内容服务器的文件总大小。包括 3D 模型和音频。不包括未上传的文件，例如 node.js 包。在你确认部署之前，你可以看到将要发布的完整文件列表及其大小。
* **文件数量：** `每个地块 200 个文件` 上传文件的总数。包括 3D 模型和音频。不包括未上传的文件，例如 node.js 包。
* **最大文件大小** `每个文件 50 MB` 场景中的任何单个文件都不能超过 50 MB。较小的场景还会受到更严格的限制，因为文件不能超过其总文件大小限制（例如，单地块场景的总大小限制为 15 MB）。

{% hint style="warning" %}
**📔 注意**：文件大小和文件数量限制会在部署时强制执行，超出限制将阻止部署。其他限制（三角形、实体、网格体、材质、纹理、高度）属于软限制：Creator Hub 会以警告形式提示，但超出后通常只会导致性能下降，而不会直接失败。请将它们视为强烈建议。
{% endhint %}

{% hint style="info" %}
**💡 提示**：并非场景项目文件夹中的所有文件都会计入文件大小限制，只有那些会被上传到服务器的文件才算。 *node\_modules* 文件夹中的所有内容体积都很大，但它们是不会被上传的依赖项，因此不计入。 `/src` 文件夹也是如此，因为源代码不会被上传。

你可以在项目中的 `.dclignore` 文件里列出任何其他你想排除在上传之外的文件或文件夹。
{% endhint %}

## 优化

参见 [性能优化](/creator/content-creator-zh/chang-jing-sdk7/you-hua/performance-optimization.md) 中的提示，了解如何让你的场景保持在这些限制之下，并让玩家获得更流畅的运行体验。

{% hint style="info" %}
**📱 移动端**：本页上的硬性限制适用于所有客户端，但移动设备的余量比桌面端更少。在针对 [移动应用](/creator/content-creator-zh/wei-yi-dong-duan-gou-jian/yi-dong-ke-hu-duan/overview.md)时，应尽量舒适地保持在这些限制以下，并优先减少三角形、减少材质和使用更小的纹理。
{% endhint %}

## 场景边界

运行预览时，任何位于地块边界之外的内容在渲染时都会以红色高亮显示。如果有任何内容超出这些边界，那么玩家访问你的场景时，该部分内容将不会被渲染。

如果大型物体的尖端超出了边界，这一尖端会被从物体上切掉。

单地块场景的尺寸为 16 米 x 16 米。如果场景包含多个地块，尺寸会根据地块的排列方式而有所不同。

可以将实体放置在地下，以便隐藏它们或只露出其中一部分。场景不能有低于默认地面高度的隧道，玩家不能移动到 `y = 0` 高度以下。

## 着色器限制

在 decentraland 中使用的 3D 模型必须使用受支持的着色器和材质。有关受支持着色器的列表，请参见 [3D 模型材质](/creator/content-creator-zh/3d-jian-mo-he-dong-hua/materials.md) 。

## 网格压缩

{% hint style="warning" %}
**📱 经过 Draco 压缩的网格在** [**移动端客户端**](/creator/content-creator-zh/wei-yi-dong-duan-gou-jian/yi-dong-ke-hu-duan/overview.md) **需要进行资源优化。** 使用 [Draco](https://google.github.io/draco/) 网格压缩的 glTF/GLB 模型只有在经过资源优化流水线处理后，才会在 Decentraland 移动应用中加载。如果你的 Draco 压缩模型在移动端无法加载，请确认它们已完成优化——或者将模型 **不使用** Draco 压缩导出，以完全避免这一步。其他形式的 glTF 优化（量化、纹理压缩、网格简化）不受影响。
{% endhint %}

## 照明

场景的照明条件无法从默认设置被更改为适用于所有玩家，不过每位玩家都可以在 Explorer UI 中自行更改自己的天空盒设置。

## 纹理尺寸限制

纹理尺寸必须使用符合以下数值的宽度和高度（以像素为单位）：

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

> 这个序列由 2 的幂组成： `f(x) = 2 ^ x` 。我们允许的纹理最大尺寸为 1024，超过这个尺寸的纹理会在资产包转换过程中被缩小。这是其他许多渲染引擎中的常见要求，这是由于图形处理器内部优化所致。

宽度和高度不需要相同，但它们都必须属于这个序列。

**纹理的推荐尺寸是 1024x1024**，我们发现这是通过国内网络传输并提供合理加载/画质体验的最佳尺寸。

其他有效尺寸示例：

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

{% hint style="warning" %}
**📔 注意**：虽然任意尺寸的纹理有时也能正常工作，但它们更容易出现渲染错误，而且稳定性更差。我们强烈建议你的所有纹理都符合这些尺寸。
{% endhint %}

## 世界大小

Decentraland [Worlds](/creator/content-creator-zh/chang-jing-sdk7/fa-bu/publishing-options.md#decentraland-worlds) 拥有不同的限制，因为它们是作为单个场景加载的。

* 发布到 Decentraland NAME 的 Worlds 会使用一个由同一钱包拥有的所有 Worlds 共享的存储预算。你拥有的每个 NAME 可提供 `100 MB`，每个 LAND 地块会额外提供 `100 MB`，持有的每 2,000 MANA 还能额外获得 `100 MB`。你可以按自己的方式在各个 Worlds 之间分配这部分预算。
* 发布到 ENS 域名的 Worlds 最高限额为 `36 MB` ，且无法扩展。

你可以在 **管理** 部分，或在 **Worlds** 选项卡中查看你已使用和剩余的存储额度。 [Builder](https://decentraland.org/builder/worlds)中查看预算已使用多少以及还剩多少。如果你超出了预算（例如在出售或转移资产之后），你有 48 小时来释放空间，否则你的 Worlds 将无法访问。

参见 [Worlds 大小限制](/creator/content-creator-zh/chang-jing-sdk7/xiang-mu-lei-xing/kinds-of-project.md#size-limits) 了解更多详情。

上传到内容服务器的文件总大小。包括 3D 模型和音频。不包括未上传的文件，例如 node.js 包。在你确认部署之前，你可以看到将要发布的完整文件列表及其大小。

Worlds 中的其他所有限制都按地块计算，包括三角形、材质等。由于向一个 world 添加更多地块是免费的，因此你最多可以向场景中添加 300x300 个地块（总计 90,000 个），并获得对应于该地块数量的限制。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.decentraland.org/creator/content-creator-zh/chang-jing-sdk7/you-hua/scene-limitations.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.