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

发布场景

如何将你的场景发布到 LAND 或 NAME。

开始之前

请确保以下内容:

  • 你的场景符合所有 场景限制。其中大多数都会在你每次运行场景预览时进行验证。

  • 你有一个 MetaMask 账户,其中已分配了你的 LAND 地块或 NAME。

  • 你拥有足够数量相邻的 LAND 地块或一个 Decentraland NAME。否则,你可以在 Marketplace 或在其中购买一个 NAME Marketplace.

检查你的 场景详情,请确保提供一个吸引人的名称、描述、缩略图、类别等。

发布你的场景

要发布你的场景:

  1. 在 Scene Editor 中打开你的场景并点击 发布。这将打开一个窗口,显示发布的详细信息。

  2. 选择是要发布到 LAND 还是 WORLD。参见 项目类型 以更好地了解不同选项。


  1. 如果发布到 LAND,请在地图上选择位置。你会看到符合条件的地块以红色标出。如果发布到 WORLD,你会在下拉菜单中看到符合条件的 NAME。

💡 提示:如果你没有看到你的地块或 NAME,请确保你使用正确的用户账号连接到了 Creator Hub。否则,请退出项目,点击右上角的用户设置图标,然后选择 退出登录 并重新登录。

  1. 下一个界面会显示你当前正在上传的所有文件及其大小,请确认操作。

  2. 随后将开始发布流程。它分为两个阶段,完成后会出现一个 进入 按钮。 

📔 注意:部署的两个阶段包括:

  • 1. 上传:将文件上传到服务器。

  • 2. 转换:场景的 3D 模型会被压缩为 Asset Bundles,以便更快渲染。这通常只需几秒钟。对于非常大的场景,可能会更久。

Decentraland 的服务器还会为你的模型生成低细节层级(LOD)版本,用于从远处绘制你的场景。这项工作会在你的场景已经上线后在后台进行,因此发布过程不会等待它完成。

发布需要多长时间?

  • 直到你可以测试它:从几秒到几分钟不等。时间长短取决于你的场景总大小和上传带宽。 进入 按钮会在场景可运行后立即出现,也就是两个阶段都完成之后。

  • 在直播活动前:请至少在活动开始前一小时发布最终版本,以留出处理突发情况的时间。

以下因素会使发布变慢:

  • 场景总大小:会影响上传和转换。

  • 不同 3D 模型的数量和复杂度:模型会逐个转换。

  • 转换服务器的繁忙程度:你的场景可能会排在其他同时发布的场景之后等待。

管理 World

Creator Hub 可通过 管理 选项卡在其主面板中进行 World 管理。该 管理 选项卡可用于跟踪和编辑 World。在这里,你可以编辑 World 设置、权限和场景。

World 存储预算

发布到 World 的场景会计入一个存储预算,该预算由你钱包拥有的所有 World 共享。预算会随着你的持有量增长:你拥有的每个 Decentraland NAME 或 LAND 地块可获得 100 MB,而钱包中每持有 2,000 MANA 可额外获得 100 MB。发布到 ENS 域名的 World 则有固定 36 MB 上限。

该 管理 选项卡会显示你已使用多少存储预算。点击 查看详情 查看你的 MANA、LAND 和 NAME 持有量如何累计。

你也可以在 Worlds 选项卡中查看剩余预算,位于 Builder.

参见 World 大小限制 了解预算如何计算以及超出预算后会发生什么。

World 设置

World 拥有者可以进入所需的 World 设置 下的 管理 面板中编辑,或者在发布过程中通过点击 设置 如果 多场景 World(高级) 已启用。

  • 详情:World 的一般信息:

    • World 标题

    • 描述

    • 内容分级

    • 类别

在 详情 中添加的信息在发布后会显示在 Decentraland Places 和 World 内的信息中。请记住,如果该 World 只包含一个场景,这些详细信息会在每次发布时被场景元数据覆盖。参见 World 元数据与场景元数据 如下。

  • 布局:仅可在多场景 World 中访问。包含该 World 中所有已发布场景的信息。

    • 通过点击三个点并选择以下选项来移除单个场景 从 World 中移除.

    • World 地图 显示 World 布局,并标识有内容的地块和剩余空闲地块。

  • 其他:其他有用的 World 配置:

    • World 出生坐标:这用于设置用户在 World 中出生的地块 (X,Y)。位于该地块中的场景决定用户出生的具体位置(例如,地块 1,1 是 World 出生点,而位于 1,1 的场景的出生点为 1,0,1 ,位于该场景内部).

    • 天空盒设置

