> 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).

# 场景限制

我可以在场景中放多少东西？

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

使用 [创作者中心](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-bian-ji-qi/ru-men/editor-installation.md)时，您可以查看场景中 3D 模型所用资源的统计数据，以及场景的限制。

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

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

![](https://2460066822-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" %}
**💡 提示**：如需查看按地块数量列出的各项具体数值，请参阅：

[参考表](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` 场景中的纹理数量，包括作为模型一部分导入的纹理。
* **高度：** `330 meters` 场景的最大高度，与场景占用的地块数量无关。

  > 警告：放置在 200 米以上的实体可能会出现多人游戏同步问题。请将玩家可交互的内容或需要在玩家之间同步的内容保持在该高度以下。

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

{% hint style="warning" %}
**📔 注意**：部署时会强制执行文件大小和文件数量限制，超出限制将阻止部署。其他限制（三角形、实体、刚体、材质、纹理、高度）属于软性限制：创作者中心会将超限情况报告为警告，但超限通常只会导致性能下降，而不会直接导致失败。请将这些限制视为重要建议。
{% endhint %}

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

你可以在项目的 `.dclignore` 文件中列出要排除、不上传的其他文件或文件夹。请注意， `.dclignore` 这也适用于本地预览，因此不要列出场景实际加载的任何内容。请参阅 [dclignore 文件](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-sdk7/xiang-mu-lei-xing/scene-files.md#the-dclignore-file).
{% endhint %}

## 优化

请参阅 [性能优化](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-sdk7/you-hua/performance-optimization.md) ，了解如何让场景保持在这些限制范围内，并让玩家体验更流畅。

{% hint style="info" %}
**📱 移动设备**：本页所列的硬性限制适用于所有客户端，但移动设备的性能余量小于桌面设备。若要适配 [移动应用](https://docs.decentraland.org/creator/content-creator-zh/mian-xiang-yi-dong-duan-gou-jian/yi-dong-ke-hu-duan/overview.md)，请尽量留出充足余量，并优先减少三角形数量、材质数量和纹理尺寸。
{% endhint %}

## 场景边界

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

如果大型物体的尖端超出边界，这部分尖端会被切掉。

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

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

## 着色器限制

Decentraland 中使用的 3D 模型必须使用受支持的着色器和材质。请参阅 [3D 模型材质](https://docs.decentraland.org/creator/content-creator-zh/3d-jian-mo-yu-dong-hua/materials.md) ，查看受支持的着色器列表。

## 网格压缩

{% hint style="warning" %}
**📱 移动客户端上的 Draco 压缩网格** [**移动客户端**](https://docs.decentraland.org/creator/content-creator-zh/mian-xiang-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 界面中自行更改天空盒设置。

## 纹理尺寸限制

纹理的宽度和高度（以像素为单位）必须符合以下数值序列：

```
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](https://docs.decentraland.org/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`。你可以按照自己的意愿在各个 World 之间分配这项额度。
* 发布到 ENS 域名的 Worlds 上限为 `36 MB` ，且无法扩容。

你可以在 Creator Hub 的 **管理** 部分，或在 **Worlds** 标签页中查看已用额度和剩余额度。 [Builder](https://decentraland.org/builder/worlds)。如果超出额度（例如在出售或转移资产后），你有 48 小时腾出空间，否则你的 Worlds 将无法访问。

详情请参阅 [Worlds 大小限制](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-sdk7/xiang-mu-lei-xing/kinds-of-project.md#size-limits) 。

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

World 中的所有其他限制均按地块计算，包括三角形数量、材质等。由于向 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 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-zh/chang-jing-sdk7/you-hua/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.
