使用 CLI

使用 Decentraland CLI 运行和部署场景。对于大多数创作者来说，Creator Hub 是推荐工具；CLI 更适合高级和自动化工作流。

💡 提示：如果你正在使用 AI 编码助手（如 Claude Code、Cursor 或 Copilot），请在它编写任何代码之前先安装官方的 Decentraland SDK Skills，这样它就会了解已验证的 SDK7 模式：

npx skills add decentraland/sdk-skills

参见借助 AI 进行氛围编程了解完整的 AI 辅助工作流程。

要为 Decentraland 构建场景，你可以使用以下任一方式：

这两种工具都允许你在“链下”开发环境中编译和预览你的场景。在本地测试场景后，你可以将内容上传到内容服务器，并将其与你的 LAND 或 WORLD 关联起来。

虽然 Creator Hub 中的 Scene Editor 更易于使用，但 CLI 提供了更大的灵活性，并且可以轻松用于自动化流程。

📔 注：Scene Editor 在幕后运行的是同样的命令行操作。

💡 提示：参见安装指南了解如何安装 Creator Hub 的说明。

开始前准备

要通过命令行处理场景，请在对该场景运行 CLI 命令之前先安装以下依赖项：

运行 npx @dcl/sdk-commands init 在一个空文件夹中执行，以使用 Decentraland 的默认文件填充它场景项目。你也可以通过 新建场景 按钮在 Creator Hub 中创建一个新场景，它会生成相同的项目结构。

如果要从不同类型的项目开始，请使用 --project 标志。例如，要创建一个智能穿戴项目：

npx @dcl/sdk-commands init --project smart-wearable

可用的 --project 选项有 scene-template （默认值）、 px-template, smart-wearable、以及 library.

在场景文件夹中运行以下命令：

npm i @dcl/sdk@latest

你可以通过检查场景的 package.json 文件，并查找其中的 @dcl/sdk 版本来确认它是否生效。

运行 npm run start 在场景、工作区或智能穿戴项目的根目录下运行它，以在 Decentraland Desktop 客户端中打开预览。

npm run start

如果要在 Decentraland 移动应用上预览你的场景，请改为运行 npm run start -- --mobile （别名 -- -m）。CLI 会输出一个二维码，可在与你电脑连接到同一 Wi-Fi 网络的手机上打开该场景。参见在移动端预览了解完整指南。

npm run start -- --mobile

要让预览运行更流畅，并渲染出发布后实际会看到的 3D 模型效果，请添加 --local-ab 标志。参见使用优化后的资源预览.

npm run start -- --local-ab

参见预览场景了解运行预览时的详细信息和特殊选项。

运行 npm run build 来构建你的项目。Decentraland 场景是用 TypeScript 编写的，但在发布时会构建为压缩后的 JavaScript。参见编写场景了解更多详情。

构建命令是可选的，因为它也会在部署前于后台运行（不过你可以添加标志来跳过它）。

构建命令会执行比 npm run start更严格的类型检查，因此运行它有时有助于调试场景。

运行 npm run deploy 将你的场景发布到 Decentraland。此命令会打开一个浏览器窗口，你可以使用钱包签名以授权部署。

参见发布了解发布场景时的详细信息和特殊选项。

如果你遇到问题，请参见故障排除部分。

最后更新于 3天前