> 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/ru-men/scene-editor-essentials.md).

# Scene Editor 基础

如何使用 Scene Editor

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

![
](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\&token=88a9399c-d2d6-421c-8400-82905670e298)

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

## 移动浏览

要在场景编辑器中熟悉操作：

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

## 在移动端预览

该 **播放选项** 紧挨着…… **播放** 按钮旁的菜单有一个 **显示用于移动设备的二维码** 选项。使用与设备处于同一 Wi‑Fi 网络的手机扫描 QR 码，即可在 [Decentraland 移动应用](/creator/content-creator-zh/mian-xiang-yi-dong-duan-gou-jian/yi-dong-ke-hu-duan/overview.md)中打开你的场景。这是验证移动玩家的 UI、控制和性能的推荐方式。参见 [在移动端预览](/creator/content-creator-zh/mian-xiang-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\&token=4c0c854a-72d9-4dc8-853d-7ef652c50cc3)

你也可以通过按住 **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\&token=46274493-559b-40d7-858a-181664dfe9b9)

地面项目集合会出现在 [实体树](#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\&token=99210953-9718-4fa7-895c-317c45f74d6e)

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

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

![
](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\&token=5d263b79-cd82-4436-bc8e-3a07e68df559)

{% 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\&token=72f1d0d2-cd0c-44dd-a3a0-bc32997577d3)

* **移动工具**：点击并拖动每个箭头，可一次只沿一个轴移动项目。使用此工具你还可以把物体放在地面以上。
* **旋转工具**：点击并拖动项目周围的每个圆环，可一次只绕一个轴旋转项目。
* **缩放工具**：点击操控器中心并向内或向外拖动即可放大。该工具还允许你沿单一轴拉伸项目以改变比例；为此，请点击操控器的某个轴并拖动。

![
](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\&token=513ffbb0-992c-4a68-b2e8-8971081d1b57)

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

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

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

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

### 输入精确数值

当拖动不够精确时，直接输入数值：

1. 按下一个工具键： **M** 或 **G** 表示移动， **R** 表示旋转， **X** 表示缩放。
2. 按 **X**, **Y** 或 **Z** 以选择一个轴。缩放不需要轴：没有轴时，它会按相同系数缩放所有轴。
3. 输入数字。使用 **.** 表示小数，使用 **-** 在正数和负数之间切换。
4. 按 **Enter** 以应用，或按 **Esc** 取消。 **Backspace** 可删除你输入的内容。

画布底部的一个提示条会在你输入时显示该值，告诉你还缺少什么，并确认已应用的内容。

一些示例：

* **R** **X** **1** **5** **Enter** 将所选内容绕 X 轴旋转 15 度。
* **X** **2** **Enter** 让所选内容变为两倍大。
* **M** **Y** **-** **3** **Enter** 将其向下移动 3 米。

还有几点值得了解：

* 输入的数值始终是相对于当前所选内容的位置，而不是绝对坐标。
* 键入的数值会忽略吸附网格。
* 当选中多个项目时，它们会围绕共同中心一起移动、旋转或缩放，并且只算作一次撤销步骤。
* 按 **M**, **G** 或 **R** 第二次仍会关闭其操控器。 **X** 不会，因为在输入时它表示 X 轴。

{% hint style="info" %}
**💡 提示**：画布右下角的键盘图标会打开完整快捷键列表。
{% endhint %}

## 智能项目

智能项目是自带交互行为的特殊项目。参见 [智能项目](/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\&token=8f5f5b70-db16-4d37-b41c-4ee0eafe87e4)

## 实体树

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

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

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

![在 Bird Fountain 实体上打开右键菜单的实体树，菜单列出重命名、添加子项、复制、删除、创建自定义项目和添加组件。](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-7e0e6082ae86443a0412c2f58c6bf75e94a754c4%2Fentity-tree-context-menu.png?alt=media\&token=45339b1e-d4df-4c63-aa89-408cda1c50e6)

### 搜索实体树

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

按 **Escape** 或点击清除图标，可移除筛选并返回完整树。如果某个实体已被选中，清除搜索会滚回该选中的实体，以免你丢失当前位置。

![按搜索词 fount 过滤后的实体树：只有 Camera、Scene 和 Bird Fountain 实体仍可见，并且 Scene 父节点已展开以显示匹配项。](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-6a4ecf3021b21dc6e02f1bedabea0aa348d6de18%2Fentity-tree-search.png?alt=media\&token=1b43f8ba-3dbc-4d14-836c-87c27cddc493)

### 实体层级

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

![
](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\&token=ac266788-86d2-4793-bb76-073ea66b0439)

你也可以折叠或展开某个实体的子项来保持视图简洁，这个操作不会影响场景。

### 特殊实体

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

* **场景**：这指的是根实体，你在场景中添加的一切都是它的子项。你可以展开它以查看 [场景设置](#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\&token=648fe2be-673c-4890-ac27-c646bac6c28a)

## 属性面板

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

![
](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\&token=916b4ef9-6a25-4cc9-beaa-553b6ebed067)

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

* **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\&token=6ba1a8ad-a1e4-472b-b9ca-a3b9d1aab9d8)

你可以展开此菜单以查看详情。

![
](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\&token=65973f60-8eda-4193-9a81-f5a42d4c5032)

{% 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\&token=8c34ee0f-332c-4f3d-ad72-7a7a8ee04af6)

{% 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-yu-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\&token=834078d5-f08b-44a9-9dd3-413d66ee9a3f)

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

![](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\&token=9ef69edf-2d70-4bec-96c3-dbef10420763)

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

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

{% hint style="warning" %}
**重要：** 如果你的场景中包含引用资源的代码，一些正在使用的资源可能会显示为未使用。此对话框只会检测 Creator Hub UI 中由组件引用的资源。在你点击 **移除所选项**后，这些文件会从项目文件夹中删除，此操作是永久性的，无法撤销。
{% 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\&token=21677d31-8915-4809-a60a-6674c7497d98)

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

参见 [场景设置](/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 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-bian-ji-qi/ru-men/scene-editor-essentials.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.