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

与代码结合

将 Scene Editor 中创建的内容与代码编写的能力结合起来。

Creator Hub 加上自定义代码,是创建内容的一个非常强大的组合。你可以使用画布直观地可视化摆放物品,然后编写代码,以完全自由地与这些物品交互。你甚至可以放置一个带有自身默认行为的智能物品,并编写代码,在该物品被激活时作出响应。

例如,你可以利用一个现有的杠杆智能物品,它已经自带声音、动画和状态,并编写代码来检测杠杆何时被拉动,从而运行你自己的自定义逻辑。

参见 在代码中引用物品 了解如何在代码中按名称或按标签获取物品。

编辑代码

你必须在你的机器上安装一个代码编辑器,才能编辑场景代码。推荐的选项有:

  • VS Code Visual Studio Code:这是有经验的开发者推荐的选项。

  • Cursor Cursor AI:这是一款与 AI 集成的强大代码编辑器。它允许你选择不同的 AI 模型来帮助你编写代码;提供免费层,更高级的模型需要付费方案。对于刚接触 Decentraland 或 TypeScript 的开发者来说,这是一个不错的选择,或者当你想节省编写代码的时间时也很适合。

安装完成后,你可能需要在 Creator Hub 的设置中选择你的代码编辑器。为此,

  1. 点击屏幕左上角的创作者中心徽标并选择 设置.

  2. 打开 编辑器 选项卡。

  3. 在 首选代码编辑器下,选择你的代码编辑器。你可能会在下拉菜单中找到你的编辑器,或者你可能需要选择 从你的设备中选择... 来找到它。

EDIOR 选项卡上的“应用偏好设置”对话框,显示“首选代码编辑器”下拉框已设置为 Visual Studio Code。

打开场景的代码

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

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

将你的自定义代码添加到 index.ts 文件,位于 /src,位于 main() 函数内。否则,你也可以在该函数外添加自定义代码,或者创建新的 .ts 文件,放在 /src 文件夹中,但这些必须以某种方式在 main() 的函数中被引用。 index.ts.

如果你打开了一个正在运行场景的预览窗口,那么每当你更改文件中的代码并保存时,场景都会自动重新加载并应用你的更改。

使用 AI

Creator Hub 内置了一个 AI 助手 它可以查看你打开的场景并为你进行编辑,无需离开应用。这是一项实验性功能,默认关闭。

你还可以借助 Cursor 或 Claude Code 等 AI 助手来帮助你编写场景代码。例如,要使用 Cursor,请执行以下操作:

  1. 点击 AI 按钮,位于屏幕右上角

  2. 在那里,你可以向 AI 助手提出提示,帮助你编写代码。你的提示可以包含文档页面链接、项目中特定文件的路径,甚至图片。你还可以从下拉菜单中选择要使用的特定模型。

要让你的 AI 助手获得 Decentraland 上下文,请安装官方的 Decentraland SDK Skills。这些是由 Decentraland 基金会维护的现成指令集,可向你的 AI 代理教授经过验证的 SDK7 模式,涵盖每个主题:搭建整个场景、添加 3D 模型、多人模式、部署等更多内容。

参见 用 AI 进行氛围编程 获取完整指南,包括可用技能的完整列表。

版本控制

我们建议你在 GitHub 上为你的项目创建一个仓库,并用它来跟踪项目版本以及与他人协作。

如果你不熟悉如何操作,请参阅 仓库快速入门,或者使用 GitHub 桌面应用 以获得更简单的基于界面的流程。

另请参见

最后更新于