> 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-bian-ji-qi/kai-shi-shi-yong/scene-editor-essentials.md).

# 场景编辑器基本要点

如何使用场景编辑器

场景编辑器的界面被分为几个不同的部分，各自有不同的用途。

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

* **画布**：可直接操作项目，并查看你的场景效果。
* **实体树**：包含场景中所有项目及其层级的列表。
* **属性**：显示当前选中项目的详细信息。
* **资源**：显示可供使用的资源。

## 移动

要在场景编辑器中找到方向：

* 使用 **W** 和 **S** 以靠近或远离。你也可以使用鼠标滚轮，或者 **+** 和 **-** 键
* 使用 **一个** 和 **D** 以横向移动。
* 使用 **Q** 和 **E** 以上下移动。
* 点击 **鼠标右键** 并拖动以旋转摄像机。
* 按 **空格键** 将摄像机重置回默认位置
* 使用 **鼠标左键** 以点击并选择项目并将它们拖动到周围。

## 在移动端预览

位于 **预览** 按钮旁边的下拉菜单有一个 **在移动设备上显示二维码** 选项。使用与之位于同一 Wi‑Fi 网络的手机扫描二维码，即可在 [Decentraland 移动应用](/creator/content-creator-zh/wei-yi-dong-duan-gou-jian/yi-dong-ke-hu-duan/overview.md)中打开你的场景。这是验证移动玩家的 UI、控件和性能的推荐方式。参见 [在移动端预览](/creator/content-creator-zh/wei-yi-dong-duan-gou-jian/kai-fa/preview-on-mobile.md) 以查看完整指南。

## 设置地面

场景的地面可以使用各种不同的纹理。你可以在项目菜单中不同主题的资源包里找到这些纹理。

类型为 **地面** 的项目上带有油漆桶图标。如果你把其中一个拖入场景，它会用该项目的副本覆盖场景中的全部地面。

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

你也可以通过按住 **Shift** 并将地面拖到场景中时，添加该项目的单个副本。

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

