For the complete documentation index, see llms.txt. This page is also available as Markdown.

Scene Editor 基础

如何使用 Scene Editor

场景编辑器的 UI 被分成几个不同的部分,各自用途不同。


  • 画布:直接操作物品并查看你的场景效果。

  • 实体树:包含场景中所有物品及其层级的列表。

  • 属性:显示当前选中物品的详细信息。

  • 资源:显示可供使用的资源。

移动视角

要在场景编辑器中四处查看:

  • 使用 W 和 S 键来靠近或远离。你也可以使用鼠标滚轮,或者 + 和 - 按键

  • 使用 A 和 D 来横向移动。

  • 使用 Q 和 E 来上下移动。

  • 点击 鼠标右键 并拖动以旋转相机。

  • 按下 空格键 将相机重置回默认位置

  • 使用 鼠标左键 来点击并选择物品,以及移动它们。

移动端预览

“ 预览 ”按钮旁的下拉菜单中有一个 “显示移动端二维码” 选项。使用同一 Wi‑Fi 网络中的手机扫描二维码,以在 Decentraland 移动应用中打开你的场景。这是为移动玩家验证 UI、控制和性能的推荐方式。请参见 移动端预览 完整指南。

设置地面

场景的地面可以使用各种不同的纹理。你可以在物品菜单中的不同主题资源包里找到它们。

类型为 地面 的物品上带有油漆桶图标。如果你把其中一个拖到场景中,它会用这个物品的副本覆盖整个场景的地面。



你也可以通过按住 Shift 键,将地面拖到场景中时只添加一个该物品的副本。



这些地面物品的集合会出现在 实体树 中的一个文件夹里。它们都已被锁定,以防止被意外选中。 取消锁定 这些物品,即可移动或编辑它们。

添加物品

浏览底部菜单中的主题资源包分类,查找可放置到场景中的不同物品。



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

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



💡 提示:无论何时,只要你添加、移动或编辑场景中任何物品的属性,系统都会自动保存你的更改。

要复制一个物品,请选中它并按 Ctrl + C ,然后按 Ctrl + V。你也可以在 实体树 上右键单击并选择选项 “复制”。新物品会与原物品完全重叠。

要从场景中删除一个物品,请选中它并按 Delete 键。

参见 导入物品 ,用于从磁盘添加你自己的自定义 3D 模型。

定位物品

使用 鼠标左键 单击并拖动选中的物品,即可在场景中地面高度自由移动。

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


  • 移动工具:单击并拖动各个箭头,每次沿一个轴移动物品。使用此工具,你也可以将物品放置在地面以上。

  • 旋转工具:单击并拖动物品周围的各个圆环,每次沿一个轴旋转物品。

  • 缩放工具:单击操纵柄中心并向内或向外拖动以放大。此工具还允许你沿单一轴拉伸物品以改变其比例;为此,单击操纵柄的一条轴并拖动。



要在移动、旋转或缩放物品时获得更高精度,请按住 Shift 键进行调整。这样可以避免吸附到网格。

要更改移动粒度和其他设置,请单击工具右侧的向下箭头。可用设置如下:

  • 吸附:切换网格开关。关闭时, Shift 的行为相反:默认情况下你不会跟随网格,但当你按住 Shift.

    • 位置:开启时, 吸附 每次移动增量的大小,以米为单位。

    • 旋转:开启时, 吸附 每次移动增量的大小,以米为单位。

    • 缩放:开启时, 吸附 每次移动增量的大小,以米为单位。

  • 对齐到世界:一个复选框,表示用于操纵柄的轴。勾选后,移动和旋转工具的轴始终与世界坐标对齐,不会随着物体朝向改变。未勾选时,它们会与物体朝向对齐。

要同时选择多个物品,请按住 Control 键进行选择。然后你可以在一次操作中移动、旋转、缩放、复制或删除它们全部。

输入精确数值

当拖动不够精确时,可改为输入数值:

  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 轴。

💡 提示:画布右下角的键盘图标会打开完整的快捷键列表。

智能物品

智能物品是具有内置交互行为的特殊物品。请参见 智能物品 了解更多细节。



实体树

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

💡 提示:场景中的一切都是实体,它们是场景的基本构建块。物品是至少具有位置和可见形状的实体。

