与代码结合
将 Scene Editor 中创建的内容与代码编写的能力结合起来。
Creator Hub 加上自定义代码,是创建内容的一个非常强大的组合。你可以使用画布直观地可视化摆放物品,然后编写代码,以完全自由地与这些物品交互。你甚至可以放置一个带有自身默认行为的智能物品,并编写代码,在该物品被激活时作出响应。
例如,你可以利用一个现有的杠杆智能物品,它已经自带声音、动画和状态,并编写代码来检测杠杆何时被拉动,从而运行你自己的自定义逻辑。
参见 在代码中引用物品 了解如何在代码中按名称或按标签获取物品。
编辑代码
你必须在你的机器上安装一个代码编辑器,才能编辑场景代码。推荐的选项有:
Visual Studio Code:这是有经验的开发者推荐的选项。
Cursor AI:这是一款与 AI 集成的强大代码编辑器。它允许你选择不同的 AI 模型来帮助你编写代码;提供免费层,更高级的模型需要付费方案。对于刚接触 Decentraland 或 TypeScript 的开发者来说,这是一个不错的选择,或者当你想节省编写代码的时间时也很适合。
📔 注:如果你使用的是 macOS,请确保代码编辑器应用位于 Applications 目录中。
安装完成后,你可能需要在 Creator Hub 的设置中选择你的代码编辑器。为此,
点击屏幕左上角的创作者中心徽标并选择 设置.
打开 编辑器 选项卡。
在 首选代码编辑器下,选择你的代码编辑器。你可能会在下拉菜单中找到你的编辑器,或者你可能需要选择 从你的设备中选择... 来找到它。

打开场景的代码
在你的机器上安装代码编辑器并在 Creator Hub 设置中选择它之后,你可以点击 < > 代码 按钮,在你的场景项目中将其打开。

这会打开一个带有代码编辑器的独立窗口。在左侧边栏中,你可以浏览项目的文件和文件夹结构。

将你的自定义代码添加到 index.ts 文件,位于 /src,位于 main() 函数内。否则,你也可以在该函数外添加自定义代码,或者创建新的 .ts 文件,放在 /src 文件夹中,但这些必须以某种方式在 main() 的函数中被引用。 index.ts.
📔 注:如果你已安装 VS Code 或 Cursor,但 代码 按钮无法打开它,可能是因为 VS Code 在你的机器上没有正确配置为通过命令行打开。在大多数情况下,这会在默认安装时自动处理,但如果没有,请参阅 这些来自 VS 的说明 以通过命令行启用 VS Code。
如果你打开了一个正在运行场景的预览窗口,那么每当你更改文件中的代码并保存时,场景都会自动重新加载并应用你的更改。
使用 AI
Creator Hub 内置了一个 AI 助手 它可以查看你打开的场景并为你进行编辑,无需离开应用。这是一项实验性功能,默认关闭。
你还可以借助 Cursor 或 Claude Code 等 AI 助手来帮助你编写场景代码。例如,要使用 Cursor,请执行以下操作:
点击 AI 按钮,位于屏幕右上角
在那里,你可以向 AI 助手提出提示,帮助你编写代码。你的提示可以包含文档页面链接、项目中特定文件的路径,甚至图片。你还可以从下拉菜单中选择要使用的特定模型。
要让你的 AI 助手获得 Decentraland 上下文,请安装官方的 Decentraland SDK Skills。这些是由 Decentraland 基金会维护的现成指令集,可向你的 AI 代理教授经过验证的 SDK7 模式,涵盖每个主题:搭建整个场景、添加 3D 模型、多人模式、部署等更多内容。
参见 用 AI 进行氛围编程 获取完整指南,包括可用技能的完整列表。
📔 注:较旧的场景项目可能包含一个 /dclcontext 文件夹,由已弃用的 npx sdk-commands get-context-files 命令下载。该上下文不再维护,已被 SDK Skills 取代。你可以安全地删除该文件夹。
版本控制
我们建议你在 GitHub 上为你的项目创建一个仓库,并用它来跟踪项目版本以及与他人协作。
如果你不熟悉如何操作,请参阅 仓库快速入门,或者使用 GitHub 桌面应用 以获得更简单的基于界面的流程。
📔 注:将整个项目文件夹上传到 GitHub 仓库,但请确保 /node_modules 或 /bin 文件夹以及 package-lock.json 文件都被包含在 .gitignore 文件中,以避免同步它们。如果你将仓库配置为以下类型,这通常就会如此: node。这些文件都是自动生成的,并且不同机器上的内容可能会有所不同。
另请参见
用 AI 进行氛围编程:通过向 AI 助手描述你想要什么来构建场景。
SDK 快速入门:跟随这个简短教程,快速入门。
开发工作流程:阅读此文,全面了解场景创建流程。
示例:直接查看可运行的示例场景。
最后更新于