地面项目集合显示在 [实体树](#the-entity-tree) 中的文件夹里。它们每一个都被锁定，以防止被意外选中。 [取消勾选](#lock-or-hide-items) 这些项目即可移动或编辑它们。

## 添加项目

通过底部菜单上的主题资源包分类进行浏览，找到可放置在场景中的不同物品。

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

你也可以使用搜索框。请注意，当你位于某个资源包内时，搜索只会在该资源包内查找。

要放置项目，请从资源包菜单中点击并拖动到画布中场景上的某个位置。

![
](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-30237e6006c76b69f5cfe737e543875987ed67b8%2Fdrop-item.gif?alt=media)

{% hint style="info" %}
**💡 提示**：每当你在场景中添加、移动或编辑任何项目的属性时，所做的更改都会自动保存。
{% endhint %}

要复制一个项目，请选中它并按下 **Ctrl + C** 然后 **Ctrl + V**。你也可以在 [实体树](#the-entity-tree) 上右键单击并选择 **复制**选项。新项目会与原项目完全重叠。

要从场景中删除一个项目，请选中它并按下 *删除* 键。

参见 [导入项目](/creator/content-creator-zh/chang-jing-bian-ji-qi/gou-jian/import-items.md) ，用于从磁盘添加你自己的自定义 3D 模型。

{% hint style="warning" %}
**📔 注意**：一旦你将 3D 模型拖入场景，它就会下载到你的项目文件夹中，即使你删除它也仍会保留在那里。这些未使用的模型会增加场景体积。

打开 **本地资源** 选项卡，删除任何未使用的模型。
{% endhint %}

## 放置项目

{% embed url="<https://www.youtube.com/watch?v=cNl02PFPdcQ>" %}

使用 **鼠标左键** 并拖动选中的项目，即可在地面高度自由地在场景中移动。

你也可以使用顶部菜单中的工具：

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

* **移动工具**：点击并拖动每个箭头，一次沿一个轴移动项目。使用此工具，你还可以将物体放置在地面以上。
* **旋转工具**：点击并拖动围绕项目的每个圆环，一次沿一个轴旋转项目。
* **缩放工具**：点击操控器中心并向内或向外拖动以放大。该工具还可让你沿单一轴拉伸项目以改变其比例；要这样做，请点击操控器的一条轴并拖动。

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

要在移动、旋转或缩放项目时获得更高精度，请在调整时按住 *Shift* 键。这将避免吸附到网格。

要更改移动步进精度和其他设置，请点击工具右侧的向下箭头。可用设置如下：

* **吸附**：开启或关闭网格。关闭时， **Shift** 的行为会反过来：默认情况下你不会跟随网格，但按住 **Shift**.
  * **位置**：在 **吸附** 开启时，移动增量的单位为米，大小为
  * **旋转**：在 **吸附** 开启时，移动增量的单位为米，大小为
  * **缩放**：在 **吸附** 开启时，移动增量的单位为米，大小为
* **对齐到世界**：一个单独的复选框，用于控制操控器所使用的轴。勾选后，移动和旋转工具的轴始终与世界对齐，不会随物体的朝向改变。未勾选时，则会与物体的朝向对齐。

要同时选中多个项目，请在选择它们时按住 *控制* 键。然后你可以一次性对它们全部进行移动、旋转、缩放、复制或删除。

## 智能项目

智能项目是带有内置交互行为的特殊项目。参见 [智能项目](/creator/content-creator-zh/chang-jing-bian-ji-qi/jiao-hu-xing/smart-items.md) 了解更多详情。

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

## 实体树

在左侧边栏，你会看到一个包含场景中所有实体的树状结构。这包括你添加的所有项目，以及一些默认实体。

{% hint style="info" %}
**💡 提示**：场景中的一切都是实体，它们是场景的基本构件。项目是至少具有位置和可见形状的实体。
{% endhint %}

你可以不通过点击场景的 3D 视图中的项目来选中它，而是从树状视图中选中它。在某个实体上点击鼠标右键，可显示更多选项：你可以重命名、删除或复制，还可以创建子实体，或为该实体添加组件。

### 搜索实体树

实体树顶部的搜索框可让你按名称查找实体。输入实体名称的一部分后，树会筛选出只显示匹配的实体及其父级层级，这样你就能看到每个匹配项在树中的位置。搜索不区分大小写。匹配项的父实体会自动展开，因此每个结果都可见。

按 **Esc** 或点击清除图标可移除筛选条件并返回完整树。如果某个实体已被选中，清除搜索后会滚动回该实体，这样你就不会丢失位置。

\[截图：实体树中输入了搜索词，显示筛选结果和展开的父级层级]

### 实体层级

实体遵循一种可拥有任意层级的层级结构。你可以在树中将一个项目拖到另一个项目上，从而在两个实体之间建立父子关系。子实体会继承父实体的位置，因此当父实体移动时，它会带着所有子实体一起移动。这在构建场景时很实用，例如你可以把玻璃杯和盘子设为桌子的子项，然后移动桌子而无需调整其他任何内容。在与场景交互时，项目一起移动也可能很重要。

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

你也可以最小化或展开某个实体的子项，以保持视图简洁；此操作不会影响场景。

### 特殊实体

场景中包含几个你可以在实体树中看到的特殊实体。

* **场景**：这指的是根实体，你在场景中添加的一切都是该实体的子项。你可以展开它以查看 [场景设置](#scene-settings).
* **玩家**：玩家的头像。你可以为该实体添加特殊组件，从而改变游戏机制。你也可以将其他实体拖到头像下作为子项。如果某个实体是头像的子项，它的位置将固定在玩家身上。比如可用它在玩家头顶添加一个会跟随玩家移动的悬浮标记。
* **摄像机**：玩家的摄像机。你可以将其他实体拖到摄像机下作为子项。如果某个实体是摄像机的子项，它的位置将固定在屏幕上。比如可用它在射击游戏中显示一把枪，即使玩家抬头或低头，它也始终可见。

### 锁定或隐藏项目

有时你可能会觉得锁定某个项目很方便，这样可以防止意外选中和移动它。这对背景项目尤其有用，例如地面或建筑。要锁定一个项目，请在左侧实体树中找到它，悬停其上，然后选择锁定图标。你可以通过同一个图标切换此行为的开启和关闭。

你也可能希望隐藏某个会在放置其他物体时遮挡视线的项目。这对在室内工作时隐藏屋顶或建筑尤为有用。隐藏的项目只会在场景编辑器的画布窗口中隐藏，不会对进入场景的玩家隐藏。要隐藏一个项目，请在左侧实体树中找到它，悬停其上，然后选择眼睛图标。你可以通过同一个图标切换此行为的开启和关闭。

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

## 属性面板

通过点击画布或实体树中的项目来选中它。之后，你会在屏幕右侧的属性面板中看到它的组件。不同项目具有不同的组件，每个组件都会显示特定设置。

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

大多数非交互式项目具有以下组件：

* **Transform**：设置项目的位置、旋转和缩放。
* **GLTF**：要加载的 3D 模型。

[智能项目](/creator/content-creator-zh/chang-jing-bian-ji-qi/jiao-hu-xing/smart-items.md) 可以包含其他组件。

参见 [组件](/creator/content-creator-zh/chang-jing-bian-ji-qi/gou-jian/components.md) 了解更多。

## 场景限制

Decentraland 场景需要遵循某些限制，才能让它们彼此相邻运行。材质、纹理、三角形等的数量都有上限，这些上限与场景中的地块数量成比例。参见 [场景限制](/creator/content-creator-zh/chang-jing-sdk7/you-hua/scene-limitations.md) 了解更多详情。

如果场景中的内容超出了这些限制，场景编辑器会在左下角通知你。

![
](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" %}
**💡 提示**：如果你正在构建 Decentraland World，你总是可以提高 [场景大小](/creator/content-creator-zh/chang-jing-bian-ji-qi/pei-zhi/scene-settings.md#layout) 以提高你的限制。
{% endhint %}

Decentraland 场景中的内容也必须避免溢出到相邻地块。如果你场景中的模型有任何部分超出限制，在打开场景预览时，你会看到这些部分被裁掉。场景编辑器会将整个模型标为红色，但你真正需要注意的只是模型中超出场景限制的部分。

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

{% hint style="info" %}
**💡 提示**：如果你想显示的模型放不下，你可能需要增大场景大小。参见 [场景大小](/creator/content-creator-zh/chang-jing-bian-ji-qi/pei-zhi/scene-settings.md#layout) 来放大你的场景。
{% endhint %}

即使 3D 模型的整个几何体都能放进你的场景中，如果模型的包围盒超出了区域，模型也可能会被标为红色。在这种情况下，你可以忽略这些警告，因为整个模型会被正确显示。进一步了解 [包围盒](/creator/content-creator-zh/3d-jian-mo-he-dong-hua/meshes.md#bounding-boxes).

## 清理资源

通过移除不再使用的资源，让你的项目保持整洁。打开 **本地资源** 屏幕底部的选项卡，然后点击刷子图标。

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

会打开一个对话框，列出场景中的所有资源，并高亮显示那些未被任何项目引用的资源。

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

使用复选框选择要删除的资源，然后点击 **删除所选** 以永久移除它们。

从场景中删除一个项目不会删除其文件。导入的模型、纹理或声音会保留在你的项目中，直到你清理它们，因此请定期检查未使用的资源。

{% hint style="warning" %}
**重要：** 如果你的场景包含引用资源的代码，一些正在使用的资源也可能会被显示为未使用。此对话框只会检测 Creator Hub 界面中由组件引用的资源。在你点击 **删除所选**之后，这些文件会从项目文件夹中删除，此操作是永久性的，无法撤销。
{% endhint %}

## 场景设置

点击 **铅笔图标** 屏幕右上角的。这会打开一系列可编辑的场景级属性。

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

在这里你可以配置多个属性，包括标题和缩略图、场景大小、场景类别和年龄分级、玩家出生位置，以及功能开关。

参见 [场景设置](/creator/content-creator-zh/chang-jing-bian-ji-qi/pei-zhi/scene-settings.md).

## 另请参阅

* 参见 [智能项目](/creator/content-creator-zh/chang-jing-bian-ji-qi/jiao-hu-xing/smart-items.md) 以了解如何为你的场景添加简单交互。
* 参见 [与代码结合使用](/creator/content-creator-zh/chang-jing-bian-ji-qi/shi-yong-dai-ma-kuo-zhan/overview.md) 了解如何编辑场景代码。
* 参见 [发布场景](/creator/content-creator-zh/chang-jing-bian-ji-qi/fa-bu/publish-scene.md) 以了解如何将你的场景发布到 Decentraland。


---

# 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-bian-ji-qi/kai-shi-shi-yong/scene-editor-essentials.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.