你可以不通过在场景的 3D 视图中单击物品来选择它,而是从树视图中选择它。对某个实体单击鼠标右键可显示更多选项:你可以重命名、删除或复制,还可以创建子实体、将其转换为自定义物品,或为该实体添加组件。

在鸟喷泉实体上打开右键菜单的实体树,菜单中列出了重命名、添加子实体、复制、删除、创建自定义物品和添加组件。

搜索实体树

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

按下 Escape 键 ,或者单击清除图标,以移除筛选并返回完整树。如果某个实体已被选中,清除搜索后会滚动回该选中实体,这样你不会丢失当前位置。

按搜索词 fount 筛选后的实体树:仅剩 Camera、Scene 和 Bird Fountain 实体可见,其中 Scene 父级已展开以显示匹配项。

实体层级

实体遵循一种层级结构,你可以根据需要设置任意多级。通过将一个物品拖到树中的另一个物品上,可以在两个实体之间建立父子关系。子实体会继承父实体的位置,因此当父实体移动时,它会带着所有子实体一起移动。这在构建场景时非常实用,例如你可以把眼镜和盘子设为桌子的子项,然后在不需要重新调整其他内容的情况下移动桌子。在与场景交互时,这也可能很重要,因为多个物品可以一起移动。



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

特殊实体

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

  • Scene:这指的是根实体,你在场景中添加的一切都是它的子项。你可以打开它以查看 场景设置.

  • 玩家:玩家的头像。你可以为该实体添加特殊组件,以改变游戏机制。你也可以把其他实体拖到头像下作为子实体。如果某个实体是头像的子项,它的位置就会固定在玩家身上。例如可用它在玩家头顶添加一个会跟随玩家移动的漂浮标记。

  • 摄像机:玩家的相机。你可以把其他实体拖到相机下作为子实体。如果某个实体是相机的子项,它的位置就会固定在屏幕上。例如可用它在射击游戏中显示一把枪,即使玩家向上或向下看也始终可见。

锁定或隐藏物品

有时锁定一个物品会很方便,这样可以防止你不小心选中并移动它。这对背景物品尤其有用,比如地面或建筑。要锁定一个物品,请在左侧实体树中找到它,悬停其上,然后选择锁定图标。你也可以通过同一个图标切换这一行为。

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



属性面板

在画布或实体树中单击某个物品即可选中它。然后你会在屏幕右侧的属性面板中看到其组件。不同物品拥有不同组件,各自显示特定设置。



大多数非交互物品包含以下组件:

  • 变换:设置物品的位置、旋转和缩放。

  • GLTF:要加载的 3D 模型。

智能物品 可以包含其他组件。

参见 组件 以了解更多。

场景限制

Decentraland 场景需要遵守某些限制,才能让它们可以彼此相邻运行。材质、纹理、三角形等的最大数量与场景中的地块数量成正比。请参见 场景限制 了解更多细节。

如果场景中的内容超过这些限制中的任何一项,场景编辑器会在左下角通知你。



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



💡 提示:如果你正在构建 Decentraland World,你总是可以提高 场景大小 以提高你的限制。

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



💡 提示:如果你想显示的模型放不下,你可能需要增大场景大小。请参见 场景大小 以扩大你的场景。

即使 3D 模型的整个几何体都能放进你的场景中,如果模型的包围盒超出区域,也可能会被标红。如果是这种情况,你可以忽略这些警告,因为整个模型仍会正确显示。了解有关 包围盒.

清理资源

通过移除不再使用的资源来保持项目整洁。打开 本地资源 选项卡并单击刷子图标。

会打开一个对话框,列出场景中的所有资源,并突出显示那些未被任何物品引用的资源。

使用复选框选择要删除的资源,然后单击 “移除所选项” 将其永久删除。

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

场景设置

点击 铅笔图标 位于屏幕右上角。点击后会打开一系列场景级属性供你编辑。



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

参见 场景设置.

另请参见

  • 参见 智能物品 了解如何为你的场景添加简单交互。

  • 参见 与代码结合 了解如何编辑场景代码。

  • 参见 发布场景 了解如何将你的场景发布到 Decentraland。

最后更新于