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

# 预览你的场景

你可以在场景预览中看到什么

一旦你已经 [构建了一个新场景](#create-your-first-scene) 或下载了一个 [场景示例](https://studios.decentraland.org/resources?sdk_version=SDK7) ，你就可以在本地预览它。

## 在 Creator Hub 中使用 Scene Editor

确保你已经 [安装了 Creator Hub](https://github.com/decentraland/docs/tree/main/creator/sdk7/get-started/editor-installation.md).

1. 打开你的场景项目。
2. 点击 **预览** 按钮位于右上角。这会打开一个新的窗口，其中运行着 Decentraland Desktop Explorer，只加载你的场景。在那里，你可以在场景中移动并与可交互物品互动。

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

通过旁边下拉菜单配置不同的预览选项 **预览** 按钮：

* **使用以下方式预览**：在以下之间选择 **桌面客户端** （默认的 Decentraland Explorer）以及 **Bevy（Web）**，它会使用 Bevy Web 客户端在浏览器中打开预览。Bevy Web 选项等同于 `--web` CLI 标志。
* **预览期间打开控制台窗口**：会打开一个带有场景控制台输出的新窗口。这有助于调试场景中的错误。
* **跳过认证屏幕**：跳过账号选择界面，并自动使用你当前登录的账号登录。默认情况下此功能已禁用；如果你想测试多个账号，请启用它。
* **启用地形**：切换场景周围的地形。默认已启用；禁用它可减小场景的内存占用。
* **启用 MCP 服务器**：以启用 MCP 自动化服务器的方式启动 Explorer，这样 AI 代理可以看到并控制正在运行的预览。仅在你的项目 SDK 版本支持时可见。请参见 [使用 AI 进行 Vibe Coding](/creator/content-creator-zh/chang-jing-sdk7/ru-men/vibe-coding.md#let-the-ai-see-your-scene-in-world) 以了解完整流程。
* **优化资源**：使用本地生成的资源包预览场景，效果与发布后 [资源包转换](/creator/content-creator-zh/chang-jing-sdk7/you-hua/performance-optimization.md#asset-bundle-conversion)后渲染一致。首次运行会转换所有资源，在大型场景中可能需要几分钟。仅可在桌面客户端中使用（Bevy Web 不支持）。请参见 [使用优化后的资源预览](#preview-with-optimized-assets).
* **在移动设备上显示二维码**：显示一个二维码，可在 [Decentraland 移动应用](/creator/content-creator-zh/wei-yi-dong-duan-gou-jian/yi-dong-ke-hu-duan/overview.md)。使用与你电脑处于同一 Wi‑Fi 网络的手机扫描该二维码。请参见 [在移动端预览](/creator/content-creator-zh/wei-yi-dong-duan-gou-jian/kai-fa/preview-on-mobile.md) 了解详情。

{% hint style="info" %}
**提示：** 你也可以直接在 Decentraland 移动应用中预览你的场景。使用 **在移动设备上显示二维码** Creator Hub 中的该选项，或运行 `npm run start -- --mobile` 从 CLI 运行。请参见 [在移动端预览](/creator/content-creator-zh/wei-yi-dong-duan-gou-jian/kai-fa/preview-on-mobile.md) 了解详情。
{% endhint %}

## 使用 CLI

要预览一个场景，请在场景的主文件夹中运行以下命令：

```bash
npm run start
```

缺失的任何依赖项都会被安装，然后 CLI 会在你的系统中创建一个本地 Web 服务器，并通过一个 `decentraland://` 深度链接在 Decentraland Desktop 客户端中启动该场景。桌面客户端是默认的预览目标。

若要改为在浏览器标签页中预览，请添加 `-- --web` （或 `-- --bevy-web`）以在 Bevy Web 客户端中打开场景，地址为 `decentraland.org/bevy-web/`.

每次你对场景进行更改时，预览都会自动重新加载并更新，因此无需再次运行该命令。

{% hint style="warning" %}
**📔 注意**：某些场景依赖与外部服务器通信来执行自定义逻辑或存储和读取数据。预览这些场景之一时，你很可能还需要在另一个端口上本地运行该服务器。请查看场景的 readme，了解如何同时启动服务器和场景的说明。
{% endhint %}

### 预览命令的参数

你可以向 `npm run start` 命令添加以下标志来更改其行为：

* `-- --web` （别名 `-- --bevy-web`）会在 Bevy Web 浏览器客户端中打开预览，地址为 `decentraland.org/bevy-web/` 而不是 Desktop Explorer。基于 Chromium 的浏览器（Chrome 142+）需要“本地网络访问”权限，托管页面才能访问你的本地预览服务器——当浏览器请求访问你设备上的应用时，点击“允许”。
* `-- --mobile` （别名 `-- -m`）会在终端中显示一个二维码，用于在 [Decentraland 移动应用](/creator/content-creator-zh/wei-yi-dong-duan-gou-jian/yi-dong-ke-hu-duan/overview.md) 的手机上打开你的场景，该手机需连接到同一 Wi‑Fi 网络。请参见 [在移动端预览](/creator/content-creator-zh/wei-yi-dong-duan-gou-jian/kai-fa/preview-on-mobile.md).
* `-- --skip-build` 跳过构建，只在预览模式下提供文件。
* `-- --port` （别名 `-- -p`）以为场景分配一个特定端口运行。否则将使用可用的任意端口。
* `-- --no-browser` （别名 `-- -b`）以阻止预览打开新的浏览器标签页。
* `-- -w` 或 `-- --no-watch` 以不监视文件系统更改，并在场景代码变更时避免热重载。
* `-- --ci` 在远程 Unix 服务器上运行 parcel 预览器。
* `-- --multi-instance` 允许同时运行多个 Explorer 实例。
* `-- --local-ab` 使用优化后的资源包预览。Desktop Explorer 在预览期间会自行将场景资源转换为资源包，这与场景在生产环境中的渲染方式一致。等同于 Creator Hub 中的 **优化资源** 选项。仅可在桌面客户端中使用（Bevy Web 不支持）。请参见 [使用优化后的资源预览](#preview-with-optimized-assets).
* `-- --no-client` 抑制所有自动启动（桌面 Explorer 深度链接、浏览器打开、移动二维码）。如果文件监视器自行连接到桌面 Explorer，它仍会通知该 Explorer。当外部工具负责管理 Explorer 进程时，这很有用。
* `-- --mcp` 在 Explorer 中启用 MCP 服务器（通过深度链接参数转发）。
* `-- --mcp-port` Explorer 中 MCP 服务器的端口（通过深度链接参数转发）。例如： `npm run start -- --mcp --mcp-port 3001`.

{% hint style="warning" %}
**📔 注意**：参数需要用两组破折号添加，例如 `npm run start -- --web3`.
{% endhint %}

## 使用优化后的资源预览

当你发布场景时，Decentraland 服务器会将其所有 3D 模型转换为资源包，这是一种更轻量、加载和渲染都更高效的优化格式。请参见 [资源包转换](/creator/content-creator-zh/chang-jing-sdk7/you-hua/performance-optimization.md#asset-bundle-conversion)。默认情况下，本地预览会跳过这一步，改为加载原始模型。

启用优化资源，以便在你预览场景时在本地执行同样的转换。这有两个好处：

* 预览加载更快、运行更流畅，尤其是在包含大量 3D 模型的场景中。
* 你看到的模型与玩家发布后看到的完全一致，因此可以在发布前发现资源压缩方面的任何问题。

此选项仅影响你的本地预览。无论你是否使用此选项，已发布的场景都会始终在服务器上被转换。

要启用它：

* **在 Creator Hub 中**：勾选 **优化资源** 下拉菜单中 **预览** 按钮。
* **来自 CLI**：运行 `npm run start -- --local-ab`.

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

启用此选项后，Decentraland explorer 会在加载场景前在你的机器上将场景的 3D 模型转换为资源包。对于大多数场景来说，转换几乎是即时的，但如果场景资源非常重，首次预览可能会更久。转换后的模型会被缓存，因此后续预览只需要转换新增或修改过的资源。

{% hint style="info" %}
**💡 提示**：如果某个资源的转换由于任何原因失败，预览会回退为加载原始 3D 模型，就像常规预览一样。
{% endhint %}

## 将场景上传到 decentraland

一旦你对场景满意，就可以将其上传并发布到 Decentraland。为此，你必须拥有 LAND、Decentraland NAME 或 ETH ENS 名称，或者拥有由这些资源所有者授予的权限。请参见 [发布](/creator/content-creator-zh/chang-jing-sdk7/fa-bu/publishing.md) 以了解操作说明。

## 预览场景尺寸

预览中显示的场景尺寸基于场景配置。

在 Scene Editor 的场景菜单第二个选项卡中可编辑此项。

![
](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-54a1901635efda3371172e647c03614733baca17%2Fscene-parcels-3x3.png?alt=media)

使用下拉菜单并点击 **应用布局** 以更改场景的尺寸。你也可以点击每个单独的地块，将其从布局中切换为关闭。

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

你也可以编辑 *scene.json* 文件，在“parcels”字段中列出多个地块。请参见 [通过命令行设置地块](/creator/content-creator-zh/chang-jing-sdk7/xiang-mu-lei-xing/scene-metadata.md#scene-parcels) 了解更多详情。

{% hint style="info" %}
**💡 提示**：在预览运行期间，只要这些地块彼此相邻并排列成相同形状，地块坐标就不需要与你的场景实际使用的坐标一致。之后当你 [部署场景](#upload-a-scene-to-decentraland).
{% endhint %}

## 查看场景控制台

点击 ![
](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a673f6b987216e9e471fdac882879c44fcf94652%2Fconsole-icon.png?alt=media) 右上角的图标。你可以在这里看到任何错误消息，以及你的场景通过 `console.log()`.

打印到控制台的任何文本。你也可以按下 **\`** 键盘上的 **\`** 打开更大的控制台，以便查看更多文本。

## 在本地测试多人场景

如果你启动场景预览并在两个（或更多）不同的 explorer 窗口中打开它，每个打开的窗口都会被视为一个独立玩家，而一个模拟通信服务器会让这些玩家保持同步。

在一个窗口中与场景交互，然后切换到另一个窗口，看看该交互的效果是否也会在那里显示。

使用 Creator Hub，再次点击“预览”按钮，它会打开第二个 Decentraland explorer 窗口。你必须在两个窗口中使用不同的地址连接。即使场景重新加载，两个会话也会保持打开。

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

作为替代方案，你可以在浏览器 URL 中输入以下内容，以打开第二个 Decentraland explorer 窗口：

> `decentraland://realm=http://127.0.0.1:8000&local-scene=true&debug=true&multi-instance=true`

### 高级：使用远程资源包进行快速迭代

{% hint style="info" %}
**💡 提示**：对于大多数场景，使用资源包进行预览的最简单方法是启用 [优化资源](#preview-with-optimized-assets)，它会在本地转换你的模型并始终反映其最新版本。下面的模式是一种替代方案，它会重复使用服务器上已发布的资源包。
{% endhint %}

对于包含大量 3D 模型的重场景，你可以通过重复使用 [资源包](/creator/content-creator-zh/chang-jing-sdk7/you-hua/performance-optimization.md#asset-bundle-conversion) 来加快场景加载和重新加载，而不是加载原始的、未优化的 3D 模型。这在仅进行代码更改的迭代时尤其有用。

要启用此模式，请使用以下参数启动 Decentraland Desktop 客户端：

```bash
npm run start -- --realm http://127.0.0.1:8000/ --position 0,0 --local-scene true --debug --skip-version-check true --lsd-use-remote-ab <ab-source>
```

该 `<ab-source>` 参数会根据场景已发布的位置而有所不同：

* **在 Genesis City 中**: `--lsd-remote-ab-server Genesis`
* **在某个 World 中**: `--lsd-remote-ab-world <world-name>.dcl.eth`

例如，要预览一个已部署到某个 World 的场景的本地副本：

```bash
npm run start -- --realm http://127.0.0.1:8000/ --position 0,0 --local-scene true --debug --skip-version-check true --lsd-use-remote-ab --lsd-remote-ab-world myworld.dcl.eth
```

在这两种情况下， `--realm http://127.0.0.1:8000/` 将客户端指向你的本地预览服务器（先运行 `npm run start` 以启动它），并且 `--local-scene true` 告诉客户端从那里加载场景代码。

{% hint style="warning" %}
**📔 重要**：使用此模式时，建议 **所有** 资源都已发布，并且其资源包已由内容服务器完整处理。如果你添加了任何新资源，由于它们会像正常预览时一样作为原始 gltf 文件加载，因此你将无法享受到优化加载。但如果你本地修改了一个已发布的资源，并保持相同的文件名，那么你看到的将是该资源旧的已发布版本。

在这种情况下，先重新部署场景，等待几分钟让资源包生成（请参见 [资源包转换](/creator/content-creator-zh/chang-jing-sdk7/you-hua/performance-optimization.md#asset-bundle-conversion)），然后再继续使用此模式进行仅代码的迭代。
{% endhint %}


---

# 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-sdk7/ru-men/preview-scene.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.