📔 注意:World 设置仅对 World 拥有者(铸造该 NAME 的地址)可访问。有关如何获取 NAME 的更多详情,请查看 Marketplace 的 NAME 部分.

World 元数据与场景元数据

一个 World 及其发布到其中的每个场景都有两套独立的元数据。二者都包含名称、描述和缩略图:

  • 场景元数据:属于场景项目,存储在其 scene.json 文件中。你可以通过 场景设置 在 Scene Editor 中进行编辑,并且每次发布时都会随场景一起上传。

  • World 元数据:属于 World 本身。你可以在该 World 的 设置中,在 管理 Creator Hub 的选项卡中进行编辑。这些信息会显示在 Decentraland Places 和 World 内的信息中。

这两者之间的关系取决于该 World 包含多少个场景:

  • 空白 World:当你将场景发布到一个空白 World 时,World 的元数据会从场景元数据中填充。

  • 单场景 World:每次你发布场景时,World 的元数据都会更新为与场景元数据一致。

  • 多场景 World:World 的元数据完全独立于其每个场景的元数据。发布场景不会更改 World 的元数据。更改它的唯一方式是通过该 World 的 设置 在 管理 选项卡中。

实际上,如果你的 World 只包含一个场景,你无需将 World 的元数据视为独立内容:只需编辑场景设置并发布,World 就会始终反映这些设置。

在多场景 World 中,World 的 设置 在 管理 选项卡是编辑 World 元数据的唯一位置。

多场景 Worlds

一个 World 可以包含多个场景,由 World 拥有者或其他创作者发布。这使得每个地块都可以由不同的协作者管理,从而实现协作环境。

将 World 设为多场景

World 拥有者可以通过切换 多场景 World(高级) ,在向单场景 World 发布时将其设为多场景。

一旦多场景 World 发布后,World 拥有者可以继续发布其他场景,或添加协作者在该 World 内发布。

📔 注意:多场景 World 的大小会自动适应以容纳所有已发布的场景,并在每次发布时动态扩展或缩小。多场景 World 中不同场景之间剩余的空间会由环境填充。

向多场景 World 添加协作者

在 管理 面板中,World 拥有者可以访问该 World 的 权限 ,方法是点击三个点。World 拥有者可以在 协作者 选项卡中。

协作者可以拥有对所有地块或特定自定义坐标的部署权限。自定义坐标可通过交互式 World 地图选择并确认,类似于 World 设置中的地图。

作为协作者向多场景 World 部署

World 协作者不能编辑其设置或权限。在 管理 选项卡中,创作者可以看到他们作为协作者所在的 World,但无法访问 设置 或 权限.

在发布过程中,创作者可以选择仅发布到他们作为协作者的地块(由 World 拥有者设置)。

在 协作者 部分,如果 World 拥有者将 自定义坐标 分配给创作者,则只有指定的地块可用于发布。如果访问权限设置为 所有地块,创作者就可以选择 World 中任意地块来发布他们的场景。

私有 World

一个 WORLD 可以有不同的 访问权限 设置。它可以对任何人开放,也可以通过不同方式进行限制。

设置 WORLD 的访问权限

在 管理 面板中,World 拥有者可以访问该 World 的 权限 ,方法是点击三个点。World 拥有者可以在 访问权限 选项卡中。

访问类型

World 拥有者可以在三种 World 访问权限:

公开

任何人都可以访问该 World。这是 World 的默认设置。

密码保护

只有拥有密码的用户才能进入该 World。

密码长度必须至少为 8 个字符,并且至少包含 2 个数字。创建后密码将无法再次查看,因此请务必保存一份副本。

仅限邀请

只有在 已批准地址 中添加的地址和社区才能访问该 World。

要向 已批准地址添加新地址或社区,请按以下步骤操作:

  1. 点击 + 新邀请 按钮。

  2. 你可以通过三种不同方式添加地址:

  • 钱包地址:逐个添加单独的钱包。

  • 社区:搜索并添加任何公开社区。这会将 所有社区地址 添加到 已批准地址.

  • 导入 CSV:使用现有的 CSV,其中包含地址或社区 ID 列表,以添加到 已批准地址。格式为每行一个钱包,例如:

导入后,它会如图所示单独跟踪每个地址。

  1. 确认后,这些地址将位于 已批准地址.

  2. 通过新的 + 新邀请,地址会被添加到现有列表中,帮助 World 拥有者在需要时管理并扩展该列表。

  1. 单个地址或一组地址(如果是社区)可以通过选择 删除 在 已批准地址 部分中的三个点。

进入私有 World

如果用户进入一个没有 公开 访问权限的 World,会有不同情况:

  • 他们在 已批准地址:将能够正常加入。否则,他们会收到该 World 为 仅限邀请.

  • 该 World 是 密码保护:用户可以输入密码。最多可尝试十(10)次。

从硬件钱包发布

与其将你的 LAND 代币存放在 MetaMask 账户中,不如将它们存放在硬件钱包设备中,这样可能更安全,例如 Ledger 或 Trezor,该设备会物理连接到你的电脑。

如果你使用这些设备之一,可以将硬件钱包链接到 MetaMask 以启用消息签名,同时让代币更安全。请参见 MetaMask 的这篇文章 了解如何连接你的账户。

一旦你的硬件钱包可以通过 MetaMask 使用,你就可以按照与代币存放在 MetaMask 账户中相同的步骤进行部署。

场景覆盖

当新场景部署时,它会覆盖其所占地块上已有的旧内容。

发布通常会立即开始。如果你即将替换 World 中已存在的内容,Creator Hub 会先要求你确认,并提供一个 不再显示 选项。

如果一个占用多个地块的场景只被另一个场景部分覆盖,那么它的所有地块都会被覆盖或清除。

假设你部署了你的场景 A 占用两个地块 [100, 100] 以及 [100, 101]。 [100, 101] 给一位拥有相邻土地的用户,而对方部署了一个大型场景(B)到多个地块,包括 [100, 101].

你的场景 A 不能只在一个地块上部分渲染,因此 [100, 100] 不会显示任何内容。你必须构建场景的新版本 A ,使其只占用一个地块,并仅部署到地块 [100, 100].

发布到授予的土地

如果你要发布到由 Decentraland Foundation 拥有、并通过资助授予给你的土地,请点击 发布 按钮,然后选择 发布到不同的服务器 在底部。然后选择 自定义服务器 ,并从下拉菜单中输入以下服务器地址: https://linker-server.decentraland.org.

自定义服务器

你可以将内容部署到不属于 DAO 官方维护的催化器服务器网络的自定义服务器。为此,你无需拥有任何 LAND 或 NAME 代币,因为你可以配置服务器使用你偏好的任何验证逻辑来控制谁可以在何处部署。自定义服务器可以选择从官方服务器获取内容并允许你覆盖,或者从空白开始并完全发布全新内容。

要发布到自定义服务器,请点击 发布 按钮,然后选择 发布到不同的服务器 在底部。然后选择 自定义服务器 ,并从下拉菜单中输入服务器地址。

参见 如何运行你自己的 Catalyst 节点 ,了解有关你自己的服务器可以做什么以及如何设置它的更多信息。

系统不会将玩家自动引导到该服务器,访问它的唯一方式是显式输入其 URL 进行连接。

验证部署是否成功

一旦你部署了场景,这些更改可能需要几分钟才能上传和处理。如果你在部署后立即进入 Decentraland,可能会短暂看到旧版本的内容。

Creator Hub 会显示发布进度,它会依次经过 上传 以及 转换 阶段,并在 进入 按钮在场景可运行后立即显示。

检查转换状态

在新版本的 3D 模型转换期间,玩家会被刻意提供你场景最后一个完全可用的版本。转换通常最多只需几分钟,如果更久,可能表示某些步骤失败了。

你可以直接在浏览器中查询转换状态:

  • https://asset-bundle-registry.decentraland.org/entities/status/<pointer>:将 <pointer> 替换为你场景的某个坐标(例如 20,-34) assetBundles,以及 LOD 的状态在 lods下。 当 complete 为 true时,该场景已在所有平台上完全转换。对于位于 World 中的场景,请将 World 名称作为查询参数添加,例如 .../entities/status/0,0?world_name=myname.dcl.eth.

  • https://asset-bundle-registry.decentraland.org/queues/status:按平台列出当前等待转换的所有场景 ID。如果你的实体 ID 出现在这里,说明你的场景排在其他转换之后队列中,你只需要再等待一会儿。

最后更新于